الأعمال التحضيرية
- استخدم رمز الحساب.
- احصل على معرّف طلبك من قائمة الطلبات.
نظرة عامة على الواجهة
state لتحديد النتيجة، واستخدم finished_at كوقت الإكمال؛ لا يحتوي النموذج الحالي على حقل paid_at. تتضمن قيم الحالة Pending وPaid وFinished وExpired وFailed وRefunded.
سيؤدي الموعد النهائي للدفع فقط إلى تغيير الطلبات التي لا تزال في حالة Pending إلى Expired. تظل طلبات Refunded التي تم رد أموالها بالفعل في حالة رد الأموال حتى بعد التحديث أو تلقي رد اتصال دفع متأخر.
توصيات إعادة المحاولة
- اعتمد على رد اتصال المنصة للدفع العادي بشكل أساسي؛ ولا تقم بالتحديث الاستباقي إلا عندما لا تتحدث الحالة لفترة طويلة.
- لا تستخدم استعلامًا ثابتًا عالي التردد. يُنصح بالتراجع الأسي، والتوقف بعد الوصول إلى حالة نهائية واضحة.
- يشير
401إلى أن الرمز غير صالح؛ ويشير403إلى أنك لست مالك الطلب؛ ويشير404إلى أن الطلب غير موجود. - عند فشل استعلام خدمة الدفع، احتفظ بمعرّف الطلب ومعرّف التتبع، وأعد المحاولة لاحقًا؛ لا تنشئ طلبات مكررة بدلًا من تأكيد الحالة.