Passerelle de paiement Stripe Terminal
Stripe Terminal vous permet d’utiliser un lecteur de cartes Stripe en caisse. La caisse envoie le montant au lecteur, le client présente sa carte sans contact, l’insère ou la fait glisser, et la vente se termine une fois que Stripe a capturé le paiement et qu’il ne reste plus rien à payer. Cette page vous guide pour effectuer la configuration initiale, connecter un lecteur à chaque caisse et encaisser le premier paiement.
La configuration est déjà faite ? Connectez un lecteur à cette caisse ou encaissez un paiement.
Stripe Terminal nécessite WCPOS Pro 2.0.0 ou une version ultérieure. Sans cela, l’extension ne fonctionne pas.
Choisir vos lecteurs
Stripe vend trois types de lecteurs. Le type utilisable sur une caisse dépend de l’appareil sur lequel le PDV fonctionne.
- Lecteur intelligent — fonctionne sur toutes les caisses : navigateur, application de bureau, iPhone, iPad et Android. Stripe Reader S700 et S710, BBPOS WisePOS E. Il est connecté à votre réseau et votre boutique lui envoie le paiement.
- Lecteur Bluetooth — uniquement dans les applications iOS et Android. Stripe Reader M2, BBPOS WisePad 3. Il s’appaire avec le téléphone ou la tablette.
- Tap to Pay — sera disponible dans les applications iOS et Android lors d’une mise à jour. Aucun lecteur nécessaire : le client présente sa carte directement sur le téléphone.
Un navigateur ou l’application de bureau ne peut pas accéder à un lecteur Bluetooth ni à la puce sans contact d’un téléphone : ces caisses utilisent donc un lecteur intelligent. Achetez vos lecteurs dans la boutique Terminal de votre tableau de bord Stripe.
Stripe vend le Stripe Reader M2 aux États-Unis et le BBPOS WisePad 3 dans les autres pays, notamment au Royaume-Uni, en Europe, au Canada et en Australie. Consultez la boutique Terminal pour trouver le modèle disponible dans votre pays.
Configurer la passerelle de paiement
Un administrateur effectue cette configuration une seule fois par boutique, dans WP Admin.
- Installez l’extension. Téléchargez l’archive zip de l’extension,
stripe-terminal-for-woocommerce.zip, parmi les fichiers de la version publiée sur GitHub, puis téléversez-la viaExtensions > Add Plugin, puis Téléverser une extension. L’archive zip « Source code » de GitHub ne peut pas être installée. - Ajoutez vos clés. Accédez à
WP Admin > WooCommerce > Réglages > Paiements, ouvrez Stripe Terminal et collez votre Clé secrète de production, ainsi que la Clé secrète de test si vous souhaitez d’abord faire un essai. Toutes deux se trouvent dans votre tableau de bord Stripe. Une fois enregistrée, une clé s’affiche sous forme de points avec la mention (enregistrée ; laissez vide pour la conserver). - Choisissez un emplacement Terminal pour les lecteurs Bluetooth et Tap to Pay. Créez-en un en mode test et un en mode production dans le tableau de bord Stripe, sous Terminal → Emplacements, puis sélectionnez-les dans Emplacement Terminal (test) et Emplacement Terminal (production).
- Cochez les lecteurs autorisés dans cette boutique sous Connexions PDV : Lecteurs intelligents, Lecteurs Bluetooth et Tap to Pay, ou les deux. Pour utiliser les lecteurs Bluetooth ou Tap to Pay dans les applications, cochez Lecteurs Bluetooth et Tap to Pay et décochez Lecteurs intelligents. Consultez Lecteurs intelligents, Bluetooth ou les deux.
- Enregistrez les réglages, puis vérifiez que la ligne du webhook située en dessous affiche Secret de signature enregistré.
- Activez la passerelle pour le PDV. Accédez à
WP Admin > POS > Réglages > Validation de la commande, activez Stripe Terminal et enregistrez. Vous n’avez pas besoin de l’activer dans la liste des moyens de paiement de WooCommerce ; consultez Réglages de la caisse.
Sans emplacement, un lecteur Bluetooth ou Tap to Pay ne peut pas se connecter et la caisse affiche Sélectionnez un emplacement Terminal dans les réglages de Stripe Terminal avant de connecter un lecteur mobile.
Tous les réglages de la page de la passerelle de paiement
- Titre et Description — le nom et le texte que voient les clients. La caisse affiche le titre sur la tuile.
- Clé secrète de production et Clé secrète de test — disponibles dans le tableau de bord Stripe.
- Terminal par défaut — le lecteur intelligent utilisé par une caisse pour encaisser les paiements jusqu’à ce qu’un autre soit sélectionné.
- Terminaux activés — limite les caisses aux lecteurs intelligents que vous sélectionnez. Laissez ce champ vide pour autoriser tous les lecteurs du compte.
- Verrouiller la sélection du terminal — Les caissiers ne peuvent pas changer de terminal lors du paiement dans le PDV. Nécessite un Terminal par défaut.
- Connexions PDV — les types de lecteurs que les caisses peuvent utiliser : Lecteurs intelligents (la boutique pilote le lecteur via le réseau) et Lecteurs Bluetooth et Tap to Pay (l’application PDV pilote le lecteur). Consultez Lecteurs intelligents, Bluetooth ou les deux.
- Emplacement Terminal (test) et Emplacement Terminal (production) — les emplacements où les lecteurs Bluetooth et Tap to Pay sont enregistrés lorsque l’application les connecte.
- Mode test — Activer le mode test. Un site sans HTTPS reste en mode test : Stripe Terminal nécessite HTTPS pour les paiements réels.
- Commandes par téléphone (MOTO) — Activez les paiements par téléphone via Stripe Terminal. Consultez Commandes par téléphone (MOTO).
- Maintenir le lecteur actif (expérimental) — envoie des signaux au lecteur pour éviter que le premier paiement après une période d’inactivité soit lent. Déconseillé lorsque plusieurs caisses partagent un lecteur.
Sous les champs, la page affiche vos Emplacements Stripe Terminal et la ligne du webhook.
Lecteurs intelligents, Bluetooth ou les deux
Connexions PDV est un réglage de la boutique : il détermine le type de lecteur utilisé par chaque caisse.
- Lecteurs intelligents uniquement : chaque caisse encaisse avec un lecteur intelligent.
- Lecteurs Bluetooth et Tap to Pay uniquement : les applications iOS et Android encaissent avec un lecteur Bluetooth ou le téléphone. Sur une caisse dans un navigateur ou dans l’application de bureau, la tuile Stripe est repliée sous … indisponible pour le moment, avec le texte Seuls les lecteurs de l’application sont autorisés pour ce moyen de paiement. Autorisez les lecteurs intelligents sur sa page de réglages WooCommerce pour encaisser depuis cette caisse.
- Les deux : les caisses utilisent les lecteurs intelligents. Les lecteurs Bluetooth et Tap to Pay restent inutilisés tant que vous ne décochez pas Lecteurs intelligents.
Changer de type de lecteur ou mettre à niveau
Décocher un type de lecteur ne change que le lecteur utilisé pour les prochains paiements. Chaque remboursement passe par la connexion utilisée pour encaisser le paiement, lecteur intelligent ou application, et le webhook Stripe continue de fonctionner. Une mise à niveau depuis une ancienne version conserve la connexion enregistrée, ou les lecteurs intelligents si seul un Terminal par défaut était enregistré. Lors d’une nouvelle installation, les deux options sont cochées : les applications utilisent donc les lecteurs intelligents tant que vous ne décochez pas Lecteurs intelligents.
Connecter un lecteur à cette caisse
Chaque caisse conserve son propre lecteur. Dans le PDV, appuyez sur Réglages en bas du menu latéral, puis sur Lecteurs de cartes.

