Skip to main content
استخدم بيانات الاعتماد التجريبية في هذه الصفحة لمحاكاة عمليات الدفع الناجحة والمرفوضة والفاشلة في وضع الاختبار. لا تنتقل أي أموال، ولا يتم خصم أي رسوم من حساب حقيقي. لمشاهدة عملية دفع تجريبية كاملة، شاهد هذا الفيديو.

Full API Access

يتوفر كل API endpoint في وضع الاختبار.

Webhook Testing

يتم تشغيل Webhooks للمعاملات التجريبية بالطريقة نفسها المتّبعة في بيئة الإنتاج.
تعمل بيانات الاعتماد التجريبية في وضع الاختبار فقط. في الوضع المباشر، تفشل عملية الدفع التي تستخدم بيانات اعتماد تجريبية.

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

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

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

1

Create a test subscription

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

Update the payment method

افتح Customer Portal، وابحث عن الاشتراك، ثم انقر على Update Payment Method. أدخل بطاقة الاختبار الخاصة بالفشل 4000000000000341 (تاريخ الانتهاء: 12/34، وCVV: 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

في محاولة الفوترة التالية:
  • تُرفض رسوم التجديد باستخدام بطاقة الفشل
  • ينتقل الاشتراك أولًا إلى Past Due (فترة السماح؛ ويحمل Webhook‏ subscription.past_due القيمة past_due_ends_at)، ثم إلى On-Hold عند انتهاء فترة السماح
  • يتم تسليم حدث Webhook‏ payment.failed
  • يمكن للعميل العودة إلى Customer Portal لتحديث طريقة الدفع وإعادة المحاولة

​
اختبار UPI

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

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

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

​
اختبار Pix

يستخدم اختبار Pix رقم CPF تجريبيًا (رقم التعريف الضريبي البرازيلي) لمحاكاة تدفق رمز QR.

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

  • يجب تعيين بلد الفوترة إلى BR
  • يجب أن تكون العملة BRL
أدخل CPF التجريبي عند طلبه أثناء إتمام الدفع. يتم إنشاء رمز QR تجريبي — امسحه باستخدام الكاميرا العادية لهاتفك (لا حاجة إلى تطبيق Pix)، وستتم إعادة توجيهك إلى صفحة اختبار حيث يمكنك محاكاة المعاملة كعملية ناجحة أو فاشلة. للاطلاع على وثائق Pix الكاملة، راجع صفحة Pix.

​
اختبار 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 حتى يظهر كخيار دفع.
للاطلاع على وثائق BNPL الكاملة، بما في ذلك اختبار Billie B2B، راجع صفحة Buy Now Pay Later.

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

​
Apple Pay

1

Enable test mode

أوقف مفتاح Live Mode في الشريط الجانبي للوحة التحكم، واستخدم مفاتيح API التي أُنشئت في وضع الاختبار. راجع Test Mode vs Live Mode.
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

أوقف مفتاح Live Mode في الشريط الجانبي للوحة التحكم، واستخدم مفاتيح API التي أُنشئت في وضع الاختبار. راجع Test Mode vs Live Mode.
3

Complete test purchase

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

​
Amazon Pay وCash App Pay وRevolutPay

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

​
اختبار ACH Direct Debit

يمكن اختبار ACH Direct Debit في وضع الاختبار بإدخال بيانات مصرفية تجريبية أثناء إتمام الدفع.
1

Enable test mode

أوقف مفتاح Live Mode في الشريط الجانبي للوحة التحكم، واستخدم مفاتيح API التي أُنشئت في وضع الاختبار. راجع Test Mode vs Live Mode.
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) في وضع الاختبار.
يعرض Multibanco قسيمة بدلًا من مسار مصرفي. راجع اختبار Multibanco.
1

Enable test mode

أوقف مفتاح التبديل Live Mode في الشريط الجانبي للوحة التحكم، واستخدم مفاتيح API التي أُنشئت في وضع الاختبار. راجع Test Mode vs Live Mode.
2

Set billing address

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

Set currency

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

Complete test flow

اتبع مسار مصادقة البنك المحاكى في بيئة الاختبار.

​
اختبار Multibanco

استخدم EUR وعنوان إرسال فواتير PT. بعد النقر على Pay، يعرض الدفع عند إتمام العملية قسيمة Multibanco. في وضع الاختبار، تحدد رسالة البريد الإلكتروني التي تدخلها النتيجة: لعرض صفحة النجاح، استخدم succeed_immediately@example.com، وانتظر بضع ثوانٍ، ثم اضغط على Done. للاطلاع على القائمة الكاملة لرسائل البريد الإلكتروني الاختبارية، راجع صفحة Europe.

​
اختبار IBANs لخدمة SEPA Direct Debit

تتطلب SEPA Direct Debit عملة EUR وعنوان إرسال فواتير في منطقة اليورو. استخدم IBANs الاختبارية هذه لفرض نتيجة محددة: للاطلاع على القائمة الكاملة لرقم IBANs الاختبارية، بما في ذلك القيم الخاصة بكل بلد، راجع صفحة Europe. للاطلاع على الوثائق الكاملة لطرق الدفع الأوروبية، راجع صفحة Europe.

​
اختبار المحافظ في منطقة آسيا والمحيط الهادئ

إن GCash وAlipay HK وFPS وTouch ‘n Go هي عمليات دفع عبر رموز QR لا تظهر إلا عند تطابق بلد إرسال الفواتير والعملة.
1

Enable test mode

أوقف مفتاح التبديل Live Mode في الشريط الجانبي للوحة التحكم، واستخدم مفاتيح API التي أُنشئت في وضع الاختبار. راجع Test Mode vs Live Mode.
2

Set billing country and currency

أنشئ عملية دفع عند إتمام العملية لمرة واحدة باستخدام الزوج المطابق:
3

Select the method and confirm

حدد الطريقة وانقر على Pay. يُفتح رمز QR في طبقة تغطية بملء الشاشة، وينتظر الدفع عند إتمام العملية إتمام الدفع.
4

Verify the checkout behavior

تأكد من ظهور الطريقة فقط للبلد والعملة المطابقين، ومن عرض رمز QR.
تصدر بيئة الاختبار لدى موفر المحفظة رموز QR الخاصة بوضع الاختبار، وقد تتصرف بشكل مختلف عن عملية الدفع الفعلية.
للاطلاع على الوثائق الكاملة، راجع صفحة Asia-Pacific.

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

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

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

Cards

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

Digital Wallets

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

BNPL

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

India

اختبار UPI وRBI mandate.

Pix

اختبار Pix باستخدام CPF اختباري.

Europe

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

Asia-Pacific

اختبار GCash وAlipay HK وFPS وTouch ‘n Go.

Webhooks

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

CLI Webhook Testing

اختبار webhooks محليًا باستخدام Dodo Payments CLI.
آخر تعديل في ٨ أكتوبر ٢٠٢٦