Mode test et cas d'usage

Utilisez le mode test et nos cas d'usage pour tester votre intégration.

Le mode test de Stripe vous permet de tester votre intégration sans recevoir de paiement réel. Le mode test est un environnement permettant de simuler la création d’objets sans affecter vos transactions réelles ni effectuer de transfert de fonds réel. Pour vous aider dans le processus de test, nous vous recommandons d’utiliser nos cas d’usage de test d’assurance qualité (QA) et d’importer notre collection Postman.

Mode test

En mode test, vous pouvez débiter des cartes bancaires de test et créer des produits et tarifs de test. Vous pouvez également utiliser le mode test pour simuler des transactions afin de vérifier que votre intégration fonctionne comme prévu. Cette fonctionnalité vous permet d’identifier d’éventuels bugs et erreurs dans votre implémentation Stripe avant de procéder à des paiements réels.

Après avoir créé un compte Stripe, vous trouverez un ensemble de clés API de test dans le tableau de bord Stripe. Vous pouvez utiliser ces clés API pour créer et récupérer des données simulées en faisant des requêtes à l’API Stripe. Pour commencer à accepter des paiements réels, vous devez activer votre compte, désactiver le mode test et utiliser les clés API réelles dans votre intégration. Stripe fournit un certain nombre de ressources pour tester votre intégration.

Effet sur le mode production

Dans le Dashboard, la modification des paramètres en mode test est également répercutée en mode production. De nombreuses pages du Dashboard présentent un cadre blanc de notification et désactivent les paramètres du mode production en mode test. Dans ce cas, tous les paramètres encore activés peuvent être utilisés en toute sécurité. Si ce cadre blanc n’est pas affiché, partez du principe que les modifications apportées en mode test seront répercutées en mode production (à moins que vous ne voyiez une bannière de données de test orange).

Modes test et production

Toutes les requêtes à l’API Stripe sont effectuées en mode test ou en mode production. Les objets API d’un mode ne sont pas accessibles dans l’autre. Par exemple, un objet Product du mode test ne peut pas faire l’objet d’un paiement en mode production.

Type	Quand l’utiliser	Objets	Comment l’utiliser	Considérations
mode test	Utilisez le mode test et les clés API de test correspondantes lors du développement de votre intégration. En mode test, les paiements ne sont pas réellement traités par les réseaux de cartes et fournisseurs de services de paiement.	Les appels à l’API renvoient des objets fictifs. Vous pouvez par exemple récupérer et utiliser des objets `account`, `payment`, `customer`, `charge`, `refund`, `transfer`, `balance` et `subscription` de test.	Utilisez des cartes et des comptes de test. Vous ne pouvez pas accepter de moyens de paiement réels ni utiliser de vrais comptes.	Identity n’effectue aucun contrôle de vérification. Les objets Account de Connect ne renvoient pas de champs sensibles.
mode production	Utilisez le mode production et les clés API de production correspondantes au moment de lancer votre intégration et de commencer à accepter des fonds. En mode production, les paiements sont réellement traités par les réseaux de cartes et fournisseurs de services de paiement.	Les appels à l’API renvoient des objets réels. Vous pouvez par exemple récupérer et utiliser des objets `account`, `payment`, `customer`, `charge`, `refund`, `transfer`, `balance` et `subscription` réels.	Acceptez des cartes bancaires réelles et utilisez de vrais comptes client. Vous pouvez accepter des paiements, autorisations de paiement et captures réels à partir de cartes bancaires et de comptes.	Les litiges ont un flux plus nuancé et un processus de test plus simple. En outre, certains moyens de paiement ont un flux plus nuancé et nécessitent plus d’étapes.

Le bouton Mode test du Dashboard n’affecte pas le code de votre intégration, car le comportement de votre code est déterminé par vos clés API des modes test et production.

Numéros de cartes bancaires de test

Stripe fournit plusieurs numéros de cartes de test afin de vous permettre de simuler différents scénarios de paiement. Vous pouvez les utiliser pour créer des paiements fictifs en mode test, sans traiter aucun paiement réel.

Vous pouvez simuler un paiement abouti en utilisant un numéro de carte de test, combiné à n’importe quelle date d’expiration postérieure à la date du jour et n’importe quel code CVC à trois chiffres. Pour simuler un échec de paiement, vous devez utiliser des numéros de carte et codes CVC de test spécifiques fournis par Stripe.

