بيئة الاختبار

بطاقات الاختبار

أرقام بطاقات تنجح أو تُرفض أو تطلب 3-D Secure أو تجيب متأخرة في صفحة الدفع المحاكاة في وضع الاختبار.

فتح بصيغة Markdown

في وضع الاختبار، صفحة الدفع بالبطاقة محاكاة تحمل علامة TEST. لا تقبل إلا الأرقام أدناه: يُرفض أي رقم آخر برسالة «استخدم بطاقة اختبار»، ولا يُخزَّن أبدًا. لا تعمل بطاقة حقيقية في وضع الاختبار أبدًا.

اكتب رقمًا في الصفحة، أو انقر عليه في قائمة الصفحة. وإذا طلبت الصفحة تاريخ انتهاء أو رمز أمان، فاستخدم أي تاريخ في المستقبل وأي ثلاثة أرقام. وللدفع دون متصفح، أرسل الرقم نفسه إلى أداة الاختبار المساعدة complete.

الأرقام

رقم البطاقةتاريخ الانتهاءأي تاريخ في المستقبلCVCأي 3 أرقامالسيناريوالنتيجة
4242 4242 4242 4242تاريخ الانتهاء12/34CVC123نجاح

تنجح فورًا.

4000 0000 0000 3220تاريخ الانتهاء12/34CVC1233-D Secure

تُفتح صفحة 3-D Secure محاكاة. موافقة: تنجح. فشل: تُرفض، authentication_failed.

4000 0000 0000 0002تاريخ الانتهاء12/34CVC123مرفوضة

تُرفض، card_declined.

4000 0000 0000 9995تاريخ الانتهاء12/34CVC123رصيد غير كافٍ

تُرفض، card_declined مع رمز الرفض insufficient_funds.

4000 0000 0000 0069تاريخ الانتهاء12/34CVC123بطاقة منتهية الصلاحية

تُرفض، expired_card.

4000 0000 0000 0119تاريخ الانتهاء12/34CVC123خطأ في المعالجة

تفشل، processing_error.

4000 0000 0000 0077تاريخ الانتهاء12/34CVC123تأكيد بطيء

تنجح بعد 60 ثانية؛ وإلى ذلك الحين لا تكون الدفعة مؤكدة.

4000 0000 0000 0085تاريخ الانتهاء12/34CVC123إشعارات متكررة وغير مرتبة

تنجح مرة واحدة، مع أن التأكيد يصل إلى AdProMaxPay عدة مرات ودون ترتيب.

4000 0000 0000 0093تاريخ الانتهاء12/34CVC123تأكيد مفقود

لا يصل أي تأكيد أبدًا: لا تنجح الدفعة أبدًا، وتنتهي صلاحية المحاولة بعد نحو 30 دقيقة.

بعد الرفض، تعود نية الدفع (payment intent) إلى requires_payment_method، مع السبب في last_payment_error، وتتلقى payment_intent.payment_failed. يمكن لعميلك تجربة بطاقة أخرى في الصفحة نفسها.

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

  • نجاح ومرفوضة: صفحتك للطلبية المدفوعة وصفحتك للطلبية الفاشلة.
  • 3-D Secure: الخطوة الإضافية التي قد يطلبها البنك. لا يفعل كودك شيئًا خاصًا؛ تتولاها الصفحة المستضافة.
  • تأكيد بطيء: يعود عميلك إلى success_url قبل تأكيد الدفعة. اعرض «نحن بصدد تأكيد دفعتك»، وسلّم الطلبية عند وصول الـ webhook، لا عند العودة.
  • إشعارات متكررة: تتلقى مع ذلك حدث payment_intent.succeeded واحدًا، وإن كانت عملية تسليم الـ webhook نفسها قد تصل مرتين: انظر إزالة التكرار.
  • تأكيد مفقود: قد تنتهي دفعة دون مال حتى بعد أن مرّ عميلك بصفحة الدفع. لا تسلّم الطلبية أبدًا قبل succeeded.

الصورة الكاملة للحالات في كيف تعمل المدفوعات. وما يختلف غير ذلك عن الوضع المباشر في بيئة الاختبار والوضع المباشر: الفروق.