Accéder directement au contenu
Créez un compte ou connecter-vous
Logo de la documentation Stripe
/
Créez un compteConnectez-vous
Aperçu
Gestion des versions
Mettre à niveau votre version de l'API
Essentials
Outils
Stripe pour Visual Studio CodeServeur Discord de Stripe
Fonctionnalités
Alertes d'intégrité de StripeStripe SignalsChargements de fichiers
Solutions d'IA
Modèle de protocole contextuelCompétences d’agentCréer des flux de facturation SaaS avec l’IA agentiqueRépertoire Stripe
Extensions Stripe
PrésentationObjets personnalisés
Sécurité et confidentialité
Historique des logsRobot d'exploration Web Stripebot
Partenaires
Certification des partenaires

Cas d’usage pour les tests

Apprenez à tester votre intégration.

Les sandboxes sont les environnements de test de Stripe. Ils vous permettent de tester votre intégration sans effectuer de paiements ni de débits réels. Les environnements de test simulent la création d’objets réels sans impacter les transactions effectives ni déplacer de fonds réels. Vous pouvez accéder à vos environnements de test via le sélecteur de compte ou depuis la page Environnements de test du Dashboard. Nous vous recommandons d’utiliser nos cas d’usage de test d’assurance qualité (QA) et d’importer notre collection Postman pour vous accompagner dans le processus de test.

Environnements de test

Dans un environnement de test, vous pouvez débiter des cartes bancaires de test et créer des produits et des prix de test. Les environnements de test vous permettent de simuler des transactions afin de vérifier que votre intégration fonctionne correctement. Cela permet d’identifier les bugs ou erreurs dans votre implémentation Stripe avant de passer en production avec des paiements réels.

Après avoir créé un compte Stripe, vous êtes placé dans un environnement de test. Vous pouvez trouver un ensemble de clés API de test sur la page d’accueil du Dashboard Stripe ou sur la page des clés API. Vous pouvez utiliser ces clés API pour créer et récupérer des données simulées en effectuant des requêtes vers l’API Stripe.

Pour commencer à accepter des paiements réels, vous devez configurer votre compte Stripe, quitter votre environnement de test via le sélecteur de compte et utiliser les clés API de mode production dans votre intégration. Stockez les clés API de mode production dans un coffre de secrets ou des variables d’environnement. Ne stockez pas les clés dans le code source ni dans des fichiers de configuration versionnés. Pour plus d’informations, consultez les bonnes pratiques de gestion des clés API secrètes.

Impact sur le mode production lors de l’utilisation de l’environnement de test en mode test

Si vous modifiez des paramètres dans le Dashboard tout en étant dans les environnements de test en mode test, ces modifications peuvent également s’appliquer au mode production. De nombreuses pages du Dashboard affichent une notification et désactivent les paramètres du mode production dans ces environnements. Dans ce cas, les paramètres encore activés peuvent être utilisés sans risque. Si aucune notification n’est affichée, considérez que toute modification effectuée dans l’environnement de test en mode test affecte les paramètres du mode production (sauf si une bannière de données de test est visible).

Comparer les environnements de test

Votre compte Stripe inclut un environnement de test en mode test ainsi que la possibilité de créer des environnements de test supplémentaires. Bien que le mode test soit un environnement de test, il diffère des environnements de test classiques que vous pouvez créer. Comprendre ces différences peut vous aider à élaborer votre stratégie de test.

