Accéder directement au contenu
Créez un compte
ou
connecter-vous
Logo de la documentation Stripe
/
Demander à l'assistant IA
Créez un compte
Connectez-vous
Démarrer
Paiements
Revenus
Plateformes et places de marché
Gestion de fonds
Ressources pour les développeurs
Aperçu
À propos des paiements Stripe
Mettre votre intégration à niveau
Analyses des paiements
Paiements en ligne
PrésentationTrouver votre cas d'usageManaged Payments
Utiliser Payment Links
Créer une page de paiement
Développer une intégration avancée
Développer une intégration dans l'application
Moyens de paiement
Ajouter des moyens de paiement
Gérer les moyens de paiement
Paiement accéléré avec Link
Interfaces de paiement
Payment Links
Checkout
Elements pour le web
Elements intégrés à l'application
Scénarios de paiement
Gérer plusieurs devises
Tunnels de paiement personnalisés
Acquisition flexible
Orchestration
Paiements par TPE
Terminal
    Présentation
    Accepter les paiements par TPE
    Conception d'intégration
    Choisir votre lecteur
    Concevoir une intégration
    Démarrage rapide
    Exemples d'applications
    Tests
    Configuration de Terminal
    Configurer votre intégration
    Se connecter à un lecteur
    Acceptation d'un paiement
    Encaisser des paiements par carte
    Autres moyens de paiement
    Accepter les paiements hors ligne
    Paiement des commande par courrier/par téléphone
    Spécificités régionales
    Lors du règlement
    Collecter des pourboires
    Collecter et enregistrer des informations de paiement pour une utilisation ultérieure
    Autorisations flexibles
    Après le paiement
    Rembourser des transactions
    Fournir des reçus
    Personnalisez Checkout
    Affichage du panier
    Collecter les données saisies à l'écran
    Collecter les données des lectures de la piste magnétique
    Collecter les données des paiements NFC sans contact
    Applications sur des appareils
    Gérer les lecteurs
    Commander, renvoyer ou remplacer des lecteurs
    Enregistrer des lecteurs
    Gérer les emplacements et les zones
    Configurer des lecteurs
    Suivre les lecteurs
    Chiffrement
    Références
    Documentation de l'API
    Lecteurs mobiles
    Lecteurs intelligents
    Guide de migration du SDK
    Liste de contrôle pour le déploiement
    Fiches produit du lecteur Stripe Terminal
Au-delà des paiements
Constituez votre entreprise
Cryptomonnaies
Financial Connections
Climate
AccueilPaiementsTerminal

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 :

  1. Avant de commander un lecteur, testez votre intégration avec le simulateur de lecteur.
  2. Testez l’intégralité de votre intégration matérielle à l’aide d’une carte bancaire de test physique.

Lecteur de simulation

Référence

  • discoverReaders (JavaScript)
  • DiscoveryConfiguration (iOS)
  • DiscoveryConfiguration (Android)
  • Détection des lecteurs

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

Référence

  • SimulatorConfiguration (iOS)
  • SimulatorConfiguration (Android)

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 testMoyen de paiement de testMarque
visaVisa
visa_debitVisa (débit)
mastercardMastercard
mastercard_debitMastercard (débit)
mastercard_prepaidMastercard (prépayée)
amexAmerican Express
amex2American Express
discoverDiscover
discover2Discover
dinersDiners Club
diners_14digitsDiners Club (carte à 14 chiffres)
jcbJCB
unionpayUnionPay
interacInterac
eftpos_au_debiteftpos Australie
eftpos_au_visa_debiteftpos Australia/Visa
eftpos_au_mastercard_debiteftpos Australia/Mastercard

Cartes bancaires de test réservées à des cas de réussite particuliers

