Skip to main content

​
نظرة عامة

يتيح لك وضع الاختبار محاكاة عمليات الدفع من دون معالجة معاملات حقيقية. تعمل جميع بيانات اعتماد الاختبار في وضع الاختبار فقط — لا تستخدمها مطلقًا في بيئة الإنتاج.

No Real Charges

لا تعالج معاملات الاختبار مدفوعات فعلية ولا تؤثر في الحسابات الحقيقية.

Full API Access

تعمل جميع نقاط نهاية API بالطريقة نفسها في وضعي الاختبار والإنتاج.

Webhook Testing

تُرسل Webhooks لمعاملات الاختبار تمامًا كما في بيئة الإنتاج.
تعمل بيانات اعتماد الاختبار في وضع الاختبار فقط. ستؤدي محاولة استخدامها في وضع الإنتاج إلى فشل عمليات الدفع.

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

استخدم أرقام البطاقات هذه لمحاكاة عمليات الدفع الناجحة والمرفوضة في مناطق مختلفة.
بالنسبة إلى جميع بطاقات الاختبار، استخدم تاريخ الانتهاء 06/32 (أو 12/34) ورمز CVV 123.

​
كيفية اختبار فشل التجديد

1

Create a test subscription

أنشئ اشتراكًا باستخدام مفاتيح API للاختبار وبطاقة اختبار ناجحة (مثل 4242 4242 4242 4242). يجب أن تنجح عملية الخصم الأولية وأن يصبح الاشتراك نشطًا.
2

Swap in the failure card via Customer Portal

افتح Customer Portal، واعثر على الاشتراك الذي أنشأته للتو، ثم انقر على تحديث طريقة الدفع. أدخل بطاقة اختبار الفشل 4000 0000 0000 0341 (تاريخ الانتهاء: 12/34، CVC: 123) واحفظها كطريقة الدفع الخاصة بالاشتراك.
3

Advance the next billing date (optional)

لتشغيل التجديد فورًا بدلًا من انتظار دورة الفوترة الطبيعية، استخدم Update Subscription API لتعيين next_billing_date إلى الوقت الحالي بتوقيت UTC. يجب أن تكون القيمة طابعًا زمنيًا بتنسيق ISO 8601 / RFC 3339 بتوقيت UTC (لاحقة Z مطلوبة).
راجع مرجع Update Subscription API للحصول على التفاصيل.
4

Verify the failure

في محاولة الفوترة التالية:
  • تُرفض رسوم التجديد على بطاقة الفشل
  • تنتقل حالة الاشتراك إلى معلّق
  • يتم تسليم حدث webhook من النوع payment.failed
  • يمكن للعميل العودة إلى Customer Portal لتحديث طريقة الدفع وإعادة المحاولة
هذه البطاقة مخصصة لاختبار حالات فشل التجديد. ستُرفض الرسوم في تاريخ الفوترة التالي، ما يتيح لك اختبار منطق إعادة محاولة الدفع وإشعارات العملاء ومعالجة حالات الفشل.

​
اختبار UPI

يستخدم اختبار UPI معرّفات VPA (Virtual Payment Address) خاصة لمحاكاة نتائج دفع مختلفة.

​
متطلبات اختبار UPI

  • يجب تعيين بلد الفوترة إلى IN
  • يجب أن تكون العملة INR
  • بالنسبة إلى التجار من خارج الهند: يجب تمكين Adaptive Currency
للاطلاع على وثائق UPI الكاملة، بما في ذلك اختبار تفويض RBI للاشتراكات، راجع صفحة طرق الدفع في الهند.

​
اختبار BNPL

لدى مزوّدي Buy Now Pay Later متطلبات محددة لبيانات الاختبار.

​
بيانات اختبار Klarna

استخدم هذه التفاصيل لمحاكاة عمليات الدفع عبر Klarna في وضع الاختبار:
تتطلب Klarna حدًا أدنى لمبلغ المعاملة قدره $50.01 حتى تظهر كخيار دفع.

​
اختبار Afterpay

1

Select Afterpay

اختر Afterpay كطريقة الدفع في صفحة الدفع وانقر على Pay.
2

Test successful payment

استخدم أي عنوان بريد إلكتروني وعنوان شحن صالحين لإجراء عمليات دفع ناجحة.
3

Test failed authentication