- Aucun lecteur de cartes n’est configuré pour cette boutique — le message affiché tant que la passerelle n’est pas configurée avec un type de lecteur utilisable par cette caisse. Une fois la configuration effectuée, les sections ci-dessous correspondant aux lecteurs utilisables par cette caisse s’affichent à la place (sur une caisse dans un navigateur ou dans l’application de bureau, uniquement Lecteurs intelligents).
Lecteurs intelligents
Enregistrez chaque lecteur intelligent dans le tableau de bord Stripe à l’aide du code affiché sur le lecteur. Tant que ce n’est pas fait, il n’apparaît ni sous Terminal par défaut, ni sous Terminaux activés, ni sur la caisse.
La section Lecteurs intelligents comporte une ligne par lecteur autorisé par la boutique : le nom du lecteur avec celui de la passerelle à côté, l’emplacement Terminal en dessous, et En ligne ou Hors ligne. La caisse encaisse avec le lecteur dont la ligne porte la mention Sélectionné. Pour en changer, appuyez sur Utiliser ce lecteur sur un autre lecteur en ligne ; les paiements passent alors par celui-ci.
Quel lecteur est utilisé automatiquement ?
- Aucun lecteur sélectionné pour le moment : la caisse utilise le Terminal par défaut tant qu’il est en ligne et disponible.
- Un seul lecteur intelligent dans la boutique : aucun choix n’est nécessaire. Tant qu’il est en ligne et qu’il n’est pas occupé par une autre vente, la caisse l’utilise pour encaisser.
- Imposé par la boutique : le Terminal par défaut lorsque Verrouiller la sélection du terminal est activé. Tant qu’il est en ligne, il porte la mention Sélectionné sur toutes les caisses et aucune ligne ne propose Utiliser ce lecteur.
Lecteurs Bluetooth
Dans l’application iOS ou Android :
- Allumez le lecteur et gardez-le à proximité du téléphone ou de la tablette.
- Dans Réglages → Lecteurs de cartes, appuyez sur Connecter un lecteur. Si la boutique dispose de plusieurs passerelles pour lecteurs, vous devez en choisir une : Connecter un lecteur avec, puis Stripe Terminal.
- La ligne affiche Recherche de lecteurs… Allumez le lecteur et gardez-le à proximité de cet appareil., puis 1 lecteur trouvé. Est-ce le vôtre ? ou 3 lecteurs trouvés. Lequel est le vôtre ? Appuyez sur Connecter à côté du vôtre.
- La première connexion installe une mise à jour du logiciel du lecteur. La ligne affiche Installation du logiciel du lecteur avec une barre de progression et Gardez le lecteur allumé et chargé. La première mise à jour prend environ 10 minutes. Chargez le lecteur à plus de la moitié avant de commencer et restez sur cet écran.
- La ligne affiche Connecté, avec le niveau de batterie du lecteur, par exemple Connecté · 80%.
Les connexions suivantes prennent quelques secondes et la caisse se reconnecte au même lecteur lors de la vente suivante. Tant qu’aucun lecteur n’est connecté, la section Lecteurs Bluetooth affiche Aucun lecteur connecté pour le moment. Allumez le lecteur et gardez-le à proximité de ce téléphone.
Tap to Pay
Tap to Pay sera disponible dans les applications iOS et Android lors d’une mise à jour ; voici comment il fonctionnera une fois disponible dans votre application. Sur un téléphone équipé de l’application iOS ou Android, la section Ce téléphone comporte une ligne Tap to Pay sur iPhone ou Tap to Pay sur Android. Un gestionnaire de boutique ou un administrateur appuie sur Configurer Tap to Pay. Les autres utilisateurs voient Non configuré · contactez un administrateur.
La première fois, le téléphone vous demande d’accepter les conditions du fournisseur : sur un iPhone, Apple vous demande d’associer un identifiant Apple et d’accepter ses conditions Tap to Pay. Une fois la configuration effectuée, la ligne affiche Prêt. Tap to Pay nécessite une connexion pour encaisser un paiement.
Les messages possibles sur la ligne d’un lecteur
Chaque ligne affiche le nom du lecteur, son numéro de série, l’emplacement Terminal et une ligne d’état :
- Connecté · 80% — prêt à encaisser des paiements, avec le niveau de batterie restant. Tap to Pay affiche Prêt.
- Non connecté — la caisse a mémorisé ce lecteur, mais n’y est pas connectée actuellement. Appuyez sur Connecter.
- Connexion à … — patientez. Le bouton affiche Connexion….
- Installation du logiciel du lecteur — la mise à jour ; consultez Lecteurs Bluetooth, étape 4.
- Aucun lecteur trouvé. Allumez le lecteur et réessayez. — appuyez sur Réessayer, ou sur Votre lecteur n’apparaît pas ? pour consulter le guide du lecteur.
- Connexion impossible : … — le motif indiqué par Stripe suit ce message. Appuyez sur Réessayer ou sur Aide.
- Activez le Bluetooth pour connecter un lecteur. — le Bluetooth est désactivé sur cet appareil.
- Autorisez l’accès au lecteur dans les réglages de l’application. — l’application n’a pas l’autorisation d’utiliser le Bluetooth. Accordez-la dans les réglages du téléphone.
Le menu ⋮ à côté d’une ligne propose Oublier : la caisse ne se reconnectera plus à ce lecteur lors de la vente suivante. Vous pouvez le reconnecter depuis cette page. Déconnecter, le bouton sur la ligne d’un lecteur connecté, libère le lecteur pour le moment. Si un lecteur reste bloqué par l’application, le menu propose aussi Libérer le lecteur.
Tester avant de passer en production
Cochez Mode test sur la page de réglages de la passerelle (WP Admin > WooCommerce > Réglages > Paiements > Stripe Terminal) et enregistrez. Les paiements sont alors envoyés au compte de test Stripe et aucun argent n’est transféré. Effectuez une vente de test en suivant les étapes de la section Encaisser un paiement.
- Lecteurs intelligents : un lecteur simulé enregistré sur votre compte de test Stripe apparaît aux côtés de vos lecteurs réels, ce qui vous permet d’effectuer une vente sans matériel.
- Lecteurs Bluetooth et lecteurs intelligents réels : payez avec la carte de test physique Stripe, à commander dans la boutique Terminal de votre tableau de bord Stripe. Les deux derniers chiffres du montant déterminent le résultat :
.00approuve le paiement,.05le refuse et.02demande le code PIN1234.
Lorsque vous avez terminé, décochez Mode test et enregistrez avant d’encaisser un paiement réel.
Encaisser un paiement
Lorsque Ouvrir et fermer la caisse est activé, la caisse n’enregistre aucun paiement tant qu’elle est fermée, et un paiement par carte déjà encaissé devrait être remboursé. Consultez Ouvrir la caisse.
-
Constituez le panier et appuyez sur Paiement.
-
Appuyez sur la tuile Stripe Terminal dans le volet des moyens de paiement.
-
Vérifiez le lecteur. Pour un lecteur intelligent, le volet affiche Terminal : …, avec Changer pour en choisir un autre si la boutique l’autorise. Pour un lecteur Bluetooth, il affiche Connecté · 80%, ou Aucun lecteur connecté avec un lien vers Réglages → Lecteurs de cartes.
-
Appuyez sur Envoyer … à Stripe Terminal, puis laissez le client payer :
- Lecteur intelligent : la caisse affiche En attente du client sur le terminal pendant que le client présente sa carte sans contact, l’insère ou la fait glisser sur le lecteur.
- Lecteur Bluetooth : la caisse affiche Présentez la carte sur le lecteur.
- Tap to Pay : le téléphone affiche son propre écran Tap to Pay et le client présente sa carte ou son téléphone sur le vôtre.
La caisse coche successivement Envoyé, Sur le terminal, Approuvé et Capturé.
-
Lorsqu’il ne reste plus rien à payer, l’écran du reçu s’ouvre : imprimez le reçu ou envoyez-le par e-mail, puis appuyez sur Nouvelle vente. Consultez Vérifier que le paiement est terminé. S’il reste une partie du total à régler, encaissez le solde avec un autre moyen de paiement ; consultez Paiements fractionnés.
Pour arrêter, appuyez sur Annuler sur le terminal. Si la carte est refusée, le message Échec du paiement : … s’affiche avec Réessayer et Choisir un autre moyen. Consultez Sur un lecteur de cartes.
La tuile ne permet pas de saisir une carte. Pour une commande par téléphone, consultez Commandes par téléphone (MOTO).
Les pourboires ajoutés par les clients sur le lecteur sont ajoutés à la commande sous forme de frais Pourboire. Les WisePad 3, WisePOS E, S700 et S710 peuvent proposer un pourboire ; le M2 ne le peut pas. Activez les pourboires pour vos lecteurs dans le tableau de bord Stripe.
Commandes par téléphone (MOTO)
MOTO (commande par courrier ou par téléphone) permet d’encaisser le paiement par carte d’un client absent : saisissez le numéro de carte, sa date d’expiration et son code de sécurité sur l’écran du lecteur au lieu de présenter une carte. Les commandes par téléphone sont traitées uniquement dans l’onglet Classique de la caisse, dans le panneau propre à Stripe. La tuile Stripe Terminal de l’onglet Paiements ne permet pas de saisir les coordonnées d’une carte.
L’interrupteur Commande par téléphone ne s’affiche que lorsque les trois conditions suivantes sont remplies :
- Stripe active MOTO pour votre compte. Cette fonctionnalité n’est pas activée par défaut : contactez l’assistance Stripe.
- Cochez Commandes par téléphone (MOTO). Accédez à
WP Admin > WooCommerce > Réglages > Paiements > Stripe Terminal, cochez Commandes par téléphone (MOTO) et enregistrez. - Utilisez un lecteur intelligent S700, S710 ou WisePOS E. L’interrupteur s’affiche dès que l’un de ces lecteurs est connecté dans le panneau Stripe. Il ne s’affiche jamais pour un P400, un M2, un WisePad 3, Tap to Pay ou un lecteur simulé.
Lorsque Commandes par téléphone (MOTO) est coché, le panneau propre à Stripe remplace le panneau habituel pour tous les paiements Stripe Terminal dans l’onglet Classique, et pas uniquement pour les commandes par téléphone. Si l’option est décochée, l’onglet Classique affiche un sélecteur Terminal avec Envoyer au terminal, Annuler et Réessayer ; le paiement est enregistré comme s’il provenait du volet d’encaissement.
Pour accepter une commande par téléphone :