Environnement de test en mode testEnvironnements de test classiques
Nombre d’environnements de testUtilisez un seul environnement de test.Utilisez jusqu’à cinq environnements de test. L’environnement de test en mode test n’est pas pris en compte dans cette limite de cinq.
Contrôle d’accèsAccordez à tous les utilisateurs les mêmes rôles et accès qu’en mode production.Contrôlez l’accès de manière plus stricte. Lorsque le niveau d’accès à l’environnement de test est défini sur privé, seuls les administrateurs y ont automatiquement accès. Vous pouvez inviter des utilisateurs uniquement dans les environnements de test, sans leur accorder d’accès au mode production. Lorsque le niveau d’accès est défini pour tous les membres de l’équipe, tous les utilisateurs disposant de rôles bénéficient des mêmes rôles et des mêmes accès.
ParamètresParamètres partagés entre le mode production et l’environnement de test en mode test. Vous ne pouvez pas tester de nombreux paramètres de manière indépendante.Isolez complètement les paramètres pour chaque sandbox. Copiez les paramètres du mode production au moment de la création et effectuez des tests indépendamment de votre intégration en production.
Prise en charge des APICompatible avec V1 et partiellement avec V2.Compatible avec V1 et V2.
SuppressionImpossible à supprimer.Peut être supprimé.
ApplicationsLes installations nécessitent que l’application prenne en charge un environnement de test en mode test.Les installations nécessitent que l’application prenne en charge des environnements de test.
Limites des produitsVous ne pouvez pas tester la tarification IC+ en environnement de test en mode test.Vous ne pouvez pas tester la tarification IC+ dans un sandbox.
Limites d’appelsMaintenez des limites d’appels cohérentes.Maintenez des limites d’appels cohérentes.
Numéros de carte de testUtilisez les mêmes numéros de carte de test.Utilisez les mêmes numéros de carte de test.

Environnements de test et mode production

Toutes les requêtes API Stripe sont effectuées soit dans un environnement de test, soit en mode production. Les objets API d’un mode ne sont pas accessibles dans l’autre. Par exemple, un objet Product de test ne peut pas être utilisé pour un paiement en mode production.

TypeQuand l’utiliserObjetsComment l’utiliserConsidérations
Environnements de testUtilisez un environnement de test et les clés API test associées au fur et à mesure que vous développez votre intégration. Dans un bac à sable, les réseaux de cartes et les prestataires de services de paiement ne traitent pas les paiements.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 productionUtilisez 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 fait d’être dans un environnement de test dans le Dashboard n’affecte pas le code de votre intégration. Le comportement de votre code dépend des clés API de test et de production.

Créer un environnement de test supplémentaire

Pour créer et configurer un environnement de test supplémentaire dans le Dashboard :

Créer l’environnement de test

  1. Accédez à la page Environnements de test du Dashboard.
  2. Cliquez sur Créer en haut à droite.

Gérer l’accès

Les nouveaux environnements de test sont privés par défaut et ne donnent pas automatiquement accès aux autres membres de l’équipe. Vous pouvez accorder l’accès à tous les membres de l’équipe :

  1. Accédez à la page Environnements de test du Dashboard.
  2. Cliquez sur le menu déroulant () de l’environnement de test.
  3. Sélectionnez Modifier l’accès.

Vous pouvez gérer l’accès au niveau des entrepreneurs individuels de l’une des manières suivantes :

Obtenir les identifiants de votre environnement de test

Utilisez ces identifiants pour connecter votre intégration à l’environnement de test. Enregistrez-les dans un emplacement accessible à votre équipe pour les tests.

  1. Copiez les clés API de test de l’environnement de test.
  2. Copiez l’ID du compte de l’environnement de test.

Mettre à jour l’environnement de test

Vous pouvez mettre à jour toutes les références qui dépendent des données de test que vous avez créées précédemment.

  1. Configurez toutes les ressources dont vous avez besoin pour les tests, comme les produits, les clients, les abonnements et les moyens de paiement.
  2. Mettez à jour toute partie de vos processus de test qui dépend d’ID d’objets de test spécifiques. Cela change lorsque vous créez de nouveaux objets dans un environnement de test.

(Facultatif) Configurer des simulations

Configurez des simulations pour tester votre intégration Billing. Les simulations vous permettent d’avancer le temps dans l’environnement de test afin que des ressources comme les abonnements changent d’état et déclenchent des événements webhook.

Numéros de carte de test

Stripe fournit plusieurs numéros de cartes bancaires de test qui vous permettent de simuler différents scénarios de paiement. Vous pouvez les utiliser pour créer des paiements fictifs en environnement de test, sans traiter de paiements réels ni de débits.

