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

To simulate failure, close the Afterpay modal window on the redirect page. The payment transitions from requires_action to 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.

​
Tester les méthodes européennes

Les méthodes de paiement européennes (iDEAL, Bancontact, EPS, Multibanco) peuvent être testées en mode sandbox.
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.
Pour consulter la documentation complète sur les méthodes de paiement européennes, consultez 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 payloads simulés pour les 22 types d’événements
Pour Apple Pay et Google Pay, effectuez les tests sur de véritables appareils iOS et Android. Les simulateurs ne reproduisent pas entièrement le comportement des portefeuilles.
Les méthodes de paiement régionales (UPI, iDEAL, etc.) nécessitent des adresses de facturation correspondantes. Une adresse de facturation américaine n’affichera pas 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 associées

Cards

Tests des cartes, de 3D Secure et des 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 des mandats 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 31 juillet 2026