لا يعني نجاح طلب الدفع على مستوى HTTP دائماً اكتمال العملية المالية. يجب أن يقيّم تطبيقك الرد التقني وحالة الدفع ونتيجة الطلب بشكل منفصل. تقدم هذه الصفحة قائمة تحقق نموذجية للتصميم، ولا توفر نقاط نهاية غير متحقق منها أو مفاتيح وصول صالحة للاستخدام.
وضح نموذج الطلب
يجب الرجوع إلى مواصفات API المحدثة لمعرفة وحدة المبلغ ودقة العملة وتفرّد المرجع التجاري للعملية. لا تُرسل طلبات فعلية بناءً على افتراض تنسيق للمبلغ أو اسم للحقل.
- أكد طريقة المصادقة ومسار تجديد المفاتيح.
- تحقق من نطاق منع تكرار التنفيذ لدى العميل والمزود.
- حدد قواعد انتهاء المهلة وإعادة المحاولة بشكل منفصل.
عالج الإشعارات بأمان
يجب تطبيق توقيع Webhook أو طريقة التحقق وفق المواصفات المحدثة. اختبر تكرار الحدث نفسه وتغير ترتيب الأحداث. وينبغي أن يكون استلام الإشعار ومعالجة السجل التجاري قابلين للتتبع بشكل منفصل.
النتيجة والتأكيد المالي
في العمليات غير المحسومة، يُستخدم استعلام الحالة للتحقق من النتيجة النهائية. وترتبط ردود الإلغاء والاسترداد بالمرجع التجاري نفسه. يجب مشاركة بيانات الاتصال الفعلية عبر قناة آمنة بعد توضيح النطاق التقني.