مدفوعات العملات الرقمية لشركات SaaS
دع العملاء يدفعون كل فترة فوترة بعملة USDT وغيرها من العملات الرقمية. تنشئ دفعة لكل فاتورة عبر الـ API، وترسل الرابط، وتمدّد الوصول عندما يُعلمك الـ webhook باكتمال الدفع.
- فاتورة واحدة لكل فترة فوترة
- دفعة لكل فاتورة عبر الـ API
- تمديد الوصول عبر webhook
متى تناسب العملات الرقمية نشاط SaaS
العملات الرقمية طريقة دفع ثانية، بجانب البطاقات، للعملاء الذين تخذلهم مسارات البطاقات:
- فرق في بلدان لا يخدمها معالج البطاقات لديك، أو تُرفض بطاقاتها للبرمجيات الأجنبية؛
- شركات تفضّل دفع فاتورة سنوية كبيرة بتحويل بدل البطاقة؛
- مشترو أدوات المطورين والبنية التحتية والاستضافة الذين يملكون عملات مستقرة بالدولار أصلًا.
لا يستطيع المرسل عكس دفعة العملات الرقمية، لذا لا توجد مطالبات استرداد على بطاقات في هذه الفواتير. إنها تضيف طريقة دفع؛ ولا تحل محل الفوترة بالبطاقات لبقية العملاء.
النموذج: فاتورة واحدة لكل فترة فوترة
تخصم الفوترة بالبطاقة تلقائيًا من بطاقة محفوظة. أما الدفع بالعملات الرقمية فيجب أن يبدأه العميل، لذا فالنموذج الذي ينجح هو فاتورة مدفوعة مسبقًا لكل فترة:
- قبل انتهاء الفترة بوقت قصير ينشئ نظامك فاتورة ودفعة في Qvard لها.
- يتلقى العميل رابطًا إلى صفحة الدفع المستضافة، ويختار أصلًا وشبكة ثم يدفع.
- عند اكتمال الدفع يستدعي Qvard الـ webhook الخاص بك فتمدّد الاشتراك.
لا توجد طريقة دفع محفوظة ولا خصم تلقائي. لا يقدّم Qvard الفوترة المتكررة كمنتج، لذا فتذكيرات التجديد وفترة السماح وتغييرات الخطط منطق خاص بك.
كيف يعمل
أنشئ الدفعة من الخادم الخلفي بطلب POST واحد إلى https://api.qvard.com/api/v1/payment: مفتاحك في الترويسة x-api-key، ورقم فاتورتك كـ id، والمبلغ كـ price، بالدولار الأمريكي ما لم تُرسل currency، مثل INR. تحتوي الاستجابة على redirectUrl، وهو عنوان صفحة الدفع المستضافة؛ ضعه في بريد الفاتورة.
عند اكتمال الدفع يرسل Qvard webhook يحمل الـ id الخاص بك والحالة completed. افحص الترويسة x-api-key، وضع علامة «مدفوعة» على الفاتورة فقط إن لم تكن مدفوعة، وردّ بـ HTTP 200 بالضبط، ومدّد الاشتراك. سعر الصرف في صفحة الدفع ثابت لمدة ساعة.
// A few days before a period ends: create the invoice and its payment.
async function createRenewalInvoice(sub) {
const invoice = await db.invoices.create({ subscriptionId: sub.id, amountInr: sub.planPriceInr, status: 'open' });
const res = await fetch('https://api.qvard.com/api/v1/payment', {
method: 'POST',
headers: { 'x-api-key': process.env.QVARD_API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({ id: String(invoice.id), price: invoice.amountInr, currency: 'INR' })
});
const { redirectUrl } = await res.json();
await mailer.send(sub.email, 'Your renewal invoice', 'Pay here: ' + redirectUrl);
}
// In the webhook handler, when status is "completed" (and the x-api-key header matches).
async function onPaid(invoiceId) {
const invoice = await db.invoices.markPaidIfOpen(invoiceId); // null if already paid
if (invoice) await db.subscriptions.extend(invoice.subscriptionId, '1 month');
}ما الذي يبقى من جانبك
حدّد بوضوح ما تبنيه أنت وما تفعله البوابة نيابةً عنك.
- أنت: الفواتير والتذكيرات وفترة السماح والترقية والتخفيض والمبالغ المستردة والمحاسبة.
- البوابة: صفحة الدفع والعناوين ومراقبة الشبكة وحالات الدفع والـ webhook.
إن دفع العميل جزءًا فقط من الفاتورة فتأخذ الدفعة الحالة partial ولا يُرسل webhook الاكتمال؛ أبقِ الفاتورة مفتوحة واطلب الباقي. لا توجد بعد روابط عودة بعد الدفع، لذا أعطِ العملاء صفحة فوترة تعرض حالة الفاتورة الفعلية.
المال والرسوم
لا توجد رسوم اشتراك للبوابة. العمولة فردية لمشروعك، وبحسب صفحة الأسعار تبدأ من 1% ويمكن أن تنخفض إلى 0.1%. تبقى الأموال في رصيدك في Qvard وتسحبها إلى محفظتك الخاصة؛ والسحب لا يكلّف إلا رسوم الشبكة. السحب إلى حساب مصرفي بالعملة الورقية غير متاح. تبقى الأسعار بالدولار؛ ويدفع العملاء ما يعادله بـالأصل والشبكة اللذين يختارونهما.
ما هو جاهز اليوم
يتم التكامل عبر الـ API ويتطلب مطوّرًا؛ لا توجد بعد إضافة فوترة جاهزة، وروابط الدفع و sandbox منفصل قيد التطوير. اقرأ الدليل الكامل في مدفوعات العملات الرقمية لشركات SaaS، وجانب الفواتير في فوترة العملات الرقمية لـ SaaS B2B، وقواعد الـ webhook في كيف تؤمّن webhook مدفوعات العملات الرقمية. صيغ الطلبات في وثائق المطورين، وفاتورة تجريبية تُظهر ما يراه عميلك.
الأسئلة الشائعة
A quick overview of how Qvard handles payments, integration and merchant operations.
ما هو Qvard؟
Qvard هو بوابة دفع بالعملات الرقمية للشركات، توفر صفحة دفع مستضافة وفواتير ومدفوعات عبر API وأرصدة للتجار.
ما الأصول المدعومة؟
يدعم Qvard USDT وUSDC وBTC وLTC وTRX وBNB وETH. TON وUSDT على TON قريبًا.
هل هو مناسب للمطورين؟
نعم. يشمل Qvard مدفوعات API وredirectUrl وwebhooks وإعادة المحاولات وسجلات التسليم.
هل يمكنني تخصيص صفحة الدفع؟
تدعم صفحة الدفع شعار التاجر واسم المتجر ولون الزر والترجمة. روابط العودة المخصصة قريبًا.
ماذا أحتاج للبدء؟
أنشئ حساب تاجر وأكمل توثيق النشاط التجاري. بعد تجربة فاتورة تجريبية، اربط صفحة الدفع المستضافة أو API وابدأ باستقبال المدفوعات الحقيقية.
كيف تعمل السحوبات؟
تُتبع الأموال في أرصدة التاجر، منفصلة حسب الأصل والشبكة. يمكنك السحب يدويًا أو إعداد قواعد سحب للدفعات التلقائية.