Skip to main content

​
Overview

Test mode lets you simulate payments without processing real transactions. All test credentials only work in test mode — never use them in production.

No Real Charges

Test transactions don’t process actual payments or affect real accounts.

Full API Access

All API endpoints work identically in test and live modes.

Webhook Testing

Webhooks fire for test transactions just like production.
Test credentials only work in test mode. Attempting to use them in live mode will result in payment failures.

​
Test Cards

Use these card numbers to simulate successful and declined payments across different regions.
For all test cards, use expiry date 06/32 (or 12/34) and CVV 123.

​
How to Test Renewal Failure

1

Create a test subscription

Create a subscription with your test API keys using a success test card (for example, 4242 4242 4242 4242). The initial charge should succeed and the subscription should become active.
2

Swap in the failure card via Customer Portal

Open the Customer Portal, find the subscription you just created, and click Update Payment Method. Enter the failure test card 4000 0000 0000 0341 (Expiry: 12/34, CVC: 123) and save it as the subscription’s payment method.
3

Advance the next billing date (optional)

To trigger renewal immediately instead of waiting for the natural billing cycle, use the Update Subscription API to set next_billing_date to the current UTC time. The value must be an ISO 8601 / RFC 3339 UTC timestamp (the Z suffix is required).
See the Update Subscription API reference for details.
4

Verify the failure

On the next billing attempt:
  • The renewal charge declines on the failure card
  • The subscription moves to On-Hold status
  • A payment.failed webhook event is delivered
  • The customer can return to the Customer Portal to update the payment method and retry
This card is specifically for testing renewal failures. The charge will decline on the next billing date, allowing you to test payment retry logic, customer notifications, and failure handling.

​
Test UPI

UPI testing uses special VPA (Virtual Payment Address) identifiers that simulate different payment outcomes.

​
Requirements for UPI Testing

  • Billing country must be set to IN
  • Currency must be INR
  • For non-Indian merchants: Adaptive Currency must be enabled
For complete UPI documentation including RBI mandate testing for subscriptions, see the India Payment Methods page.

​
Test BNPL

Buy Now Pay Later providers have specific test data requirements.

​
Klarna Test Data

Use these details to simulate Klarna payments in test mode:
Klarna requires a minimum transaction amount of $50.01 to appear as a payment option.

​
Afterpay Testing

1

Select Afterpay

Choose Afterpay as the payment method in checkout and click Pay.
2

Test successful payment

Use any valid email address and shipping address for successful payments.
3

Test failed authentication

Pour simuler un échec, fermez la fenêtre modale Afterpay sur la page de redirection. Le paiement passe de requires_customer_action à requires_payment_method.
Afterpay requires a minimum transaction amount of $50.01 to appear as a payment option.
Pour consulter la documentation complète sur le BNPL, y compris les tests B2B de Billie, consultez la page Buy Now Pay Later.

​
Tester les portefeuilles numériques

​
Apple Pay

1

Enable test mode

Utilisez vos clés API de test Dodo Payments.
2

Add a card to Apple Wallet

Ajoutez une carte réelle à votre Apple Wallet. En mode test, la carte ne sera pas débitée.
3

Complete test purchase

Ouvrez le checkout sur un appareil Apple et terminez le parcours Apple Pay.
Apple Pay nécessite HTTPS. Il ne s’affichera pas sur localhost sans configuration SSL appropriée. La vérification du domaine doit également être terminée.

​
Google Pay

1

Join the test card group

Rejoignez le groupe de cartes de test Google Pay pour que des cartes de test soient automatiquement ajoutées à votre portefeuille.
2

Enable test mode

Utilisez vos clés API de test Dodo Payments.
3

Complete test purchase

Sélectionnez l’une des cartes de test dans Google Pay pour terminer la transaction.

​
Amazon Pay, Cash App Pay et RevolutPay