- Classique — l’onglet qui affiche la page de paiement propre à la boutique dans la caisse.
- La page de paiement de la boutique — choisissez Stripe Terminal ici, puis faites défiler jusqu’à Lecteurs disponibles, Connecter et Commande par téléphone.
- Traiter le paiement — le bouton de la caisse sous la page, comme pour tout paiement dans l’onglet Classique. Une commande par téléphone démarre avec Payer avec le terminal sur la page.
- Appuyez sur Paiement, ouvrez l’onglet Classique et choisissez Stripe Terminal.
- Sous Lecteurs disponibles, appuyez sur Connecter pour votre lecteur.
- Activez Commande par téléphone.
- Appuyez sur Payer avec le terminal. Le lecteur affiche un écran de saisie des données de la carte au lieu de demander de présenter une carte sans contact.
- Saisissez le numéro de carte, la date d’expiration et le code de sécurité sur le lecteur.
Stripe traite une commande par téléphone comme un paiement sans présentation de carte : la tarification des paiements par carte en personne et le transfert de responsabilité en cas de fraude associé ne s’appliquent donc pas.
En cas de problème
Le lecteur ne se connecte pas. Un lecteur intelligent doit être connecté en Wi-Fi ou par Ethernet, être en ligne dans votre tableau de bord Stripe et y être enregistré. Un lecteur Bluetooth nécessite l’application iOS ou Android, le Bluetooth activé et l’autorisation pour l’application d’utiliser le Bluetooth.
« Sélectionnez un emplacement Terminal… ». La passerelle n’a pas d’emplacement Terminal pour le mode utilisé, test ou production. Consultez Configurer la passerelle de paiement, étape 3.
La première connexion prend beaucoup de temps. Il s’agit de la mise à jour du logiciel du lecteur, qui dure environ 10 minutes. Gardez le lecteur allumé et chargé, et restez sur cet écran. La connexion suivante ne prend que quelques secondes.
La tuile Stripe indique que le moyen de paiement est indisponible. Sur une caisse dans un navigateur ou dans l’application de bureau, la boutique n’autorise que les lecteurs de l’application. Consultez Lecteurs intelligents, Bluetooth ou les deux. Hors ligne, les lecteurs de cartes attendent le rétablissement de la connexion ; consultez Mode hors ligne.
Lecteurs de cartes affiche Seuls les lecteurs de l’application sont autorisés pour cette boutique. La cause est la même, sur une caisse dans un navigateur ou dans l’application de bureau : autorisez Lecteurs intelligents sous Connexions PDV, ou utilisez l’application iOS ou Android. Consultez Lecteurs intelligents, Bluetooth ou les deux.
La carte est refusée. Demandez une autre carte ou un autre moyen de paiement. En mode test, vérifiez les deux derniers chiffres du montant.
L’interrupteur Commande par téléphone n’apparaît pas. Les commandes par téléphone sont traitées uniquement dans l’onglet Classique, pas sur la tuile Stripe Terminal. Vérifiez que Commandes par téléphone (MOTO) est coché, qu’un lecteur S700, S710 ou WisePOS E est connecté et qu’il ne s’agit pas d’un lecteur simulé.
Une commande par téléphone échoue. Stripe n’a pas encore activé MOTO sur votre compte, ou les données de la carte ont été mal saisies.
Le problème persiste ? Signalez un bug sur GitHub, consultez la documentation Stripe Terminal pour le lecteur, ou contactez l’assistance Stripe au sujet de votre compte.