Skip to main content

نظرة عامة

بعد إرسال طلب شحن الإنترنت، استعلم عن endpoint /check-id لتتبع الحالة واسترجاع تفاصيل البطاقة عند التنفيذ. تكتمل معظم الطلبات في 3-45 ثانية، لكن بعضها قد يكون في حالة QUEUED لمدة 12-48 ساعة.
استعلم كل 5-10 ثوانٍ حتى يصل الطلب إلى حالة نهائية: FULFILLED أو REFUNDED أو QUEUED.

مرجع API

GET /v3/internet/check-id/{id}

التوثيق الكامل للـ endpoint

قيم حالة الطلب

الطلب قيد المعالجة مع المشغل. المدة المعتادة: 3-45 ثانية. استمر في الاستعلام كل 5-10 ثوانٍ.
نجاح! تم تسليم البطاقة. card_code وnum_trans وdate_traitement متاحة. سلّم للعميل فوراً.
مجدول لاحقاً. سيُعالَج الطلب خلال 12-48 ساعة. ليس فشلاً - جدوّل إعادة التحقق وأبلغ العميل.
فشل. أُلغي الطلب وأُعيد المبلغ تلقائياً. أبلغ العميل بالفشل.

فحص الحالة الأساسي

أمثلة على الاستجابة

قيد المعالجة

منفَّذ (نجاح)

في قائمة الانتظار

حلقة الاستعلام الأساسية

استراتيجية الاستعلام المتكيفة

اضبط تكرار الاستعلام بناءً على الوقت المنقضي:

معالجة نتائج الطلب

معالجة حالة QUEUED

الطلبات في حالة QUEUED ليست فشلاً! إنها مجدولة للتسليم خلال 12-48 ساعة.

اختبار كل الحالات في sandbox

بمفتاح sandbox، الرقم الذي ترسله هو الذي يحدد سلوك الطلب — فتختبر كل مسار في كود الاستعلام لديك دون انتظار طلب حقيقي. تتقدم الحالات وحدها مع مرور الوقت؛ استعلم تمامًا كما تفعل في الإنتاج.
الطلب المكتمل في sandbox يعيد card_code: "TESTCARD" و\u200Enum_trans: "TESTTRANS" بدل القيم الحقيقية. وكل ما عدا ذلك — شكل الاستجابة وأسماء الحالات وسلوك الاستعلام — مطابق للإنتاج.

أفضل الممارسات

الاستعلام كل 5-10 ثوانٍ

توازن بين الاستجابة وعدد طلبات API

معالجة QUEUED بشكل صحيح

لا تعامل QUEUED كفشل - جدوّل إعادة التحقق بعد 24 ساعة

تحديد حد أقصى للوقت

أوقف الاستعلام بأمان بعد 5 دقائق

تحديث قاعدة البيانات

سجّل تغييرات الحالة وبيانات البطاقة عند كل تحديث

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

تسليم البطاقات

تسليم رموز البطاقات بأمان للعملاء

إرسال الشحنات

تقديم طلبات مع التحقق

مرجع API

التوثيق الكامل للـ endpoint