Tester Stripe Terminal
Apprenez comment bien tester votre intégration Terminal.
Remarque
Le processus de test de Stripe Terminal est en grande partie similaire à celui du test des paiements Stripe en ligne. De plus, vous ne pouvez pas utiliser Stripe Terminal avec des portefeuilles mobiles (par exemple, Apple Pay ou Google Pay) en modetest. Pour en savoir plus, consultez le guide de test général de Stripe.
Le meilleur moyen de réussir votre déploiement de Terminal est de tester chaque composante de votre intégration. Nous fournissons des outils de test pour chaque étape :
- Avant de commander un lecteur, testez votre intégration avec le simulateur de lecteur.
- Testez l’intégralité de votre intégration matérielle à l’aide d’une carte bancaire de test physique.
Lecteur de simulation
Les SDK et l’intégration pilotée par serveur de Stripe Terminal sont livrés avec un lecteur de carte simulé intégré, ce qui vous permet de développer et de tester votre application sans avoir à vous connecter à du matériel physique. Que votre intégration soit terminée ou que vous soyez en train de la développer, utilisez le lecteur simulé pour émuler tous les flux Terminal dans votre application.
Le lecteur virtuel ne fournit pas d’interface utilisateur. Après vous y être connecté(e) dans votre application, vous pouvez la voir fonctionner lorsque les appels au SDK ou à l’API Stripe aboutissent.
Les lecteurs simulés pour SDK simulent automatiquement la présentation des cartes si nécessaire. Concernant l’intégration pilotée par serveur, mettez à jour votre intégration pour simuler la présentation d’une carte.
Cartes bancaires de test pour simulation
Il est possible de configurer le lecteur de simulation afin d’utiliser une carte bancaire de test pour simulation, ce qui vous permet de tester différents flux dans votre application de point de vente.
Avant de collecter un moyen de paiement, configurez le lecteur de simulation afin d’utiliser l’un des numéros de carte bancaire de test ou des moyens de paiement de test suivants afin d’obtenir des réponses précises.
Cartes bancaires de test standard
Numéro de carte bancaire de test | Moyen de paiement de test | Marque |
---|---|---|
visa | Visa | |
visa_ | Visa (débit) | |
mastercard | Mastercard | |
mastercard_ | Mastercard (débit) | |
mastercard_ | Mastercard (prépayée) | |
amex | American Express | |
amex2 | American Express | |
discover | Discover | |
discover2 | Discover | |
diners | Diners Club | |
diners_ | Diners Club (carte à 14 chiffres) | |
jcb | JCB | |
unionpay | UnionPay | |
interac | Interac | |
eftpos_ | eftpos Australie | |
eftpos_ | eftpos Australia/Visa | |
eftpos_ | eftpos Australia/Mastercard |
Cartes bancaires de test réservées à des cas de réussite particuliers
Numéro de carte bancaire de test | Moyen de paiement de test | Résultat |
---|---|---|
offline_ | Simule la demande émise au titulaire de la carte et sa saisie d’un code PIN hors ligne. La cardholder_verification_method du paiement qui en résulte est définie sur offline_ . | |
offline_ | Simule un flux de relance déclenché par la SCA dans lequel le paiement sans contact initial d’un titulaire de carte échoue : le lecteur invite alors l’utilisateur à insérer sa carte et à saisir son code PIN hors ligne. La cardholder_verification_method du paiement qui en résulte est défini sur offline_ . | |
online_ | Simule la demande et la saisie par un titulaire de carte d’un code PIN en ligne. La cardholder_verification_method du paiement qui en résulte est définie sur online_ . | |
online_ | Simule un flux de relance déclenché par la SCA dans lequel le paiement sans contact initial d’un titulaire de carte échoue et le lecteur invite ensuite l’utilisateur à saisir son code PIN en ligne. La cardholder_verification_method du paiement final est définie sur online_ . |
Cartes bancaires de test réservées à des cas d’erreur particuliers
Remarque
L’utilisation de ces cartes pour enregistrer directement sans débiter et pour les SetupIntents renvoie une réponse setup_intent_authentication_failure.
Numéro de carte bancaire de test | Moyen de paiement de test | Résultat |
---|---|---|
charge_ | Le paiement est refusé avec le code card_ . | |
charge_ | Le paiement est refusé avec le code card_ . L’attribut decline_code est insufficient_ . | |
charge_ | Le paiement est refusé avec le code card_ . L’attribut decline_code est lost_ . | |
charge_ | Le paiement est refusé avec le code card_ . L’attribut decline_code est stolen_ . | |
charge_ | Le paiement est refusé avec le code expired_ . | |
charge_ | Le paiement est refusé avec le code processing_ . | |
refund_ | Le paiement réussit, mais le remboursement d’un paiement capturé échoue de manière asynchrone avec une valeur expired_ comme failure_ . Étant donné que les échecs de remboursement sont asynchrones, le remboursement semblera dans un premier temps avoir réussi. Il ne prendra l’état failed que lors des récupérations ultérieures. Nous vous informons également des échecs de remboursement à l’aide de l’événement de webhook refund. . Cette erreur simulée n’est prise en charge que dans le SDK JavaScript. |
Simulation de présentation de carte
Lorsque vous utilisez l’intégration pilotée par serveur, utilisez l’endpoint present_payment_method pour simuler la présentation ou l’insertion d’une carte dans le lecteur.
{ "id": "tmr_xxx", "object": "terminal.reader", "action": { "failure_code": null, "failure_message": null, "process_payment_intent": { "payment_intent": "pi_xxx" }, "status": "succeeded", "type": "process_payment_intent" }, … }
Si vous ne spécifiez pas les paramètres, le paiement simulé sera par défaut considéré comme effectué par une carte de test valide, en fonction du type de moyen de paiement du PaymentIntent. Les cartes de test par défaut pour les types de moyens de paiement Terminal sont :
Type de moyen de paiement | Numéro de carte bancaire de test | Moyen de paiement de test |
---|---|---|
card_ | visa | |
card_ et interac_ | visa | |
interac_ | interac |
Avec les cartes de test standard, vous pouvez également utiliser des montants de test pour simuler scénarios d’échec.
Mise à jour du lecteur de simulation
Pendant la connexion à un lecteur de simulation Bluetooth, vous pouvez configurer une mise à jour du lecteur.
Cartes bancaires de test physiques
Testez des paiements à l’aide de votre lecteur Stripe Terminal et d’une carte bancaire de test physique. Pour acheter des lecteurs et des cartes bancaires de test physiques, rendez-vous dans l’onglet Terminal du Dashboard Stripe.
Cette carte de test physique permet de payer par puce électronique et sans contact. Elle ne fonctionne qu’avec les lecteurs précertifiés de Stripe, et uniquement avec l’API Stripe dans un environnement de test. Si vous tentez d’utiliser votre carte bancaire de test physique en mode production, l’API Stripe renvoie une erreur. Sauf indication contraire, utilisez le code PIN 1234
au moment de l’invite.
Lorsque vous créez des paiements à l’aide d’une carte bancaire de test physique, utilisez les montants se terminant par les nombres suivants afin d’obtenir des réponses précises :
Décimale | Résultat |
---|---|
00 | Le paiement est approuvé. |
01 | Le paiement est refusé avec le code call_ . |
02 | Lorsque vous utilisez des lecteurs dotés d’un écran client, insérez (ou présentez, le cas échéant) la carte de test. Si la carte nécessite un code PIN, le paiement est refusé avec offline_ et demande la saisie du code PIN si le lecteur prend en charge la saisie de la puce. Saisissez 1234 pour exécuter le paiement test. |
03 | Lorsque vous utilisez des lecteurs dotés d’un écran client, insérez (ou présentez, le cas échéant) la carte de test. Si la carte nécessite la saisie du code PIN, le paiement est refusé avec online_ et demande la saisie du code PIN. Saisissez un code PIN à 4 chiffres afin d’effectuer le paiement. |
05 | Le paiement est refusé avec le code generic_ . |
55 | Le paiement est refusé avec le code incorrect_ . |
65 | Le paiement est refusé avec le code withdrawal_ . |
75 | Le paiement est refusé avec le code pin_ . |
Par exemple, un paiement d’un montant de 25,00 USD traité à l’aide d’une carte bancaire de test physique aboutit ; un paiement d’un montant de 10,05 USD est refusé.
Cartes bancaires de test Interac Canada uniquement
Pour tester votre intégration Interac, vous pouvez utiliser la simulation de carte de test interac
ou une carte de test Interac physique, que vous pouvez commander dans le magasin de lecteurs Terminal dans le Dashboard. Vous ne pouvez pas utiliser le test physique portant le logo de Stripe en tant que carte Interac.
La carte bancaire de test Interac fonctionne avec les paiements interac_
et les remboursements interac_
. Vous pouvez utiliser les mêmes montants test que ceux que vous utilisez pour tester des paiements card_
. Sauf indication contraire, utilisez le code PIN 1234
au moment de l’invite. Afin de tester un remboursement refusé, créez un remboursement partiel avec un montant se terminant par l’un des nombres suivants : 01
, 05
, 55
, 65
, ou 75
.
Remarque
La carte bancaire de test Interac ne prend pas en charge le paiement sans contact.
Cartes bancaires de test eftpos Australia only
Pour tester votre intégration eftpos, vous pouvez utiliser la simulation de carte eftpos
ou une carte de test eftpos physique, que vous pouvez commander dans le magasin de lecteurs Terminal dans le Dashboard. Vous ne pouvez pas utiliser la carte de test physique portant le logo de Stripe en tant que carte eftpos
.
Vous pouvez utiliser les mêmes montants de test que ceux que vous utilisez pour tester les paiements card_
. Sauf indication contraire, utilisez le code 1234
au moment de saisir le code PIN.