Navio
التحقق من حالة الدفع
تحقق من الحالة الحالية لدفع باستخدام كود مرجعه
GET
نظرة عامة
تحقق من حالة الدفع في الوقت الفعلي باستخدام مرجع الدفع. ضروري لمعالجة الطلبات والاستعلام عن الحالة والتحقق من المدفوعات.الكشف التلقائي عن البيئة: يتحقق هذا الـ endpoint تلقائياً من معاملات الإنتاج (SATIM) والـ sandbox بناءً على مكان إنشاء الدفع.
معاملات المسار
كود مرجع الدفع (التنسيق:
OCPL-XXXXXX-YYYY)هذا هو
paymentRef الذي يُعاد عند إنشاء رابط الدفعالاستجابة
يشير إلى نجاح العملية
معلومات حالة الدفع
بيانات وصفية للاستجابة
شرح قيم الحالة
PENDING
PENDING
عند رؤية هذه الحالة:
- لم يبدأ العميل عملية الدفع بعد
- الدفع قيد المعالجة من قِبل البنك
- الرابط تم إنشاؤه للتو ولم يُستخدم بعد
- استمر في الاستعلام عن تحديثات الحالة
- اعرض “الدفع معلق” للعميل
- لا تُنفِّذ الطلب بعد
CONFIRMED
CONFIRMED
عند رؤية هذه الحالة: - اكتمل الدفع بنجاح - ستُضاف الأموال إلى رصيد OneClick الخاص بكما يجب فعله:
- ضع علامة على الطلب كمدفوع في نظامك
- نفِّذ الطلب/قدِّم الخدمة
- أرسل تأكيداً للعميل
FAILED
FAILED
عند رؤية هذه الحالة:
- تم رفض الدفع أو فشل
- انتهت صلاحية رابط الدفع (20 دقيقة)
- ألغى العميل الدفع
- ضع علامة على الطلب كفاشل/ملغى
- أنشئ رابط دفع جديداً إذا أراد العميل إعادة المحاولة
- لا تُنفِّذ الطلب
انتهاء صلاحية الرابط
مثال التكامل
إليك كيفية تنفيذ التحقق من الحالة في نظام الطلبات الخاص بك:الخطوات التالية
إنشاء رابط دفع
تعلم كيفية إنشاء روابط الدفع
دليل التكامل
دليل تكامل Navio الكامل