Les numéros de cartes bancaires de test sont uniquement valides en mode test. Ne les utilisez pas pour effectuer des paiements réels.

Supprimer les données de test

Pour supprimer toutes les données de test de votre compte Stripe, effectuez les actions suivantes :

Connectez-vous au Dashboard à l’aide de votre compte Stripe existant.
En mode test, cliquez sur Développeurs > Aperçu.
Sous Données de test, cliquez sur Examiner les données de test. La boîte de dialogue affiche une liste de tous les objets de données de test existants.
Cliquez sur Supprimer les données de test pour lancer le processus de suppression. Vous ne pouvez pas annuler la suppression de vos données de test.

Le mode test est temporairement inutilisable durant le processus de suppression.

Note

Vous devez supprimer manuellement les dispositifs de mesure, car cet objet n’est pas pris en charge par le processus de suppression automatique des données de test.

E-mail de test

Par défaut, Stripe n’envoie pas d’e-mail aux clients en mode test. Par exemple, le paiement d’une facture en mode test n’envoie pas d’e-mail de reçu au client. Les factures finalisées via l’API en mode test n’envoient pas non plus d’e-mail de reçu au client.

Si vous souhaitez que Stripe envoie un e-mail aux clients en mode test, vous pouvez procéder comme suit dans le Dashboard :

Créer et envoyer manuellement une facture à un client spécifique.
Envoyer manuellement un reçu pour une facture payée.

Si vous souhaitez vérifier les adresses e-mail des factures et des reçus, vous pouvez définir l’adresse e-mail de votre équipe sur l’objet Customer ou l’attribut receipt_email de l’objet PaymentIntent.

Tester les cas d’usage

Le tableau suivant présente les cas d’usage des tests d’assurance qualité (AQ) :

