Passerelle Stripe Terminal
La passerelle Stripe Terminal vous permet d'accepter des paiements en personne en utilisant des lecteurs matériels Stripe Terminal directement dans WCPOS. Cette passerelle prend en charge à la fois les lecteurs de cartes physiques et le mode simulateur pour les tests.
Fonctionnalités
Intégration Matérielle
Connectez des lecteurs physiques Stripe Terminal via une connexion Internet
Mode Simulateur
Testez des paiements sans matériel en utilisant le simulateur de Stripe
Traitement en Temps Réel
Traitement et confirmation instantanés des paiements
Transactions Sécurisées
Traitement des paiements conforme aux normes PCI via Stripe
Commandes Téléphoniques (MOTO)
Acceptez les paiements par carte au téléphone en saisissant les détails dans le lecteur
Installation
Télécharger et Installer
- Visitez la page des versions Stripe Terminal pour WooCommerce
- Téléchargez le fichier stripe-terminal-for-woocommerce.zip le plus récent
- Dans votre admin WordPress, allez à
Plugins > Ajouter Nouveau > Télécharger Plugin - Téléchargez le fichier zip et activez le plugin
Configurer les Paramètres Stripe
- Accédez à
WP Admin > WooCommerce > Paramètres > Paiements - Trouvez Stripe Terminal dans la liste des méthodes de paiement
- Cliquez sur Stripe Terminal pour accéder aux paramètres
- Entrez votre Clé Secrète Stripe (vous pouvez l'obtenir depuis votre tableau de bord Stripe)
- Enregistrez les paramètres
Vous n'avez pas besoin d'activer la passerelle Stripe Terminal dans les paramètres WooCommerce. Elle sera spécifiquement activée pour le POS à l'étape suivante.
Activer dans WCPOS
- Allez à
WP Admin > POS > Paramètres > Caisse - Trouvez la passerelle Stripe Terminal dans la liste
- Activez la passerelle pour utilisation dans le POS
- Enregistrez vos paramètres
Utilisation
Connexion d'un Lecteur
Lorsque vous sélectionnez la passerelle Stripe Terminal lors du paiement dans le POS :
- Choisir la Méthode de Connexion : Vous pouvez soit connecter un lecteur physique, soit utiliser le simulateur
- Lecteur Physique : Suivez les instructions à l'écran pour connecter votre appareil Stripe Terminal
- Simulateur : Sélectionnez le mode simulateur pour tester divers scénarios de paiement sans matériel
Traitement des Paiements
- Ajouter des Articles : Ajoutez des produits à votre panier dans le POS
- Sélectionner la Passerelle : Choisissez "Stripe Terminal" comme méthode de paiement
- Connecter le Lecteur : Connectez votre lecteur ou choisissez le mode simulateur
- Traiter le Paiement : Suivez les instructions pour compléter la transaction
- Confirmation : La commande sera automatiquement finalisée lors d'un paiement réussi
Test avec le Simulateur
Le simulateur vous permet de tester diverses méthodes et scénarios de paiement :
- Paiements par Carte : Testez différents types de cartes (Visa, Mastercard, etc.)
- Paiements sans contact : Simulez des transactions sans contact
- Scénarios d'Erreur : Testez les paiements refusés et d'autres conditions d'erreur
- Montants Différents : Testez divers montants de transaction
Commandes Téléphoniques (MOTO)
MOTO (Commande par correspondance/Commande par Téléphone) vous permet de traiter les paiements par carte pour des clients qui ne sont pas physiquement présents — par exemple, lors de la prise d'une commande par téléphone. Au lieu de taper ou d'insérer une carte, le marchand saisit les détails de la carte directement sur l'écran du lecteur terminal.
Configuration
Demander l'accès MOTO à Stripe
MOTO n'est pas activé par défaut. Contactez le support Stripe et demandez-leur d'activer les autorisations MOTO pour votre compte. C'est un processus rapide mais nécessite une approbation manuelle de Stripe.
Activer dans les paramètres du plugin
- Accédez à
WP Admin > WooCommerce > Paramètres > Paiements > Stripe Terminal - Cochez la case Commandes Téléphoniques (MOTO)
- Enregistrez les paramètres
Connecter un lecteur compatible
MOTO ne fonctionne qu'avec des lecteurs connectés à Internet compatibles répertoriés dans Terminaux pris en charge. Le commutateur n'apparaîtra pas pour d'autres types de lecteurs.
Prendre une Commande par Téléphone
- Connectez un lecteur compatible (voir Terminaux pris en charge)
- À l'écran de paiement, activez le commutateur Commande Téléphonique
- Cliquez sur Collecter le Paiement par Carte — le lecteur affichera un écran de saisie du numéro de carte au lieu de demander un paiement sans contact ou par insertion
- Saisissez le numéro de carte du client, la date d'expiration et le CVV sur le lecteur
- Le paiement se traite normalement à partir de là
Les paiements MOTO utilisent card comme type de méthode de paiement plutôt que card_present. Cela signifie qu'ils sont traités davantage comme des transactions en ligne du point de vue de Stripe, donc les frais de traitement de carte en ligne standard s'appliquent plutôt que les tarifs en personne.
Le commutateur Commande Téléphonique n'apparaît que lorsque les trois conditions suivantes sont remplies : le paramètre MOTO est activé dans les paramètres du plugin, un lecteur compatible est connecté et le lecteur n'est pas un simulateur. Si vous ne voyez pas le commutateur, vérifiez ces conditions.
Exigences
Compatibilité Matérielle
Cette implémentation utilise le SDK JavaScript de Stripe, ce qui signifie qu'elle fonctionne via des applications Web mais nécessite uniquement des terminaux connectés à Internet. Les terminaux Bluetooth ne sont pas pris en charge actuellement.
Terminaux pris en charge (Connectés à Internet)
- Lecteur Stripe S700/S710 ✅ - terminal connecté par Ethernet/WiFi
- WisePOS E ✅ - terminal connecté par WiFi
Terminaux Non Supportés (Bluetooth)
- BBPOS Chipper 2X BT ❌ - uniquement Bluetooth
- BBPOS WisePad 3 ❌ - uniquement Bluetooth
- Verifone P400 ❌ - obsolète, plus pris en charge par Stripe
La prise en charge des terminaux Bluetooth sera ajoutée aux applications iOS et Android dans une future mise à jour. Cela permettra la prise en charge de tous les lecteurs certifiés Stripe Terminal, y compris le M2 et le WisePad 3.
Problèmes Courants
Le lecteur ne se connecte pas
- Assurez-vous que vous utilisez un terminal connecté à Internet pris en charge
- Vérifiez que le terminal est connecté au WiFi/Ethernet et en ligne
- Vérifiez que votre compte Stripe a le Terminal activé
- Confirmez que le terminal est enregistré dans votre tableau de bord Stripe
Paiement refusé
- Vérifiez que votre compte Stripe est actif et en règle
- Vérifiez que la carte utilisée est valide
- Assurez-vous que des fonds suffisants sont disponibles
Le commutateur de commande par téléphone ne s'affiche pas
- Vérifiez que le paramètre Commandes Téléphoniques (MOTO) est activé dans
WooCommerce > Paramètres > Paiements > Stripe Terminal - Assurez-vous que vous êtes connecté à un lecteur compatible (voir Terminaux pris en charge) — le commutateur est caché pour d'autres types de lecteurs
- Le commutateur n'apparaît pas lors de l'utilisation du simulateur
Le paiement MOTO échoue avec une erreur
- Confirmez que Stripe a activé les autorisations MOTO sur votre compte — contactez le support Stripe si ce n'est pas déjà fait
- Vérifiez que les détails de la carte ont été saisis correctement sur le lecteur
- Les paiements MOTO peuvent avoir des vérifications de fraude plus strictes — assurez-vous que la carte est valide et dispose de fonds suffisants
Erreurs de certificat SSL
- Stripe Terminal nécessite HTTPS - assurez-vous que votre site dispose d'un certificat SSL valide
- Vérifiez que votre certificat SSL est correctement configuré
Obtenir de l'Aide
Pour une assistance technique :
- Visitez le dépôt GitHub pour signaler des problèmes
- Consultez la documentation des terminaux Stripe pour des conseils spécifiques au matériel
- Contactez le support Stripe pour des problèmes liés au compte
Captures d'Écran
Des captures d'écran seront ajoutées dans une mise à jour future pour montrer :
- Configuration de la passerelle dans les paramètres de paiement WooCommerce
- Interface de paiement POS avec sélection Stripe Terminal
- Interface de test du simulateur avec différentes méthodes de paiement