بدّل إلى Sandbox من المفتاح أسفل اسم التطبيق، ثم أنشئ مفتاح API للاختبار واستخدمه. تُحاكى الفحوص ولا تُفرض رسوم، ويمكنك اختيار النتيجة المطلوبة.
بدّل إلى Sandbox من المفتاح أسفل اسم التطبيق، ثم أنشئ مفتاح API للاختبار واستخدمه. تُحاكى الفحوص ولا تُفرض رسوم، ويمكنك اختيار النتيجة المطلوبة.
sandbox في Didit هو مكافئ بطاقات الاختبار لدى مزوّد دفع: يتيح لك إعادة إنتاج أي نتيجة تحقق عند الطلب، دون استدعاء مزوّدين حقيقيين، أو التعامل مع بيانات شخصية حقيقية، أو المساس برصيدك.
#بيئة اختبار منفصلة
Sandbox هو تطبيق الاختبار المشترك لمؤسستك. يحتفظ بالبيانات والمفاتيح وwebhooks والقوائم منفصلة عن Live، ويظهر شريط أعلى الصفحة لتذكيرك ببيئة الاختبار.
- بدّل إلى Sandbox
انقر Sandbox أسفل اسم التطبيق. عند العودة إلى Live، راجع قائمة نشر سير العمل والمفتاح أو الرابط المباشر وwebhook والدفع والاحتفاظ بالبيانات، ثم اختر الانتقال أو البقاء في Sandbox.
- أنشئ مفتاح API للاختبار
افتح المطورون → مفاتيح API واختر Sandbox عند إنشاء المفتاح. المفتاح هو ما يحدد البيئة؛ مفتاح Live لا ينشئ جلسة Sandbox.
- أنشئ سير عمل أو انسخه
لبيئة Sandbox مسارات عمل خاصة بها. أنشئ ما تريد اختباره أو انسخه من Live.
- أنشئ الجلسات كالمعتاد
نفس نقطة النهاية، ونفس مسار الكود. الفرق الوحيد هو المفتاح الذي ترسله.
إذا كان Sandbox معطّلًا، فلا يوجد تطبيق اختبار لمؤسستك بعد. اطلب من الدعم تفعيله؛ هذا إعداد على مستوى الحساب.
#ما الذي يغيّره sandbox وما لا يغيّره
| sandbox | الفعلي | |
|---|---|---|
| المزوّدون الخارجيون | كلهم مُحاكون، لا يُستدعى أي طرف ثالث أبدًا | حقيقيون |
| الفوترة | لا تُفوتر أبدًا؛ يُتجاوز فحص الرصيد | تُفوتر لكل ميزة مكتملة |
| حد إنشاء الجلسات | 500 كل 24 ساعة، لكل تطبيق | رصيدك |
| حمولة الـ webhook | "environment": "sandbox" | "environment": "live" |
| البيانات والحالة المستخرجة | مُحاكاة وفق السيناريو الذي تختاره | مستمدة من الالتقاط الحقيقي |
| الوسائط الملتقطة | تُخزَّن فعليًا، تمامًا مثل جلسة فعلية | تُخزَّن |
يخزّن sandbox الوسائط التي يلتقطها: المستندات، الصورة الذاتية، فيديو فحص الحيوية، ملفات إثبات العنوان، تمامًا كما تفعل جلسة فعلية. النتيجة هي المحاكاة، لكن الرفع حقيقي، لذا استخدم المستندات النموذجية وبيانات الاختبار التي يوفرها التدفق بدلًا من مستند هوية حقيقي أو معلومات شخصية حقيقية.
بما أن النتائج لا تعتمد أبدًا على وحدات البكسل، فإن صورة سيئة عمدًا لن تُنتج رفضًا في sandbox. السيناريو هو ما يقرر.
#اختيار النتيجة
مرّر معرّف سيناريو كـ sandbox_scenario عند إنشاء الجلسة، أو اترك المختبِر يختار واحدًا: تعرض جلسات sandbox في التدفق المستضاف منتقي سيناريو داخل البطاقة قبل بدء الالتقاط، بالإضافة إلى شريط من المستندات النموذجية أسفل مكوّن الرفع وشعار دائم "بيانات اختبار فقط".
تغطي السيناريوهات النتائج التي تحتاجها فعلًا للبناء:
| تريد اختبار | السيناريو |
|---|---|
| قبول كل شيء | approve |
| مستند منتهي الصلاحية | decline_document_expired |
| مستند غير قابل للقراءة | decline_could_not_recognize_document |
| فشل التحقق من قيمة MRZ | decline_mrz_validation |
| أقل من الحد الأدنى للعمر | decline_minimum_age |
| مطابقة وجه منخفضة جدًا | decline_face_match_low_similarity |
| هجوم تمثيل على فحص الحيوية | decline_liveness_attack |
| تطابق عقوبات / PEP في AML | decline_aml_hit |
| عنوان IP محظور | decline_ip_blocklist |
| عدم تطابق العنوان في إثبات العنوان | decline_poa_address_mismatch |
| فشل سلامة شريحة NFC | decline_nfc_chip_not_verified |
| لم يجد التحقق من قاعدة البيانات أي تطابق | decline_database_no_match |
| يحتاج مراجعة يدوية (AML) | review_aml_possible_match |
| يحتاج مراجعة يدوية (مطابقة وجه حدّية) | review_face_match_borderline |
| يحتاج مراجعة يدوية (تطابق عنوان جزئي) | review_poa_partial_match |
| عدم تطابق سجل KYB | decline_kyb_registry_mismatch |
توجد سيناريوهات review_* لتتمكن من اختبار مسار المراجعة اليدوية بالكامل: طابور مراجعة الكونسول، وwebhook حالة In Review، وموافقة المراجع أو طلبه إعادة الإرسال، دون الحاجة إلى مدخل بدرجة رفض.
الكتالوج الحي للسيناريوهات والقيم السحرية يُقدَّم عبر الـ API نفسها على
GET /v1/sandbox/scenarios/. إذا بدا أي معرّف هنا قديمًا، ثق بنقطة النهاية.
مرجع كامل: اختبار sandbox.
#التمييز بين البيئتين في الكود الخاص بك
يحمل كل webhook حقل environment بقيمة "sandbox" أو "live". افرع بناءً على ذلك بدلًا من محاولة استنتاج البيئة من المفتاح، ولن تخلط أبدًا بين جلسة اختبارية وعميل حقيقي.
#ما لن يفعله sandbox
- لن يُعيد بيانات سجل حقيقية لشركة حقيقية. يستخدم KYB في sandbox استجابات سجل مُحاكاة.
- لن يرسل رسالة SMS أو بريدًا إلكترونيًا حقيقيًا. التحقق من الهاتف والبريد الإلكتروني مُحاكى، لذا لا يمكنك استخدام sandbox لمعاينة إمكانية توصيل رسالة حقيقية.
- لن يستهلك رصيد خطتك الشهري، وهذا يعني أيضًا أن تشغيلة sandbox لا تخبرك بشيء عن رصيدك المتبقي.
#إذا احتجت عمليات تحقق اختبارية حقيقية
بعض الأمور تتطلب فعليًا استدعاءً فعليًا: التحقق من أن خدمة قاعدة بيانات دولة معينة مُفعّلة لك، أو تأكيد توصيل SMS إلى مشغّل شبكة معين. هذا يحتاج شحن رصيد صغير على تطبيق فعلي بدلًا من sandbox. اسأل الدعم قبل إنفاق أي مبلغ عليه، حتى يتمكنوا من تأكيد أن الخدمة مُفعّلة فعليًا في حسابك أولًا.
ما زلت عالقًا؟ تحدث إلى إنسان.
أرفق معرّف مؤسستك ومعرّف الجلسة التي تسأل عنها.