Utilisez vos clés API de test et suivez le parcours de checkout standard. Les transactions de test sont simulées sans débit réel. Pour consulter la documentation complète sur les portefeuilles numériques, y compris la vérification du domaine pour Apple Pay, consultez la page Portefeuilles numériques.

​
Test ACH Direct Debit

ACH Direct Debit peut être testé en mode Test en saisissant des coordonnées bancaires de test lors du paiement.
1

Enable test mode

Utilisez vos clés API de test Dodo Payments.
2

Set currency and billing address

Définissez la devise de facturation sur USD et le pays de l’adresse de facturation sur US. ACH n’est pas proposé en dehors de cette combinaison.
3

Use a one-time payment

ACH n’est pas disponible lors des paiements d’abonnements. Testez-le donc avec un paiement ponctuel.
4

Enter the test bank details

Saisissez l’une des paires de numéros de routage et de compte de test ci-dessous, puis vérifiez que votre gestionnaire de webhooks reçoit le statut final du paiement — les paiements ACH sont confirmés de manière asynchrone, et non lors du paiement.

​
Comptes bancaires de test

Utilisez le numéro de routage 110000000 avec l’un des numéros de compte suivants : Pour consulter la liste complète des comptes de test, reportez-vous à la page ACH Direct Debit.

​
Tester les méthodes européennes

Les méthodes de paiement européennes (iDEAL, Bancontact, EPS, Multibanco) peuvent être testées en mode Test.
1

Enable test mode

Utilisez vos clés API de test Dodo Payments.
2

Set billing address

Définissez le pays de l’adresse de facturation pour qu’il corresponde à la méthode de paiement :
  • NL pour iDEAL
  • BE pour Bancontact
  • AT pour EPS
  • PT pour Multibanco
3

Set currency

Les méthodes européennes nécessitent la devise EUR.
4

Complete test flow

Suivez le parcours d’authentification bancaire simulé dans l’environnement de test.

​
IBAN SEPA Direct Debit de test

SEPA Direct Debit nécessite la devise EUR et une adresse de facturation située dans la zone euro. Utilisez ces IBAN de test pour forcer un résultat spécifique : Pour consulter la liste complète des IBAN de test, y compris les valeurs par pays, reportez-vous à la page Europe. Pour consulter la documentation complète sur les méthodes de paiement européennes, reportez-vous à la page Europe.

​
Bonnes pratiques de test

Ne testez pas uniquement les paiements réussis. Testez les refus, les annulations et les cas particuliers, comme les fonds insuffisants.
Assurez-vous que vos endpoints de webhook traitent correctement tous les types d’événements, en particulier payment.succeeded, payment.failed et les événements d’abonnement.Utilisez la Dodo Payments CLI pour tester les webhooks localement :
  • dodo wh listen transfère les webhooks de test en direct vers votre serveur local
  • dodo wh trigger envoie des charges utiles simulées pour tous les types d’événements de webhook pris en charge
Pour Apple Pay et Google Pay, effectuez les tests sur de véritables appareils iOS et Android. Les simulateurs ne reproduisent pas complètement le comportement des portefeuilles électroniques.
Les méthodes de paiement régionales (UPI, iDEAL, etc.) nécessitent des adresses de facturation correspondantes. Une adresse de facturation aux États-Unis ne permettra pas d’afficher iDEAL.
Les méthodes BNPL nécessitent un minimum de 50,01 $. Vérifiez qu’elles s’affichent ou se masquent correctement en fonction du total du panier.

​
Pages connexes

Cards

Tests de cartes, 3D Secure et méthodes de paiement enregistrées.

Digital Wallets

Tests d’Apple Pay, Google Pay et Amazon Pay.

BNPL

Tests de Klarna, Afterpay et Billie.

India

Tests d’UPI et du mandat RBI.

Europe

Tests d’iDEAL, Bancontact, EPS et Multibanco.

Webhooks

Configurez les webhooks pour les événements de test.

CLI Webhook Testing

Testez les webhooks localement avec la Dodo Payments CLI.
Dernière modification le 17 août 2026