Tester Stripe Terminal
Note
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.
Notez que la simulation de lecteur 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_debit | Visa (débit) | |
mastercard | Mastercard | |
mastercard_debit | Mastercard (débit) | |
mastercard_prepaid | Mastercard (prépayée) | |
amex | American Express | |
amex2 | American Express | |
discover | Discover | |
discover2 | Discover | |
diners | Diners Club | |
diners_14digits | Diners Club (carte à 14 chiffres) | |
jcb | JCB | |
unionpay | UnionPay | |
interac | Interac | |
eftpos_au_debit | eftpos Australie | |
eftpos_au_visa_debit | eftpos Australia/Visa | |
eftpos_au_mastercard_debit | 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_pin_cvm | Simule la demande et la saisie par le titulaire de carte d’un code PIN hors ligne. La cardholder_verification_method du paiement qui en résulte est définie sur offline_pin . | |
offline_pin_sca_retry | 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 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éfinie sur offline_pin . | |
online_pin_cvm | 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_pin . | |
online_pin_sca_retry | 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 alors l’utilisateur à saisir son code PIN en ligne. La cardholder_verification_method du paiement final est définie sur online_pin . |
Cartes bancaires de test réservées à des cas d’erreur particuliers
Numéro de carte bancaire de test | Moyen de paiement de test | Résultat |
---|---|---|
charge_declined | Le paiement est refusé avec le code card_declined . | |
charge_declined_insufficient_funds | Le paiement est refusé avec le code card_declined . L’attribut decline_code est insufficient_funds . | |
charge_declined_lost_card | Le paiement est refusé avec le code card_declined . L’attribut decline_code est lost_card . | |
charge_declined_stolen_card | Le paiement est refusé avec le code card_declined . L’attribut decline_code est stolen_card . | |
charge_declined_expired_card | Le paiement est refusé avec le code expired_card . | |
charge_declined_processing_error | Le paiement est refusé avec le code processing_error . | |
refund_fail | Le paiement aboutit, mais le remboursement d’un paiement capturé échoue de manière asynchrone avec l’attribut failure_reason expired_or_canceled_card . Étant donné que les échecs de remboursement sont asynchrones, le remboursement semblera dans un premier temps avoir abouti. Il n’aura l’état failed que lors des récupérations ultérieures. Nous vous informons par ailleurs des échecs de remboursement à l’aide de l’événement de webhook charge.refund.updated . Cette erreur simulée n’est prise en charge que dans le SDK JavaScript. |
Note
L’utilisation de ces cartes pour enregistrer directement sans débiter et pour les SetupIntents renvoie une réponse setup_intent_authentication_failure.
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 bancaire de test permet de payer par puce électronique et sans contact. Elle fonctionne uniquement avec des lecteurs précertifiés de Stripe, et uniquement en lien avec l’API Stripe en mode test. Si vous tentez d’utiliser votre carte bancaire de test physique en mode production, l’API Stripe renvoie une erreur. Sauf indication contraire, saisissez 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_issuer . |
02 | Si vous utilisez des lecteurs dotés d’un écran visible du titulaire de la carte, insérez la carte de test (vous pouvez également utiliser le paiement sans contact si vous vous trouvez hors des États-Unis) et suivez les instructions à l’écran pour finaliser la transaction. Si un code PIN est requis, saisissez 1234 . Le paiement peut être refusé avec un code offline_pin_required si la carte nécessite un code PIN et que le lecteur n’a pas d’écran visible du titulaire de la carte. |
03 | Si vous utilisez des lecteurs dotés d’un écran visible du titulaire de la carte, insérez la carte de test (vous pouvez également utiliser le paiement sans contact si vous vous trouvez hors des États-Unis) et suivez les instructions à l’écran pour finaliser la transaction. Si un code PIN est requis, saisissez le code PIN à 4 chiffres de votre choix. Le paiement peut être refusé avec un code online_or_offline_pin_required si la carte nécessite un code PIN et que le lecteur n’a pas d’écran visible du titulaire de la carte. |
05 | Le paiement est refusé avec le code generic_decline . |
55 | Le paiement est refusé avec le code incorrect_pin . |
60 | Le paiement est refusé avec un code online_or_offline_pin_required . |
65 | Le paiement est refusé avec le code withdrawal_count_limit_exceeded . |
75 | Le paiement est refusé avec le code pin_try_exceeded . |
Par exemple, un paiement d’un montant de 25,00 $ traité à l’aide d’une carte bancaire de test physique aboutit ; un paiement d’un montant de 10,05 $ 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 situé dans le Dashboard. La carte de test physique de marque Stripe ne peut pas être utilisée en tant que carte Interac.
La carte bancaire de test Interac fonctionne avec les paiements interac_present
et les remboursements interac_present
. Vous pouvez utiliser les mêmes montants test que ceux que vous utilisez pour tester des paiements card_present
. 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
.
Note
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 de test eftpos
ou une carte de test eftpos physique, que vous pouvez commander dans le magasin de lecteurs Terminal dans le Dashboard. La carte de test physique portant le logo de Stripe ne peut être utilisée en tant que carte eftpos
.
Vous pouvez utiliser les mêmes montants de test que ceux que vous utilisez pour tester les paiements card_present
. Sauf indication contraire, utilisez le code 1234
au moment de saisir le code PIN.
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_present | visa | |
card_present et interac_present | visa | |
interac_present | 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.