المعاملات وإعادة المحاولة
السحب هو عملية تجارية غير متزامنة. الاستجابة الناجحة HTTP تعني أنه تم التعامل مع الطلب؛ ولا يثبت أن الأموال وصلت عبر السلسلة.
استمر في معرف عمل واحد
قم بإنشاء وتخزين client_request_id قبل إرسال السحب. أعد استخدامه لإعادة محاولة نفس العملية المقصودة، بما في ذلك بعد إعادة تشغيل العملية. حافظ على اتساق حقول المعاملة؛ يرفض التنفيذ الحالي معرفًا متكررًا بمعلمات عمل متعارضة.
لا تعتمد فقط على رأس Idempotency-Key. يمكن أن يضيف SDK هذا الرأس، لكن عقد إلغاء البيانات المكررة للسحب الحالي يعتمد على حقل النص الأساسي client_request_id.
فهم بيانات الطلب
يسلط هذا الجدول الضوء على الحقول الأساسية، وليس مخطط الطلب الكامل. قم بتأكيد المعاينة وتأكيد الرسوم والمتطلبات الخاصة بالحفظ المفاتيح مقابل إصدار التكامل. تجنب المبالغ الثنائية الفاصلة العائمة ولا تنسخ سلسلة الأمثلة أو أرقام الأصول بين البيئات.
اتبع النتيجة
القائمة توضيحية وقد تتطور. الحفاظ على الحالات غير المعروفة للتحقيق فيها بدلاً من تعيينها للنجاح أو الفشل. التسمية الفاشلة أو المرفوضة وحدها لا تكفي دليلاً على عدم التوقيع أو البث.
استرداد بعد مهلة
استعلم GET /api/v1/withdrawals/by-request باستخدام معلمة الاستعلام client_request_id الأصلية. استمر في الاقتراع أو التوفيق بين العملية الأصلية عندما تكون نتيجتها غير مؤكدة. إذا كان تجديد التفويض مطلوبًا، استخدم نفس المعرف وإجراءات التجديد المتفق عليها.
يعتمد الإلغاء على مرحلة التوقيع الفعلية وفحوصات الخادم. ابدأ عملية تجارية بديلة فقط بعد التأكد من عدم نقل الأصل وعدم إمكانية نقله. تلقي الأحداث من خلال webhooks، والاحتفاظ بالاستعلامات API كمسار للتسوية.