Passerelle Stripe Terminal
La passerelle Stripe Terminal vous permet d'accepter des paiements en personne en utilisant des lecteurs de matériel Stripe Terminal directement dans WCPOS. Cette passerelle prend en charge à la fois les lecteurs de cartes physiques et le mode simulateur pour les tests.
Caractéristiques
Intégration Matérielle
Connectez les lecteurs physiques Stripe Terminal via une connexion Internet
Mode Simulateur
Testez les 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 à la norme PCI via Stripe
Installation
Télécharger et Installer
- Visitez la page de versions de Stripe Terminal pour WooCommerce
- Téléchargez le fichier stripe-terminal-for-woocommerce.zip le plus récent
- Dans votre administration WordPress, allez à
Extensions > Ajouter > Téléverser une Extension - Téléversez le fichier zip et activez l'extension
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 de WooCommerce. Elle sera activée spécifiquement pour le POS à l'étape suivante.
Activer dans WCPOS
- Allez à
WP Admin > POS > Paramètres > Paiement - Trouvez la passerelle Stripe Terminal dans la liste
- Activez la passerelle pour une 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 :
- Choisissez 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 terminer la transaction
- Confirmation : La commande sera automatiquement terminée après paiement réussi
Tests avec le Simulateur
Le simulateur vous permet de tester diverses méthodes de paiement et scénarios :
- Paiements par Carte : Testez différents types de cartes (Visa, Mastercard, etc.)
- Paiements Sans Contact : Simulez des transactions de paiement sans contact
- Scénarios d'Erreur : Testez les paiements refusés et d'autres conditions d'erreur
- Différents Montants : Testez divers montants de transaction
Exigences
Compatibilité Matérielle
Cette mise en œuvre 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 actuellement pris en charge.
Terminaux Supportés (Connectés à Internet)
- Stripe Reader S700 ✅ - Terminal connecté par Ethernet/WiFi
- WisePOS E ✅ - Terminal connecté par WiFi
Terminaux Non Supportés (Bluetooth)
- BBPOS Chipper 2X BT ❌ - Bluetooth uniquement
- BBPOS WisePad 3 ❌ - Bluetooth uniquement
- Verifone P400 ❌ - Bluetooth uniquement
La prise en charge des terminaux Bluetooth sera ajoutée aux applications iOS et Android au T1 2026. Cela permettra de prendre en charge tous les lecteurs certifiés Stripe Terminal, y compris le M2 et le WisePad 3.
Problèmes Communs
Le lecteur ne se connecte pas
- Assurez-vous que vous utilisez un terminal connecté à Internet pris en charge (S700 ou WisePOS E)
- Vérifiez que le terminal est connecté à WiFi/Ethernet et en ligne
- Vérifiez que votre compte Stripe a 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
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 un support technique :
- Visitez le dépôt GitHub pour signaler des problèmes
- Consultez la documentation de Stripe Terminal 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 du POS avec sélection de Stripe Terminal
- Interface de test de simulateur avec diverses méthodes de paiement