لمحاكاة الفشل، أغلق نافذة Afterpay المنبثقة في صفحة إعادة التوجيه. تنتقل حالة الدفع من requires_action إلى requires_payment_method.
تتطلب Afterpay حدًا أدنى لمبلغ المعاملة قدره $50.01 حتى تظهر كخيار دفع.
للاطلاع على التوثيق الكامل لخدمة BNPL، بما في ذلك اختبار Billie B2B، راجع صفحة Buy Now Pay Later.

​
اختبار المحافظ الرقمية

​
Apple Pay

1

Enable test mode

استخدم مفاتيح اختبار API الخاصة بـ Dodo Payments.
2

Add a card to Apple Wallet

أضف بطاقة حقيقية إلى Apple Wallet. في وضع الاختبار، لن يتم تحصيل أي رسوم من البطاقة.
3

Complete test purchase

افتح صفحة الدفع على جهاز Apple وأكمل عملية Apple Pay.
يتطلب Apple Pay استخدام HTTPS. ولن يظهر على localhost من دون إعداد SSL بشكل صحيح. يجب أيضًا إكمال التحقق من النطاق.

​
Google Pay

1

Join the test card group

انضم إلى مجموعة بطاقات اختبار Google Pay لإضافة بطاقات الاختبار تلقائيًا إلى محفظتك.
2

Enable test mode

استخدم مفاتيح اختبار API الخاصة بـ Dodo Payments.
3

Complete test purchase

حدد إحدى بطاقات الاختبار في Google Pay لإكمال المعاملة.

​
Amazon Pay وCash App Pay وRevolutPay

استخدم مفاتيح اختبار API الخاصة بك واتبع مسار الدفع القياسي. تتم محاكاة معاملات الاختبار من دون تحصيل رسوم فعلية. للاطلاع على التوثيق الكامل للمحافظ الرقمية، بما في ذلك التحقق من النطاق لـ Apple Pay، راجع صفحة المحافظ الرقمية.

​
اختبار طرق الدفع الأوروبية

يمكن اختبار طرق الدفع الأوروبية (iDEAL وBancontact وEPS وMultibanco) في وضع sandbox.
1

Enable test mode

استخدم مفاتيح اختبار API الخاصة بـ Dodo Payments.
2

Set billing address

عيّن بلد عنوان الفوترة ليتطابق مع طريقة الدفع:
  • NL لـ iDEAL
  • BE لـ Bancontact
  • AT لـ EPS
  • PT لـ Multibanco
3

Set currency

تتطلب الطرق الأوروبية استخدام عملة EUR.
4

Complete test flow

اتبع مسار مصادقة البنك المُحاكى في بيئة الاختبار.
للاطلاع على التوثيق الكامل لطرق الدفع الأوروبية، راجع صفحة أوروبا.

​
أفضل ممارسات الاختبار

لا تكتفِ باختبار عمليات الدفع الناجحة. اختبر حالات الرفض والإلغاء والحالات الطرفية، مثل عدم كفاية الرصيد.
تأكد من أن نقاط نهاية webhook تعالج جميع أنواع الأحداث بشكل صحيح، وخاصة payment.succeeded وpayment.failed وأحداث الاشتراكات.استخدم Dodo Payments CLI لاختبار webhook محليًا:
  • dodo wh listen يعيد توجيه webhook الاختبارية المباشرة إلى خادمك المحلي
  • dodo wh trigger يرسل حمولات وهمية لجميع أنواع الأحداث البالغ عددها 22 نوعًا
بالنسبة إلى Apple Pay وGoogle Pay، اختبر على أجهزة iOS وAndroid فعلية. لا تحاكي المحاكيات سلوك المحفظة بالكامل.
تتطلب طرق الدفع الإقليمية (UPI وiDEAL وغيرهما) عناوين فوترة مطابقة. لن يظهر iDEAL عند استخدام عنوان فوترة أمريكي.
تتطلب طرق BNPL حدًا أدنى قدره $50.01. اختبر ظهورها أو إخفاءها بشكل صحيح بناءً على إجمالي سلة التسوق.

​
صفحات ذات صلة

Cards

اختبار البطاقات و3D Secure وطرق الدفع المحفوظة.

Digital Wallets

اختبار Apple Pay وGoogle Pay وAmazon Pay.

BNPL

اختبار Klarna وAfterpay وBillie.

India

اختبار UPI وتفويض RBI.

Europe

اختبار iDEAL وBancontact وEPS وMultibanco.

Webhooks

إعداد webhook لأحداث الاختبار.

CLI Webhook Testing

اختبر webhook محليًا باستخدام Dodo Payments CLI.
آخر تعديل في ٣١ يوليو ٢٠٢٦