Numéro de carte bancaire de testMoyen de paiement de testRésultat
offline_pin_cvmSimule 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_pin.
offline_pin_sca_retrySimule 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_pin.
online_pin_cvmSimule 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_retrySimule 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_pin.

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 testMoyen de paiement de testRésultat
charge_declinedLe paiement est refusé avec le code card_declined.
charge_declined_insufficient_fundsLe paiement est refusé avec le code card_declined. L’attribut decline_code est insufficient_funds.
charge_declined_lost_cardLe paiement est refusé avec le code card_declined. L’attribut decline_code est lost_card.
charge_declined_stolen_cardLe paiement est refusé avec le code card_declined. L’attribut decline_code est stolen_card.
charge_declined_expired_cardLe paiement est refusé avec le code expired_card.
charge_declined_processing_errorLe paiement est refusé avec le code processing_error.
refund_failLe paiement réussit, mais le remboursement d’un paiement capturé échoue de manière asynchrone avec une valeur expired_or_canceled_card comme failure_reason. É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.failed. 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.

Command Line
cURL
curl -X POST https://api.stripe.com/v1/test_helpers/terminal/readers/tmr_xxx/present_payment_method \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
{ "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 paiementNuméro de carte bancaire de testMoyen de paiement de test
card_presentvisa
card_present et interac_presentvisa
interac_presentinterac

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.

Définissez Terminal.shared.simulatorConfiguration.availableReaderUpdate sur l’une des configurations suivantes. L’appel de connectReader déclenche une mise à jour du lecteur de simulation.

Modifier la configurationRésultat
SimulateReaderUpdateNonePas de mise à jour, pas besoin de communiquer quoi que ce soit à votre utilisateur.
SimulateReaderUpdateRequiredUne mise à jour requise est disponible et prend 1 minute. Votre BluetoothReaderDelegate reçoit le rappel didStartInstallingUpdate.
SimulateReaderUpdateRequiredForOfflineUne mise à jour requise est en retard et vous prendra 1 minute. Si vous fonctionnez hors ligne, la connexion au lecteur n’est pas disponible. Votre BluetoothReaderDelegate recevra le rappel didStartInstallingUpdate.
SimulateReaderUpdateAvailableUne mise à jour facultative est disponible. Indiquez à l’utilisateur qu’une mise à jour est disponible et mettez en avant la daterequiredAt.
SimulateReaderUpdateLowBatteryL’installation d’une mise à jour requise démarre, puis échoue en raison du faible niveau de la batterie du lecteur. La connexion au lecteur échoue également. Cette situation simule le fait que le lecteur utilise une ancienne version du logiciel.
SimulateReaderUpdateLowBatterySucceedConnectL’installation d’une mise à jour requise démarre, puis échoue en raison du faible niveau de la batterie du lecteur. La connexion au lecteur réussit. Cette situation simule le fait que le lecteur utilise une version récente du logiciel qui est encore acceptable. L’installation de la mise à jour est relancée lors de la reconnexion au lecteur.
SimulateReaderUpdateRandomUne sélection aléatoire des scénarios ci-dessus.

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écimaleRésultat
00Le paiement est approuvé.
01Le paiement est refusé avec le code call_issuer.
02Lorsque 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_pin_required 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.
03Lorsque 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_or_offline_pin_required et demande la saisie du code PIN. Saisissez un code PIN à 4 chiffres afin d’effectuer le paiement.
05Le paiement est refusé avec le code generic_decline.
55Le paiement est refusé avec le code incorrect_pin.
65Le paiement est refusé avec le code withdrawal_count_limit_exceeded.
75Le paiement est refusé avec le code pin_try_exceeded.

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_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.

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_present. Sauf indication contraire, utilisez le code 1234 au moment de saisir le code PIN.

Voir aussi

  • Passer des commandes
  • Liste de vérification de l’intégration
Cette page vous a-t-elle été utile ?
OuiNon
Besoin d'aide ? Contactez le service Support.
Rejoignez notre programme d'accès anticipé.
Consultez notre log des modifications.
Des questions ? Contactez l'équipe commerciale.
LLM ? Lire llms.txt.
Propulsé par Markdoc