Skip to main content
GET

نظرة عامة

تحقق من حالة الدفع في الوقت الفعلي باستخدام مرجع الدفع. ضروري لمعالجة الطلبات والاستعلام عن الحالة والتحقق من المدفوعات.
الكشف التلقائي عن البيئة: يتحقق هذا الـ endpoint تلقائياً من معاملات الإنتاج (SATIM) والـ sandbox بناءً على مكان إنشاء الدفع.

معاملات المسار

string
مطلوب
كود مرجع الدفع (التنسيق: OCPL-XXXXXX-YYYY)
هذا هو paymentRef الذي يُعاد عند إنشاء رابط الدفع

الاستجابة

boolean
يشير إلى نجاح العملية
object
معلومات حالة الدفع
object
بيانات وصفية للاستجابة

شرح قيم الحالة

عند رؤية هذه الحالة:
  • لم يبدأ العميل عملية الدفع بعد
  • الدفع قيد المعالجة من قِبل البنك
  • الرابط تم إنشاؤه للتو ولم يُستخدم بعد
ما يجب فعله:
  • استمر في الاستعلام عن تحديثات الحالة
  • اعرض “الدفع معلق” للعميل
  • لا تُنفِّذ الطلب بعد
عند رؤية هذه الحالة: - اكتمل الدفع بنجاح - ستُضاف الأموال إلى رصيد OneClick الخاص بكما يجب فعله:
  • ضع علامة على الطلب كمدفوع في نظامك
  • نفِّذ الطلب/قدِّم الخدمة
  • أرسل تأكيداً للعميل
عند رؤية هذه الحالة:
  • تم رفض الدفع أو فشل
  • انتهت صلاحية رابط الدفع (20 دقيقة)
  • ألغى العميل الدفع
ما يجب فعله:
  • ضع علامة على الطلب كفاشل/ملغى
  • أنشئ رابط دفع جديداً إذا أراد العميل إعادة المحاولة
  • لا تُنفِّذ الطلب

انتهاء صلاحية الرابط

تنتهي صلاحية روابط الدفع بعد 20 دقيقة من الإنشاء إذا لم يُبدأ أي دفع. بعد انتهاء الصلاحية ستكون الحالة FAILED.

مثال التكامل

إليك كيفية تنفيذ التحقق من الحالة في نظام الطلبات الخاص بك:

الخطوات التالية

إنشاء رابط دفع

تعلم كيفية إنشاء روابط الدفع

دليل التكامل

دليل تكامل Navio الكامل