Skip to main content
إنشاء أو تحديث جلسة دفع لطلب Pending. سيصل إجراء الدفع إلى قناة الدفع وقد يغيّر حالة الطلب، ويجب تأكيد معرّف الطلب والمبلغ وطريقة الدفع قبل الاستدعاء.

​
نظرة عامة على الواجهة

​
حدود الدفع المجهول

يُستخدم الوصول المجهول للسيناريوهات التي تُفقد فيها حالة تسجيل الدخول بعد فتح رابط دفع منسوخ، ولا يحتاج ولا ينبغي أن يحمل Account Token طويل الأجل. الاستدعاءات المجهولة:
  • لا تسمح إلا بطرق الدفع ذات إعادة التوجيه المُستضافة التي يضبطها الخادم؛
  • تستخدم دائماً صفحة دفع سطح المكتب؛
  • لا يمكنها استلام الطلبات ذات السعر الصفري؛
  • تخضع لتقييد المعدل حسب IP والطلب الواحد؛
  • تُرجع إسقاطاً أدنى للطلب، ولا تتضمن الحساب أو Application أو metadata الداخلية.
يجب أن يكون المستدعي المُصادَق عليه مالك الطلب أو مسؤولاً فائقاً. لا يمكن استدعاء الطرق التي تتطلب سياق المستخدم، مثل X402 واستبدال المكافآت، بشكل مجهول.

​
مثال الطلب

طرق الدفع التي تتطلب المصادقة:
يستخدم pay_way القيم الفعلية التي يدعمها نموذج الطلب، مثل WechatPay وAliPay وStripe وCard وAirwallex وX402 وPayPal وAppleIAP وReward وBankTransfer. ليست كل قيمة متاحة للطلبات المجهولة أو لكل موقع.

​
وصف الاستجابة

الاستجابة الناجحة هي كائن الطلب المُحدّث، وعادةً ما توفّر نقطة الدخول للخطوة التالية عبر pay_url؛ وقد تُرجع طرق الدفع المختلفة أيضاً معلومات مطلوبة لمتابعة العميل للدفع ضمن حقول خاضعة للتحكم. تستخدم الاستجابة المجهولة قائمة سماح دنيا من الحقول، بينما يحصل المالك المُصادَق عليه على التفاصيل الكاملة. لا تعتمد على أسماء الحقول القديمة مثل payment_url أو qr_code_url أو payment_method؛ إذ يستخدم عقد Order الحالي pay_url وpay_way.

​
الشراء داخل تطبيق iOS

يمكن لمالك الطلب الذي سجّل الدخول تمرير pay_way: "AppleIAP". يحدّث هذا الطلب الطلب المعلّق للدفع وفقاً لـ metadata.apple_price للباقة المحددة ويلغي الخصم، ولا ينتج عنه خصم مالي، ولا يمنح نقاطاً، ولا يُرجع رابط دفع. يجب أن تُكمل الطلبات القديمة المعلّقة للدفع هذه الخطوة أولاً، ثم تبدأ الدفع الأصلي من Apple. لا تُدعم سوى باقة Usage واحدة تحتوي على منتج Apple وسعر مُهيأين؛ وتُرجع الباقات غير المدعومة أو الطلبات المجمّعة 400. بعد الدفع الأصلي من Apple، أرسل transaction_id عبر /api/v1/orders/{id}/apple-verify/ لإكمال التحقق من جانب الخادم ومنح النقاط. يأتي عدد النقاط من الباقة؛ ويستخدم المبلغ سعراً مستقلاً مُعداً مسبقاً بالدولار الأمريكي من Apple، ولا تُضاف إليه خصومات العضوية أو الزيادات السعرية للموقع، ويكون مبلغ الخصم بالعملة المحلية في المناطق الأخرى وفقاً لصفحة تأكيد Apple.

​
الأخطاء وإعادة المحاولة

  • الطلب ليس Pending: يُرجع 400؛ لا تُنشئ جلسة دفع بشكل متكرر.
  • لم يتم توفير pay_way: تُرجع الطلبات غير الصفرية 400.
  • استخدم الاستدعاء المجهول طريقة غير مسموح بها أو طلباً بسعر صفري: يُرجع 403، أعد المحاولة بعد تسجيل الدخول بواسطة المالك.
  • تمت المصادقة ولكن المستدعي ليس مالك الطلب: يُرجع 403.
  • فشلت قناة الدفع: لا تُكرر الإرسال بشكل أعمى؛ استعلم أولاً عن تفاصيل الطلب، وأعد المحاولة بعد التأكد من أنه لا يزال Pending.

​
الواجهات ذات الصلة