Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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.
Pour la documentation complète sur BNPL, y compris le test 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 la caisse sur un appareil Apple et complétez le processus 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 de test Google Pay pour obtenir automatiquement les 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 de 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 processus de caisse standard. Les transactions de test sont simulées sans frais réels. Pour une 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 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 correspondre à 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 processus d’authentification bancaire simulé dans l’environnement de test.
Pour une documentation complète sur les méthodes de paiement européennes, consultez la page Europe.

​
Bonnes pratiques de test

Ne testez pas seulement les paiements réussis. Testez les refus, les annulations et les cas limites comme les fonds insuffisants.
Assurez-vous que vos points de terminaison webhook traitent correctement tous les types d’événements, surtout payment.succeeded, payment.failed, et les événements d’abonnement.Utilisez le CLI Dodo Payments pour tester les webhooks localement :
  • dodo wh listen redirige les webhooks de test en direct vers votre serveur local
  • dodo wh trigger envoie des charges utiles simulées 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 US ne montrera 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 connexes

Cards

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

Digital Wallets

Test d’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

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

CLI Webhook Testing

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