الانتقال إلى المحتوى الرئيسي
إنشاء أو تحديث جلسة دفع لطلب 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.

التحويل البنكي

يمكن لكل من الحسابات الشخصية وحسابات الشركات المسجّلة الدخول استخدام BankTransfer، دون الحاجة إلى مصادقة الشركة. يتطلب كل من التحويلات المحلية بالرنمينبي والتحويلات الدولية بالدولار الأمريكي أن يكون مبلغ الطلب 300 دولار أمريكي على الأقل؛ ويُعتد بمبلغ الرنمينبي المستحق المعروض وقت الدفع. قبل الدفع، يمكن الاستعلام عن مسارات التحويل المتاحة حالياً للطلب وحدود المبالغ عبر GET /api/v1/orders/{order_id}/payment-options/. يجب بدء التحويل البنكي بعد تسجيل الدخول بواسطة مالك الطلب، ويخضع لتهيئة قناة التحصيل ونطاق انطباق الباقة؛ ولا يمكن للطلبات المجهولة استخدامه.

الشراء داخل تطبيق 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.

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