Skip to main content
Utilisez les identifiants de test de cette page pour simuler des paiements réussis, refusés et échoués en mode test. Aucun mouvement d’argent n’a lieu et aucun compte réel n’est débité. Pour voir un paiement de test complet, regardez cette vidéo.

Full API Access

Tous les endpoints API sont disponibles en mode test.

Webhook Testing

Les webhooks sont déclenchés pour les transactions de test de la même manière qu’en production.
Les identifiants de test fonctionnent uniquement en mode test. En mode live, un paiement effectué avec un identifiant de test échoue.

​
Cartes de test

Utilisez ces numéros de carte pour simuler des paiements réussis et refusés dans différentes régions.
Pour toutes les cartes de test, utilisez la date d’expiration 06/32 (ou 12/34) et le CVV 123.

​
Tester les échecs de renouvellement

1

Create a test subscription

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

Update the payment method

Ouvrez le Customer Portal, recherchez l’abonnement et cliquez sur Mettre à jour le moyen de paiement. Saisissez la carte de test d’échec 4000000000000341 (expiration : 12/34, CVV : 123), puis enregistrez-la.
3

Advance the next billing date (optional)

Pour déclencher immédiatement le renouvellement au lieu d’attendre le cycle de facturation naturel, utilisez l’API Update Subscription pour définir next_billing_date sur l’heure UTC actuelle, en remplaçant la valeur d’exemple ci-dessous. La valeur doit être un horodatage UTC ISO 8601 / RFC 3339 (le suffixe Z est obligatoire).
Consultez la référence de l’API Update Subscription pour plus d’informations.
4

Verify the failure

Lors de la prochaine tentative de facturation :
  • Le prélèvement de renouvellement est refusé avec la carte d’échec
  • L’abonnement passe d’abord à Past Due (la période de grâce ; le webhook subscription.past_due contient past_due_ends_at), puis à On-Hold à la fin de la période de grâce
  • Un événement webhook payment.failed est envoyé
  • Le client peut retourner dans le Customer Portal pour mettre à jour le moyen de paiement et effectuer une nouvelle tentative

​
Tester UPI

Les tests UPI utilisent des identifiants VPA (Virtual Payment Address) spéciaux qui simulent différents résultats de paiement.

​
Conditions requises pour les tests UPI

  • Le pays de facturation doit être défini sur IN
  • La devise doit être INR
  • Pour les marchands non indiens : Adaptive Currency doit être activé
Pour la documentation UPI complète, y compris les tests de mandat RBI pour les abonnements, consultez la page Moyens de paiement en Inde.

​
Tester Pix

Les tests Pix utilisent un CPF de test (identifiant fiscal brésilien) pour simuler le parcours du code QR.

​
Conditions requises pour les tests Pix

  • Le pays de facturation doit être défini sur BR
  • La devise doit être BRL
Saisissez le CPF de test lorsque cela vous est demandé lors du checkout. Un code QR de test est généré : scannez-le avec l’appareil photo habituel de votre téléphone (aucune application Pix n’est nécessaire) et vous serez redirigé vers une page de test où vous pourrez simuler la transaction comme réussie ou échouée. Pour la documentation Pix complète, consultez la page Pix.

​
Tester BNPL

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

​
Données de test Klarna

Utilisez ces informations pour simuler des paiements Klarna en mode test :
Klarna exige un montant de transaction minimum de $50.01 pour apparaître comme option de paiement.

​
Tester Afterpay

1

Select Afterpay

Choisissez Afterpay comme moyen de paiement lors du checkout, puis cliquez sur Pay.
2

Test successful payment

Utilisez n’importe quelle adresse e-mail 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_customer_action à requires_payment_method.
Afterpay exige un montant de transaction minimum de $50.01 pour apparaître comme option de paiement.
Pour la documentation BNPL complète, 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

Désactivez le bouton Live Mode dans la barre latérale du dashboard et utilisez les clés API créées en mode test. Consultez Mode test et mode live.
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 n’apparaîtra 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

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

Enable test mode

