تكامل مدفوعات الكريبتو مع الخلفية، خطوة بخطوة
تكامل مدفوعات الكريبتو مع الخلفية خطوة بخطوة: أنشئ الدفعات من خادمك، ووجّه العميل، وتحقق من webhook، وطابق الطلبات. مع أمثلة كود واضحة للمطورين.
يحتاج تكامل مدفوعات الكريبتو مع الخلفية إلى ثلاثة عناصر: استدعاء من الخادم ينشئ الدفعة، وتوجيه للعميل، وwebhook يغلق الطلب. يشرح هذا الدليل كل خطوة مع واجهة API v1 من Qvard.
الخطوة 1: احفظ الطلب أولًا
احفظ الطلب في قاعدة بياناتك بحالة مثل pending قبل استدعاء API. استخدم معرّف طلبك في الحقل id، فتترابط الدفعة والطلب من البداية.
الخطوة 2: أنشئ الدفعة
من خلفيتك أرسل POST إلى /api/v1/payment مع ترويسة x-api-key ومعرّف الطلب في id والإجمالي في price. احفظ مفتاح API في إعدادات الخادم، ولا تضعه أبدًا في كود الواجهة الأمامية.
الخطوة 3: وجّه العميل
احفظ redirectUrl المرتجع مع الطلب ووجّه العميل إليه. في الصفحة المستضافة يختار العميل الأصل والشبكة ويدفع المبلغ الدقيق.
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
}الخطوة 4: أغلق الطلب من الـwebhook
تتحقق نقطة نهاية الـwebhook من x-api-key، وتجد الطلب بالـid، وتضعه مدفوعًا عندما تكون الحالة paid. هذا هو المكان الوحيد الذي يُؤكَّد فيه الدفع.
الخطوة 5: طابق وراقب
أجرِ فحصًا يوميًا للطلبات التي بقيت معلقة لفترة طويلة وقارنها بسجلات الدفع لديك. سجّل كل استجابة API وكل webhook لأغراض الدعم.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }نصائح معمارية
احتفظ بكود الدفع في خدمة صغيرة مستقلة عن صفحات الدفع. عندها يمكنك تغيير معالج الـwebhook أو إضافة قناة ثانية دون المساس ببقية المتجر.
FAQ
ما لغات الخلفية التي يمكنني استخدامها؟
أي لغة تستطيع إرسال طلب HTTPS POST بمتن JSON واستقبال webhook. الواجهة HTTP عادي، لذلك لا يلزم SDK.
أين أضع عنوان الـwebhook؟
استخدم نقطة نهاية HTTPS عامة في خلفيتك. يجب أن تقبل POST وتتحقق من ترويسة x-api-key قبل تحديث أي طلب.
هل أحتاج إلى تكامل منفصل لكل عملة رقمية؟
لا. يختار العميل الأصل والشبكة في صفحة الدفع المستضافة، فتنشئ خلفيتك دفعة واحدة بالدولار وتقرأ حالة واحدة.
هل يمكنني اختبار التكامل كله أولًا؟
نعم. استخدم تدفق الفاتورة التجريبية لدفع فاتورة اختبار، وتأكد من تشغيل معالج الـwebhook قبل قبول مدفوعات حقيقية.
