شرح الدفع المستضاف: جلسات الدفع من البداية إلى النهاية

يُبقي الدفع المستضاف بيانات البطاقات بعيدًا عن خوادمك. ينشئ نظامك الخلفي جلسة دفع، ويدفع العميل في صفحة الدفع الخاصة بـ ManaraCore، ثم تُبلَّغ بالنتيجة. إليك كل خطوة.

1. أنشئ الجلسة

من خادمك، استدعِ POST /api/payments/sessions مع رمز التاجر كـ bearer token. أرسل المبلغ والعملة ومرجع طلبك وبيانات تواصل العميل، وإلى أين يُرسل العميل والنتيجة:

{
  "amount": 49.99,
  "currency": "USD",
  "merchantReferenceId": "ORDER-1042",
  "customerEmail": "customer@example.com",
  "returnUrl": "https://shop.example.com/payment/success",
  "cancelUrl": "https://shop.example.com/payment/cancel",
  "webhookUrl": "https://shop.example.com/webhooks/payments"
}

تحتوي الاستجابة على paymentSessionId و hostedPaymentUrl و iframeUrl ووسائل الدفع المتاحة لهذه العملية.

2. وجّه العميل للدفع

إما أن تحوّله إلى hostedPaymentUrl أو تضمّن iframeUrl في صفحة الدفع لديك. يختار العميل وسيلة ويدفع لدى المزوّد.

3. أكّد النتيجة

عندما يبلّغ المزوّد عن الدفع، تحدّث ManaraCore الجلسة وتستدعي webhookUrl الخاص بك. علّم الطلب كمدفوع من الـ Webhook وليس من رابط العودة: فالعملاء يغلقون التبويبات، وزيارة العودة ليست دليلًا على الدفع.

تتيح لك ساحة تجربة الدفع تشغيل جلسة كاملة من البداية إلى النهاية قبل كتابة أي شيفرة تكامل.