نظرة عامة
يتيح لك وضع الاختبار محاكاة عمليات الدفع من دون معالجة معاملات حقيقية. تعمل جميع بيانات اعتماد الاختبار في وضع الاختبار فقط — لا تستخدمها مطلقًا في بيئة الإنتاج.No Real Charges
لا تعالج معاملات الاختبار مدفوعات فعلية ولا تؤثر في الحسابات الحقيقية.
Full API Access
تعمل جميع نقاط نهاية API بالطريقة نفسها في وضعي الاختبار والإنتاج.
Webhook Testing
تُرسل Webhooks لمعاملات الاختبار تمامًا كما في بيئة الإنتاج.
بطاقات الاختبار
استخدم أرقام البطاقات هذه لمحاكاة عمليات الدفع الناجحة والمرفوضة في مناطق مختلفة.- Successful Payments
- Declined Payments
- Subscription Failure Testing (Renewal/Upgrade/Downgrade)
بالنسبة إلى جميع بطاقات الاختبار، استخدم تاريخ الانتهاء 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 لتعيين راجع مرجع Update Subscription API للحصول على التفاصيل.
next_billing_date إلى الوقت الحالي بتوقيت UTC. يجب أن تكون القيمة طابعًا زمنيًا بتنسيق ISO 8601 / RFC 3339 بتوقيت UTC (لاحقة Z مطلوبة).4
Verify the failure
في محاولة الفوترة التالية:
- تُرفض رسوم التجديد على بطاقة الفشل
- تنتقل حالة الاشتراك إلى معلّق
- يتم تسليم حدث webhook من النوع
payment.failed - يمكن للعميل العودة إلى Customer Portal لتحديث طريقة الدفع وإعادة المحاولة
اختبار UPI
يستخدم اختبار UPI معرّفات VPA (Virtual Payment Address) خاصة لمحاكاة نتائج دفع مختلفة.متطلبات اختبار UPI
- يجب تعيين بلد الفوترة إلى
IN - يجب أن تكون العملة
INR - بالنسبة إلى التجار من خارج الهند: يجب تمكين Adaptive Currency
اختبار 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_customer_action إلى requires_payment_method.تتطلب Afterpay حدًا أدنى لمبلغ المعاملة قدره $50.01 حتى تظهر كخيار دفع.
اختبار المحافظ الرقمية
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.
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، راجع صفحة المحافظ الرقمية.اختبار ACH Direct Debit
يمكن اختبار ACH Direct Debit في Test Mode من خلال إدخال بيانات بنك الاختبار عند الدفع.1
Enable test mode
استخدم مفاتيح اختبار API الخاصة بـ Dodo Payments.
2
Set currency and billing address
عيّن عملة الفوترة إلى
USD وبلد عنوان الفوترة إلى US. لا يتم تقديم ACH خارج هذا الجمع.3
Use a one-time payment
لا يتوفر ACH في عمليات الدفع للاشتراكات، لذا اختبره باستخدام دفعة لمرة واحدة.
4
Enter the test bank details
أدخل أحد أزواج أرقام التوجيه وأرقام الحسابات الاختبارية أدناه، ثم تأكد من أن معالج webhook لديك يتلقى حالة الدفع النهائية — إذ يتم تأكيد دفعات ACH بشكل غير متزامن وليس عند الدفع.
الحسابات البنكية الاختبارية
استخدم رقم التوجيه110000000 مع أي من أرقام الحسابات التالية:
للاطلاع على القائمة الكاملة للحسابات الاختبارية، راجع صفحة ACH Direct Debit.
اختبار طرق الدفع الأوروبية
يمكن اختبار طرق الدفع الأوروبية (iDEAL وBancontact وEPS وMultibanco) في Test Mode.1
Enable test mode
استخدم مفاتيح API الاختبارية الخاصة بـ Dodo Payments.
2
Set billing address
عيّن بلد عنوان الفوترة ليتطابق مع طريقة الدفع:
NLلـ iDEALBEلـ BancontactATلـ EPSPTلـ Multibanco
3
Set currency
تتطلب الطرق الأوروبية عملة EUR.
4
Complete test flow
اتبع تدفق مصادقة البنك المُحاكى في بيئة الاختبار.
أرقام IBAN الاختبارية لـ SEPA Direct Debit
يتطلب SEPA Direct Debit عملة EUR وعنوان فوترة في منطقة اليورو. استخدم أرقام IBAN الاختبارية التالية لفرض نتيجة محددة:
للاطلاع على القائمة الكاملة لأرقام IBAN الاختبارية، بما في ذلك القيم الخاصة بكل بلد، راجع صفحة Europe.
للاطلاع على الوثائق الكاملة لطرق الدفع الأوروبية، راجع صفحة Europe.
أفضل ممارسات الاختبار
Test all payment scenarios
Test all payment scenarios
لا تختبر الدفعات الناجحة فقط. اختبر حالات الرفض والإلغاء والحالات الطرفية مثل عدم كفاية الرصيد.
Verify webhook handling
Verify webhook handling
تأكد من أن نقاط نهاية webhook تعالج جميع أنواع الأحداث بشكل صحيح، وخاصة
payment.succeeded وpayment.failed وأحداث الاشتراكات.استخدم Dodo Payments CLI لاختبار webhooks محليًا:dodo wh listenيوجّه webhooks الاختبارية المباشرة إلى خادمك المحليdodo wh triggerيرسل payloads وهمية لجميع أنواع أحداث webhook المدعومة
Test on real devices
Test on real devices
بالنسبة إلى Apple Pay وGoogle Pay، اختبر على أجهزة iOS وAndroid فعلية. لا تحاكي المحاكيات سلوك المحفظة بالكامل.
Test regional methods with correct addresses
Test regional methods with correct addresses
تتطلب طرق الدفع الإقليمية (UPI وiDEAL وغيرهما) عناوين فوترة متطابقة. لن يظهر iDEAL عند استخدام عنوان فوترة أمريكي.
Verify minimum amounts
Verify minimum amounts
تتطلب طرق 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
إعداد webhooks لأحداث الاختبار.
CLI Webhook Testing
اختبر webhooks محليًا باستخدام Dodo Payments CLI.