Passer au contenu principal

​
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.
RegionBrandCard NumberExpiryCVV
USVisa424242424242424206/32123
USMastercard555555555555444406/32123
IndiaVisa457623891277145006/32123
IndiaMastercard540916266938103406/32123
Pour toutes les cartes de test, utilisez la date d’expiration 06/32 (ou 12/34) et le CVV 123.

​
Comment tester l’échec du renouvellement

1

Create a test subscription

Créez un abonnement avec vos clés API de test en utilisant une carte de test réussie (par exemple, 4242 4242 4242 4242). Le prélèvement initial doit réussir et l’abonnement doit devenir actif.
2

Swap in the failure card via Customer Portal

Ouvrez le portail client, trouvez l’abonnement que vous venez de créer et cliquez sur Mettre à jour le mode de paiement. Entrez la carte de test d’échec 4000 0000 0000 0341 (Expiration : 12/34, CVC : 123) et enregistrez-le comme méthode de paiement de l’abonnement.
3

Advance the next billing date (optional)

Pour déclencher le renouvellement immédiatement au lieu d’attendre le cycle de facturation naturel, utilisez l’API de mise à jour d’abonnement pour définir next_billing_date à l’heure UTC actuelle. La valeur doit être un horodatage UTC ISO 8601 / RFC 3339 (le suffixe Z est requis).
PATCH /subscriptions/{subscription_id}
{
  "next_billing_date": "2026-05-03T00:00:00Z"
}
Voir la référence de l’API de mise à jour d’abonnement pour plus de détails.
4

Verify the failure

Lors de la prochaine tentative de facturation :
  • Le prélèvement de renouvellement est refusé sur la carte d’échec
  • L’abonnement passe au statut En attente
  • Un événement webhook payment.failed est livré
  • Le client peut retourner au portail client pour mettre à jour la méthode de paiement et réessayer
Cette carte est spécifiquement conçue pour tester les échecs de renouvellement. Le prélèvement sera refusé à la prochaine date de facturation, vous permettant de tester la logique de nouvelle tentative de paiement, les notifications client et la gestion des échecs.

​
Tester UPI

Le test UPI utilise des identifiants VPA (Adresse de Paiement Virtuelle) spéciaux qui simulent différents résultats de paiement.
StatutUPI ID
Succèssuccess@upi
Échecfailure@upi

​
Exigences pour le test UPI

  • Le pays de facturation doit être défini sur IN
  • La devise doit être INR
  • Pour les commerçants non indiens : la monnaie adaptative doit être activée
Pour la documentation UPI complète, y compris le test de mandat RBI pour les abonnements, consultez la page Méthodes de paiement en Inde.

​
Tester BNPL

Les fournisseurs Buy Now Pay Later ont des exigences de données de test spécifiques.

​
Données de test Klarna

Utilisez ces détails pour simuler des paiements Klarna en mode test :
ChampApprouvéRefusé
Date de naissance07-10-197007-10-1970
PrénomTestTest
NomPerson-usPerson-us
Emailcustomer@email.uscustomer+denied@email.us
RueAmsterdam AveAmsterdam Ave
Numéro de maison509509
VilleNew YorkNew York
ÉtatNew YorkNew York
Code postal10024-394110024-3941
Téléphone+13106683312+13106354386
Klarna nécessite un montant minimum de transaction de 50,01 $ pour apparaître comme option de paiement.

​
Test Afterpay

1

Select Afterpay

Choisissez Afterpay comme méthode de paiement lors du passage à la caisse et cliquez sur Payer.
2

Test successful payment

Utilisez n’importe quelle adresse email et adresse de livraison valides pour les paiements réussis.
3

Test failed authentication

Pour simuler un échec, fermez la fenêtre modale Afterpay sur la page de redirection. Le paiement passe de requires_action à requires_payment_method.
Afterpay nécessite un montant minimum de transaction de 50,01 $ pour apparaître comme option de paiement.

​
Test Sunbit

1

Set billing country and currency

Assurez-vous que billing_address.country est US et billing_currency est USD.
2

Use a qualifying amount

Définir le montant de la transaction entre 60,00et60,00 et 19 999,00.
3

Complete the Sunbit flow

Sélectionnez Sunbit au moment du paiement et complétez la demande de financement dans le module Sunbit.
4

Test failure

Fermez le module Sunbit avant de terminer le processus pour simuler une demande refusée. Le paiement passe à requires_payment_method.
Sunbit n’apparaît que pour les clients américains payant en USD avec un montant compris entre 60,00∗∗et∗∗60,00** et **19 999,00.
Pour la documentation complète BNPL, y compris les tests Billie B2B, consultez la page Achetez maintenant, payez plus tard.

​
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 processus de paiement sur un appareil Apple et complétez le flux Apple Pay.
Apple Pay nécessite HTTPS. Il n’apparaîtra pas sur localhost sans une configuration SSL appropriée. La vérification de domaine doit également être complète.

​
Google Pay

1

Join the test card group

Rejoignez le groupe de cartes test Google Pay pour obtenir automatiquement des cartes de test 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 test dans Google Pay pour compléter la transaction.

​
Amazon Pay, Cash App Pay & RevolutPay

Utilisez vos clés API de test et suivez le flux de paiement standard. Les transactions de test sont simulées sans frais réels. Pour la documentation complète des portefeuilles numériques, y compris la vérification de 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 monnaie EUR.
4

Complete test flow

Suivez le flux d’authentification bancaire simulé dans l’environnement de test.
Pour la documentation complète des méthodes de paiement européennes, consultez la page Europe.

​
Meilleures pratiques de test

Ne vous contentez pas de tester les paiements réussis. Testez les refus, les annulations et les cas extrêmes comme les fonds insuffisants.
Assurez-vous que vos points de terminaison webhook traitent correctement tous les types d’événements, en particulier payment.succeeded, payment.failed, et les événements d’abonnement.Utilisez le Dodo Payments CLI pour tester les webhooks localement :
  • dodo wh listen transmet les webhooks de test en direct à votre serveur local
  • dodo wh trigger envoie des charges fictives pour les 22 types d’événements
Pour Apple Pay et Google Pay, testez sur de vrais 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 aux États-Unis n’affichera pas iDEAL.
Les méthodes BNPL nécessitent un minimum de 50,01 $. Testez qu’elles apparaissent/se cachent correctement en fonction du total du panier.

​
Pages associées

Cards

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

Digital Wallets

Test Apple Pay, Google Pay, Amazon Pay.

BNPL

Test Klarna, Afterpay, et Billie.

India

Test UPI et mandat RBI.

Europe

Test iDEAL, Bancontact, EPS, Multibanco.

Webhooks

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

CLI Webhook Testing

Testez les webhooks localement avec le Dodo Payments CLI.
Last modified on May 26, 2026