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) في وضع الاختبار.
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

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

​
أرقام IBAN التجريبية لـ SEPA Direct Debit

يتطلب SEPA Direct Debit عملة EUR وعنوان فوترة في منطقة اليورو. استخدم أرقام IBAN التجريبية هذه لفرض نتيجة محددة: للاطلاع على القائمة الكاملة لأرقام IBAN التجريبية، بما في ذلك القيم الخاصة بكل بلد، راجع صفحة 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.
تتطلب طرق BNPL حدًا أدنى قدره $50.01. اختبر ظهورها أو اختفاءها بشكل صحيح بناءً على إجمالي سلة التسوق.

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

Cards

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

Digital Wallets

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

BNPL

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

India

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

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.
آخر تعديل في ٢٦ سبتمبر ٢٠٢٦