ما هي بوابة الدفع host-to-host؟
ما هي بوابة الدفع host-to-host: مدفوعات من الخادم إلى الخادم مع توجيه لصفحة الدفع المستضافة وwebhook نهائي، شرح موجه للتجار وكيف يعمل مع Qvard.
تربط بوابة الدفع host-to-host خادمك مباشرة بمزود الدفع. تنشئ خلفيتك المدفوعات، ويدفع العميل في صفحة مستضافة، ويعيد المزود النتيجة إلى خادمك.
معنى host-to-host
في نموذج host-to-host يُرسل طلب الدفع من خادمك إلى البوابة، لا من المتصفح. يلتقي العميل بالبوابة فقط في صفحة الدفع المستضافة، وتبقى المفاتيح ومنطق الطلب لديك.
كيف يعمل التدفق
يُنشئ خادمك دفعة عبر POST /api/v1/payment، ويستلم redirectUrl، ويرسل العميل إليه، ويستلم الحالة النهائية عبر webhook. ثلاث خطوات تغطي التدفق كله.
لمن هذا النموذج
المتاجر الإلكترونية ومنتجات SaaS والأسواق التي لديها خلفية بالفعل وتريد تحكمًا كاملًا في منطق الدفع وحالات الطلبات والمطابقة.
الصفحة المستضافة وسعر الصرف الثابت
يدفع العميل في صفحة الدفع المستضافة لـQvard، التي تعرض المبلغ الدقيق للأصل والشبكة المختارين بسعر صرف ثابت طوال مدة صلاحية الفاتورة. لا تحتاج إلى بناء توليد العناوين أو منطق الأسعار.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 12499.00,
"currency": "INR",
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}أساسيات الأمان
احتفظ بـx-api-key على الخادم، وتحقق من ترويسة x-api-key في كل webhook، واقبل نقاط نهاية HTTPS فقط. تعامل مع التحويل كتنقل لا كتأكيد للدفع.
متى يناسب منتج آخر أكثر
بدون خلفية يكون رابط الدفع أبسط. الدفع المدمج والـSDK والمحطة والدفع عبر Telegram ضمن خارطة الطريق؛ واليوم تحصل على النتيجة نفسها عبر API والصفحة المستضافة.
FAQ
هل host-to-host هو نفسه API؟
هو نموذج قائم على API يتحدث فيه الخادم إلى البوابة مباشرة. المصطلح يصف من يُجري الاستدعاء، أي الخادم، وليس بروتوكولًا منفصلًا.
هل أحتاج إلى خادم مخصص؟
لا. يكفي أي خلفية تستطيع إرسال طلبات HTTPS وتوفير عنوان webhook.
ما تكلفة البوابة؟
المعدل الأساسي 1% لكل دفعة، والمعدلات الفردية تنخفض إلى 0.1% مع الحجم، ورسوم الشبكة تُدفع منفصلة.
هل يمكن الجمع بين host-to-host والصفحة المستضافة؟
نعم، فهذا هو التدفق المعتاد: تنشئ الواجهة الدفعة وتحصّلها الصفحة المستضافة.
