Accepter des paiements par TPE pour une entreprise en ligne
Découvrez comment accepter les paiements par carte pour votre entreprise en personne.
Ce guide explique comment configurer votre intégration Stripe pour accepter les paiements avec un système de point de vente (POS) en personne.
pour les paiements généraux en personne, nous vous recommandons lecteur Stripe s700 à l’aide d’un intégration pilotée par le serveur. les étapes de ce guide utilisent cette combinaison de lecteur et d’intégration.
Avant de commencer
Une intégration pilotée par serveur utilise l’API Stripe pour communiquer directement avec les lecteurs intelligents. Votre serveur back-end effectue des appels à l’API pour créer les paiements et contrôler le lecteur.
Pour intégrer, vous avez besoin de :
- Un compte Stripe
- Un serveur back-end capable d’envoyer des requêtes à l’API Stripe
- Un lecteur Stripe S700
- (Optional) Une carte bancaire de test pour vos essais

Créer un compte Stripe
Avant d’intégrer Stripe, vous devez créer un compte Stripe.
- Créez un compte en saisissant votre adresse e-mail, votre nom complet, votre pays et en créant un mot de passe.
- Renseignez le profil de votre entreprise.
- Dans le Dashboard, cliquez sur Vérifier votre e-mail. Un e-mail de vérification est envoyé à votre adresse e-mail.
- Vérifiez votre adresse e-mail.
Après avoir créé votre compte, récupérez vos API keys dans le Dashboard Stripe, sous Développeurs > API Keys. Vous avez besoin de votre clé API pour authentifier les requêtes envoyées depuis votre serveur back-end.
Commandez votre liseuse
commandez un lecteur de carte à partir du dashboard Stripe. vous pouvez également commander un carte de test physique pour tester votre intégration.
- dans le Dashboard, allez dans terminal > aperçu.
- Dans la section Commandes de matériel, cliquez sur Acheter.
- Sélectionnez Je souhaite créer une nouvelle intégration à l’aide des API Stripe et cliquez sur Continuer.
- Sélectionnez Stripe Reader S700 et ajoutez-le à votre panier.
- Sélectionnez votre panier, puis cliquez sur Payer pour finaliser votre commande.
Configurer votre lecteur.
Une fois votre lecteur de carte reçu, vous devez l’enregistrer à un emplacement. L’enregistrement à l’aide de son numéro de série vous permet d’utiliser le lecteur immédiatement après le déballage. Cette méthode permet aussi de le réenregistrer sans disposer physiquement du lecteur pour générer un code d’appairage.
Après avoir déballé votre lecteur, vous devez également connecter le lecteur à Internet via Ethernet (station requise) ou WiFi. Assurez-vous de respecter les exigences de connectivité.
Enregistrez votre lecteur
Après avoir trouvé le numéro de série, enregistrez le lecteur dans le Dashboard.
- dans le Dashboard, accédez à l’icône commandes de matériel et sélectionnez votre lecteur pour trouver le numéro de série du lecteur.
- Sur le Lecteurs, cliquez sur Enregistrer le lecteur.
- Entrez le numéro de série et cliquez sur Suivant. Pour enregistrer plusieurs appareils à la fois, vous pouvez saisir plusieurs numéros de série, séparés par des virgules.
- Vous pouvez facultativement choisir un nom pour le lecteur.
- Si vous avez déjà créé un emplacement, sélectionnez le nouvel emplacement du lecteur. Sinon, créez un location représentant votre emplacement d’exploitation physique en cliquant sur + Ajouter.
- Cliquez sur Enregistrer pour terminer l’enregistrement de votre lecteur.
Une fois votre lecteur enregistré, il est prêt à être utilisé avec l’intégration pilotée par serveur. Vous pourrez ensuite récupérer les IDs des lecteurs en utilisant l’endpoint list readers et en filtrant par emplacement ou par numéro de série, afin d’identifier le lecteur depuis lequel envoyer les transactions à votre point de vente.
Créer le flux de paiement
pour collecter des paiements avec Stripe terminal, vous devez créer un flux de paiement dans votre application. utilisez le sdk Stripe terminal pour créer et mettre à jour un intention de paiement, un objet représentant une seule session de paiement.
- Créer un PaymentIntent. Vous pouvez définir si vous souhaitez automatiquement ou manuellement capturer vos paiements.
- Traitez le paiement. L’autorisation sur la carte bancaire du client a lieu lorsque le lecteur traite le paiement.
- Confirmez que le paiement a été collecté et autorisé en inspectant les événements webhook
terminal.etreader. action_ succeeded terminal..reader. action_ failed - (Facultatif) Capturer la PaymentIntent.
Tester votre intégration
Cartes bancaires de test physiques
Testez les paiements avec votre lecteur Stripe Terminal à l’aide d’une carte de test physique. Vous pouvez acheter des lecteurs et des cartes de test physiques dans l’onglet Terminal du Dashboard Stripe. Nous prenons également en charge les cartes de test physiques de fournisseurs tels que B2.
Cette carte de test physique prend en charge à la fois la lecture par puce et le paiement sans contact. Elle fonctionne uniquement avec les lecteurs pré-certifiés de Stripe et uniquement avec l’API Stripe dans un environnement de test. Si vous essayez d’utiliser votre carte de test physique en mode actif, l’API Stripe renverra une erreur. Sauf indication contraire, utilisez le code PIN 1234 lorsqu’il est demandé.
Lors de la création de paiements avec une carte de test physique, utilisez des montants se terminant par les valeurs décimales suivantes pour générer des réponses spécifiques :
| Décimale | Résultat |
|---|---|
| 00 | Le paiement est approuvé. |
| 01 | Le paiement est refusé avec le code call_. |
| 02 | Lorsque 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_ 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. |
| 03 | Lorsque 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_ et demande la saisie du code PIN. Saisissez un code PIN à 4 chiffres afin d’effectuer le paiement. |
| 05 | Le paiement est refusé avec le code generic_. |
| 55 | Le paiement est refusé avec le code incorrect_. |
| 65 | Le paiement est refusé avec le code withdrawal_. |
| 75 | Le paiement est refusé avec le code pin_. |
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 carte de test simulée interac ou une carte de test physique interac. Vous pouvez la commander depuis la boutique de matériel terminal dans le Dashboard. vous ne pouvez pas utiliser la carte de test physique marquée Stripe comme carte Interac.
La carte bancaire de test Interac fonctionne avec les paiements interac_ et les remboursements interac_. Vous pouvez utiliser les mêmes montants test que ceux que vous utilisez pour tester des paiements card_. 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 carte de test eftpos simulée ou une carte physique eftpos. Vous pouvez la commander depuis la boutique de matériel Terminal dans le Dashboard. Vous ne pouvez pas utiliser la carte de test physique de la marque Stripe comme carte eftpos.
Vous pouvez utiliser les mêmes montants de test que ceux que vous utilisez pour tester les paiements card_. Sauf indication contraire, utilisez le code 1234 au moment de saisir le code PIN.
Passer en mode production
- Dans le Dashboard, ouvrez vos paramètres du compte.
- Saisissez le type d’entreprise, les informations fiscales, les détails de l’entreprise, les informations personnelles de vérification et les informations visibles par les clients (par exemple, un intitulé sur le relevé bancaire).
- Ajoutez vos coordonnées bancaires pour confirmer où vos fonds seront versés.
- Configurez l’authentification à deux étapes pour sécuriser votre compte.
- Vous pouvez également activer la collecte automatique des taxes ou les dons climatiques basés sur les revenus.
- Vérifiez les informations saisies, puis cliquez sur Accepter et envoyer.
- Après l’activation de votre profil, Stripe met à jour votre statut, passant du mode test au mode actif.
en savoir plus sur l’activation de votre compte Stripe.
Étapes suivantes
Après avoir configuré votre intégration, nous vous recommandons d’implémenter les fonctionnalités suivantes :
- Créez des reçus physiques ou numériques pour vos clients.
- Collectez des pourboires sur le lecteur ou sur un reçu.