# سيناريوهات اختبار الدفع النقدي

ادفع رمز دفع نقدي للاختبار، أو أنهِ صلاحيته، أو ارفضه، أو علّقه، وشاهد كيف يتفاعل تكاملك مع كل نتيجة.

لا يمكن سداد رمز دفع نقدي للاختبار لدى وكيل. بدل ذلك، تقرر أنت ما يحدث له، في أحد ثلاثة
مواضع:

* **محاكاة الدفع** والأزرار الأخرى في صفحة القسيمة التي يراها عميلك، في وضع الاختبار؛
* بطاقة **أدوات الاختبار المساعدة** في صفحة الدفعة في لوحة التحكم، في وضع الاختبار؛
* [واجهة API لأدوات الاختبار المساعدة](https://pay-docs.adpromax.com/ar/sandbox/test-helpers)، للاختبارات الآلية: `pay` و`expire` و`refuse` و
  `suspend` على محاولة الدفعة.

تصل النتيجة إلى الدفعة كما تصل في الوضع المباشر: عبر فحص حالة على الشبكة
المحاكاة، ثم آلة الحالات، ثم الأحداث والـ webhook لديك. وبعد أي إجراء محاكى يجري الفحص
فورًا، فتصل النتيجة في ثوانٍ.

## السيناريوهات

- **مدفوع** (`pay`): تنجح الدفعة: `payment_intent.succeeded`.

- **مدفوع بمبلغ آخر** (`pay` مع `amount` مختلف): لا يُضاف شيء إلى رصيدك: تبقى الدفعة `processing` مع `review` (`amount_mismatch`)، وتتلقى `review.opened`.

- **منتهي الصلاحية** (`expire`): تنتهي المحاولة بحالة `expired`؛ وتعود الدفعة إلى `requires_payment_method` مع `voucher_expired`.

- **مدفوع بعد انتهاء الصلاحية** (`expire`، ثم `pay`): لا يُضاف شيء إلى رصيدك: `review` (`paid_after_end`) و`review.opened`.

- **مرفوض من الشبكة** (`refuse`): تفشل المحاولة بالرمز `voucher_refused`؛ وتعود الدفعة إلى `requires_payment_method`.

- **معلّق ثم مدفوع** (`suspend`، ثم `pay`): تنتظر الدفعة ما دام الرمز معلّقًا، ثم تنجح.

- **أقل من 100 MAD** (دفعة نقدية بمبلغ 50.00 MAD (`5000`)): تُرفض بالرمز `amount_too_small`، كما في الوضع المباشر.

## المبلغ الواجب دفعه

تحمل القسيمة مبلغين: `amount` الخاص بك، و`amount_to_pay` الذي يسلّمه عميلك، ويضيف
رسم طابع صغيرًا (في وضع الاختبار، 0.25 MAD: `15000` تصبح `15025`). يدفع عميلك
الرسم؛ ولا يُقتطع من `amount` الخاص بك. اعرض `amount_to_pay` كما تحدده القسيمة.

لتجربة **مدفوع بمبلغ آخر**، مرّر `amount` بعيدًا بوضوح عن مبلغ الدفعة، مثل نصفه.
من دون `amount`، يسدد `pay` القسيمة كاملة.

## ما يعلّمه كل سيناريو

* **منتهي الصلاحية**: هكذا تنتهي معظم الرموز غير المدفوعة. حرّر الطلبية أو المخزون، ودع عميلك
  يحصل على رمز جديد.
* **مدفوع بمبلغ آخر** و**مدفوع بعد انتهاء الصلاحية**: قد يصل مال لا يطابق
  الدفعة. لا يضيف AdProMaxPay شيئًا إلى رصيدك من تلقاء نفسه وينظر في الأمر أحد أعضاء فريقنا؛ وينتظر كودك
  `succeeded`، وقد لا تأتي أبدًا لهذه الدفعة.
* **معلّق**: قد يبقى رمز معلّقًا مدة لدى الشبكة. ليس على كودك إلا
  الانتظار.

سيناريوهات البطاقة في [بطاقات الاختبار](https://pay-docs.adpromax.com/ar/sandbox/test-cards). وكيف يختلف الدفع نقدًا في الوضع المباشر في
[بيئة الاختبار والوضع المباشر: الفروق](https://pay-docs.adpromax.com/ar/sandbox/differences).