Lorsque vous utilisez des numéros de carte de test, vous pouvez saisir n’importe quelle date d’expiration future et n’importe quel code CVC à trois chiffres pour simuler un paiement réussi. Si vous souhaitez simuler un paiement qui a échoué, vous pouvez utiliser les numéros de carte de test et les codes CVC spécifiques fournis par Stripe.

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

Supprimer les données de test

Pour supprimer toutes vos données de test de votre compte Stripe, procédez comme suit :

  1. Connectez-vous au Dashboard en utilisant votre compte Stripe existant.
  2. Dans votre environnement de test, cliquez sur Développeurs > Aperçu.
  3. Sous Données de test, cliquez sur Examiner les données de test. La boîte de dialogue vous présente une liste de tous vos objets de données de test existants.
  4. Cliquez sur Supprimer les données de test pour lancer le processus de suppression. La suppression de vos données de test est irréversible.

Les environnements de test sont temporairement indisponibles pendant le processus de suppression.

Remarque

Vous devez supprimer manuellement les Meters, car l’objet n’est pas pris en charge par le processus automatisé de suppression des données de test.

E-mail de test

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

Si vous souhaitez que Stripe envoie des e-mails aux clients dans un environnement de test, vous pouvez procéder comme suit dans le Dashboard :

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

Pour vérifier les e-mails pour les factures et les reçus, définissez l’adresse e-mail de votre équipe sur l’objet Customer ou l’attribut receipt_email sur le PaymentIntent.

Cas d’usage pour les tests

Le tableau suivant contient des cas d’usage de test d’assurance qualité (AQ) :

Cas d’usageAction
Réussite du paiement (capture immédiate)
  • Aucune erreur.
  • Le paiement apparaît avec l’état Réussi dans le Dashboard, sous Payments.
  • Stripe capture le paiement.
Réussite de l’autorisation d’un PaymentIntent (capture de fonds pour plus tard)
{
  ...
  "capture_method": "manual",
  ...
  "status": "requires_capture",
  ...
}
Réussite de la capture d’un PaymentIntent (capture immédiate ou capture de fonds pour plus tard)
{
    ...
    "status": "succeeded",
    ...
  }
Échec du paiementLe paiement apparaît avec l’état Échec dans le Dashboard, sous Payments.
{
  "error": {
    "charge": "ch_GP7sJnEIN3RNAlYw",
    "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 par RadarQuelle que soit la version de Radar que vous utilisez, il peut bloquer un paiement en raison d’un risque élevé ou d’une règle. La réponse est la même que celle renvoyée lorsqu’un paiement échoue.
Paiement contesté
  • Le paiement apparaît avec l’état Contesté dans le Dashboard, sous Payments.
  • Stripe débite le montant du paiement majoré des frais de litige du solde, crée un objet Dispute ainsi que son événement charge.dispute.created associé.
{
  "object": {
    "id": "du_nF2dQo2dTpuZx4AP",
    "object": "dispute",
    "charge_id": "ch_FmAsSK5g86Uammjh",
    ...
    "status": "needs_response"
  }
}

Demande d’information sur un paiement ouverte

Les demandes d’information sont similaires aux litiges, mais présentent trois différences majeures : aucun fonds n’est retiré, à moins que nous ne transformions une demande d’information en litige ; elles restent remboursables jusqu’à ce qu’elles fassent l’objet d’un litige ; et elles possèdent un ensemble d’états différent. Dans ce cas, Stripe déclenche un événement charge.dispute.created.

{
  "object": {
    "id": "du_CPRQL3DFjvGOfLQ6",
    "object": "dispute",
    "charge_id": "ch_hlme29cEKB948Bcn",
    ...
    "is_charge_refundable": true,
    ...
    "status": "warning_needs_response"
  }
}

Litige gagné

  • Lorsqu’un client remporte un litige, les fonds du paiement initial sont restitués sur le compte, moins les frais de litige.
  • Stripe met à jour l’objet Dispute existant et déclenche un événement charge.dispute.closed.
{
  "object": {
    "id": "du_rlKiZLU6vYw23O6s",
    "object": "dispute",
    "charge_id": "ch_lY6pJzNhs8wIPiPI",
    ...
    "status": "won"
  }
}

Litige perdu

Lorsqu’un client perd un litige, Stripe met à jour l’objet Dispute existant et déclenche un événement charge.dispute.closed.

{
  "object": {
    "id": "du_ewn8Hz1qyabWurbN",
    "object": "dispute",
    "charge_id": "ch_IwWBHCSunLeaSAEu",
    ...
    "status": "lost"
  }
}

Demande d’information gagné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_enq78xEiVYslh9rB",
    "object": "dispute",
    "charge_id": "ch_0aBUXoSjDnyq04XM",
    ...
    "status": "warning_closed"
  }
}