Cas d’usage	Action
Paiement réussi (si capture immédiate)	Pas d’erreur. Le paiement apparaît comme réussi dans le Dashboard sous Paiements. Stripe capture le paiement.
Autorisation du PaymentIntent réussie (capture de fonds ultérieurement)	`{ ... "capture_method": "manual", ... "status": "requires_capture", ... }`
Capture du PaymentIntent réussie (si capture immédiate ou capture de fonds ultérieurement)	`{ ... "status": "succeeded", ... }`
Échec de paiement	Le paiement apparaît comme En échec dans le Dashboard sous Paiements. `{ "error": { "charge": "ch_bgz4V2SFIziOZXDb", "code": "card_declined", "decline_code": "<<REASON HERE>>", "doc_url": "https://docs.stripe.com/error-codes#card-declined", "message": "Your card was declined.", "type": "card_error" } }`
Blocage Radar	Quelle que soit la version de Radar utilisée, un paiement peut être bloqué en raison d’un risque élevé ou d’une règle. La réponse est la même que celle renvoyée en cas d’échec de paiement.
Paiement contesté	Le paiement apparaît comme contesté dans le Dashboard sous Paiements. Stripe débite le montant du paiement plus les frais de litige du solde, crée un objet `Dispute`, ainsi que l’événement `charge.dispute.created` qui lui est associé. `{ "object": { "id": "du_zM2wVr511FJcqlUz", "object": "dispute", "charge_id": "ch_gLB7JugDSlG43svP", ... "status": "needs_response" } }`
Demande d’information sur le paiement en cours	Les demandes d’informations sont semblables aux litiges, mais il convient de noter trois principales différences : les fonds ne sont pas prélevés (sauf si la demande d’informations est considérée comme un litige), les fonds relatifs aux demandes d’informations sont remboursables jusqu’à ce que le paiement soit contesté, et les états des demandes sont différents. Dans ce cas, Stripe envoie un événement `charge.dispute.created`. `{ "object": { "id": "du_Pr0xP61wUQ50LsYk", "object": "dispute", "charge_id": "ch_yiMUCW1hHhdSCgdR", ... "is_charge_refundable": true, ... "status": "warning_needs_response" } }`
Litige remporté	Lorsqu’un client remporte un litige, les fonds du paiement d’origine sont reversés sur le compte, déduction faite des frais de litige. Stripe met à jour l’objet `Dispute` existant et déclenche l’événement `charge.dispute.closed`. `{ "object": { "id": "du_N7AxsxpGhs4BimlD", "object": "dispute", "charge_id": "ch_DRYGYjBlBOOuZMbc", ... "status": "won" } }`
Litige perdu	Lorsqu’un client perd un litige, Stripe met à jour l’objet `Dispute` existant et déclenche l’événement `charge.dispute.closed`. `{ "object": { "id": "du_Nc3vdFU4qZoYOSsi", "object": "dispute", "charge_id": "ch_evtwfgQBlA7JHCDU", ... "status": "lost" } }`
Demande d’informations remportée	Lorsque vous remportez une demande d’information, votre solde reste le même, car les fonds ne sont pas retirés lors de l’ouverture initiale de la demande d’information. Stripe met à jour l’objet `Dispute` existant et déclenche un événement `charge.dispute.closed`. `{ "object": { "id": "du_tY1t6LBQfwdOjgbE", "object": "dispute", "charge_id": "ch_drn8X4RZlWvTmX8y", ... "status": "warning_closed" } }`
Demande d’information perdue	Lorsque vous perdez une demande d’information, celle-ci se transforme en litige. Lorsqu’elle se transforme en litige, son état est modifié par l’événement `charge.dispute.updated`, et les fonds sont retirés par l’événement `charge.dispute.funds_withdrawn` : `{ "object": { "id": "du_n2BVG6p73zGQVv29", "object": "dispute", "charge_id": "ch_70FGK5fnhXirtkUC", ... "status": "needs_response" } }`
Paiement remboursé	Le paiement apparaît comme Remboursé dans le Dashboard sous Paiements. `{ "id": "re_FIAHylYqVIpZa5Ct", "object": "refund", "amount": "<<FULL AMOUNT>>", "charge": "ch_7f3RzXw7e8tSgvaI", ... "payment_intent": "pi_8C5OQOgIGC59gID5", // if you're using PaymentIntents ... "status": "succeeded" }`
Paiement partiellement remboursé	Le paiement apparaît comme Remboursé dans le Dashboard sous Paiements. Le montant du remboursement diffère du montant du paiement, et vous pouvez toujours contester les paiements partiellement remboursés. `{ "id": "re_qVc8dTOphDcK60my", "object": "refund", "amount": "<<PARTIAL AMOUNT>>", "charge": "ch_Iy1cO5fAZ8s2KYzb", ... "payment_intent": "pi_q1TEdW44dYXvzI54", // if you are using PaymentIntents ... "status": "succeeded" }`
Le solde du compte devient négatif	Veillez à tester les soldes négatifs sur Stripe et à vérifier que vos comptes bancaires peuvent accepter des prélèvements de notre part.
Virement réussi	Si vous activez les webhooks en cas de réussite du virement (recommandé), testez votre gestion de l’événement.
Échec du virement	Si vous activez les webhooks en cas d’échec de virement (recommandé), testez votre gestion de l’événement.

Collection Postman de Stripe

Postman est un outil de développement d’API largement utilisé. Pour simplifier l’intégration de Stripe, nous offrons une collection Postman spécifique aux paiements avec les outils dont vous aurez besoin pour tester le composant côté serveur de votre intégration.

Importer la collection

Pour commencer, vous devez accéder à l’application Postman. Vous pouvez utiliser la version navigateur ou bureau. Après avoir lancé l’application, importez la collection.

Pour lancer ce processus sur le Web, cliquez sur le bouton Importer dans le coin supérieur gauche, puis sur l’option Lien. Insérez le lien de la collection Payments. Si vous utilisez l’application de bureau Postman, cliquez sur Fichier > Importer. Une fois l’importation réussie, la collection apparaît sous Collections.

La boîte de dialogue d’importation

Utiliser la collection

Pour utiliser la collection, accédez à la collection que vous venez d’importer et cliquez sur Variables. Copiez votre clé secrète Stripe en mode test depuis le Dashboard Stripe et collez-la dans le champ Valeur initiale. Une fois cette étape terminée, vous pouvez commencer à effectuer des requêtes.

D’autres variables sont renseignées par des scripts pendant la phase d’exécution de la collection. Par exemple, lors de la création d’un client, d’un tarif, d’un paiement ou d’un PaymentIntent, un script dans la collection enregistre cet ID à utiliser dans les requêtes postérieures telles qu’un remboursement.

Ajouter une clé secrète à une collection Postman