Désactivez le bouton Live Mode dans la barre latérale du dashboard et utilisez les clés API créées en mode test. Consultez Mode test et mode live.
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 prélèvement réel. Pour la documentation complète sur les portefeuilles numériques, y compris la vérification de domaine pour Apple Pay, consultez la page Portefeuilles numériques.

​
Tester ACH Direct Debit

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

Enable test mode

Désactivez le bouton Live Mode dans la barre latérale du dashboard et utilisez les clés API créées en mode test. Consultez Mode test et mode live.
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 sur les checkouts d’abonnement ; 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 webhook reçoit le statut final du paiement — les paiements ACH sont confirmés de manière asynchrone et non lors du checkout.

​
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, consultez la page ACH Direct Debit.

​
Tester les moyens de paiement européens

Les moyens de paiement européens (iDEAL, Bancontact, EPS, Multibanco) peuvent être testés en mode test.
1

Enable test mode

Désactivez le bouton Live Mode dans la barre latérale du dashboard et utilisez les clés API créées en mode test. Consultez Mode test et mode live.
2

Set billing address

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

Set currency

Les moyens de paiement européens nécessitent la devise EUR.
4

Complete test flow

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

​
IBAN de test SEPA Direct Debit

SEPA Direct Debit nécessite l’EUR et une adresse de facturation située dans la zone euro. Utilisez ces IBAN de test pour forcer un résultat précis : Pour consulter la liste complète des IBAN de test, avec les valeurs par pays, consultez la page Europe. Pour la documentation complète sur les moyens de paiement européens, consultez la page Europe.

​
Tester les portefeuilles d’Asie-Pacifique

GCash, Alipay HK, FPS et Touch ‘n Go sont des paiements par code QR qui apparaissent uniquement lorsque le pays et la devise de facturation correspondent.
1

Enable test mode

Désactivez le bouton Live Mode dans la barre latérale du dashboard et utilisez les clés API créées en mode test. Consultez Mode test et mode live.
2

Set billing country and currency

Créez un checkout ponctuel avec la paire correspondante :
3

Select the method and confirm

Sélectionnez le moyen et cliquez sur Pay. Un code QR s’ouvre dans une superposition plein écran et le checkout attend le paiement.
4

Verify the checkout behavior

Vérifiez que le moyen apparaît uniquement pour le pays et la devise correspondants et que le code QR s’affiche.
Les codes QR en mode test sont émis par l’environnement de test du fournisseur de portefeuille et peuvent se comporter différemment d’un paiement live.
Pour la documentation complète, consultez la page Asie-Pacifique.

​
Bonnes pratiques de test

Ne testez pas uniquement les paiements réussis. Testez les refus, les annulations et les cas limites comme les fonds insuffisants.
Vérifiez que vos endpoints webhook traitent correctement tous les types d’événements, notamment payment.succeeded, payment.failed et les événements d’abonnement.Utilisez le Dodo Payments CLI pour tester les webhooks localement :
  • dodo wh listen transfère les webhooks de test live vers votre serveur local
  • dodo wh trigger envoie des payloads simulés pour tous les types d’événements webhook pris en charge
Pour Apple Pay et Google Pay, testez sur de véritables appareils iOS et Android. Les simulateurs ne reproduisent pas complètement le comportement des portefeuilles.
Les moyens de paiement régionaux (UPI, iDEAL, etc.) nécessitent des adresses de facturation correspondantes. Une adresse de facturation américaine n’affichera pas iDEAL.
Les moyens BNPL nécessitent un minimum de $50.01. Vérifiez qu’ils apparaissent ou sont masqués correctement selon le total du panier.

​
Pages associées

Cards

Tests de cartes, 3D Secure et moyens de paiement enregistrés.

Digital Wallets

Tests Apple Pay, Google Pay et Amazon Pay.

BNPL

Tests Klarna, Afterpay et Billie.

India

Tests UPI et de mandat RBI.

Pix

Tests Pix avec un CPF de test.

Europe

Tests iDEAL, Bancontact, EPS et Multibanco.

Asia-Pacific

Tests GCash, Alipay HK, FPS et Touch ‘n Go.

Webhooks

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

CLI Webhook Testing

Testez les webhooks localement avec le Dodo Payments CLI.
Dernière modification le 26 septembre 2026