Demande d’information perdue

  • Lorsque vous perdez une demande d’information, elle se transforme en litige.
  • Lorsqu’elle se transforme en litige, son état change avec un événement charge.dispute.updated, et les fonds sont retirés lors d’un événement charge.dispute.funds_withdrawn :
{
  "object": {
    "id": "du_CufNzu24TGmCT1sD",
    "object": "dispute",
    "charge_id": "ch_oUD4oceYa1cSLHLy",
    ...
    "status": "needs_response"
  }
}

Paiement remboursé

Vous pouvez voir le paiement avec le statut Refunded dans le Dashboard sous l’onglet Paiement.

{
  "id": "re_X6qVSsZOC3evprcG",
  "object": "refund",
  "amount": "<<FULL AMOUNT>>",
  "charge": "ch_FZFLAJBuxd1JIiTL",
  ...
  "payment_intent": "pi_W06nrBYZF5JRlfc4", // if you're using PaymentIntents
  ...
  "status": "succeeded"
}

Paiement partiellement remboursé

  • Vous pouvez voir le paiement avec le statut Refunded dans le Dashboard sous l’onglet Paiement.
  • Le montant du remboursement est différent du montant du paiement, et vous pouvez toujours contester les paiements partiellement remboursés.
{
  "id": "re_xfDxmtDtX58kwEUv",
  "object": "refund",
  "amount": "<<PARTIAL AMOUNT>>",
  "charge": "ch_0LEQIGtrN9Pp3jlz",
  ...
  "payment_intent": "pi_52nrUegmlZNHFNEx", // if you're using PaymentIntents
  ...
  "status": "succeeded"
}
Le solde du compte devient négatifAssurez-vous de tester un solde négatif sur Stripe et de vérifier que vos comptes bancaires peuvent accepter nos débits.
Virement réussiSi vous activez les webhooks pour un virement réussi (recommandé), testez votre gestion de l’événement.
Échec de virementSi vous activez les webhooks pour un virement qui a échoué (recommandé), testez votre gestion de l’événement.

La collection Postman de Stripe

Postman est un outil de développement d’API courant. Pour vous aider à intégrer Stripe, nous fournissons une collection Postman spécifique dédiée aux paiements avec les outils dont vous avez 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 pour navigateur ou pour ordinateur de bureau. Après avoir lancé l’application, importez la collection.

Pour démarrer ce processus sur le web, cliquez sur Import (importer) dans le coin supérieur gauche, puis sur Link (lien). Insérez le lien de la collection dédiée aux paiements. Si vous utilisez l’application de bureau Postman, cliquez sur File (fichier) > Import (importer). Une fois l’importation réussie, la collection apparaît sous Collections.

Utiliser la collection

Pour utiliser la collection, accédez à la collection que vous venez d’importer, puis cliquez sur Variables. Copiez votre clé secrète d’environnement de test Stripe depuis le Dashboard Stripe, puis collez-la dans le champ Initial Value de la ligne secret_key. Une fois cette étape terminée, vous pouvez commencer à effectuer des requêtes.

Des scripts remplissent d’autres variables pendant l’exécution de la collection. Par exemple, lors de la création d’un Customer, d’un Price, d’un Charge ou d’un PaymentIntent, le système enregistre cet ID par le biais d’un script dans la collection, le rendant accessible pour les requêtes ultérieures, comme l’émission d’un remboursement.

Voir aussi

Sur cette page
Guides connexes
Test
Clés API