# 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 en personne classiques, nous recommandons le [Stripe Reader S700/S710](https://docs.stripe.com/terminal/payments/setup-reader/stripe-reader-s700-s710.md) avec une [intégration gérée par serveur](https://docs.stripe.com/terminal/payments/setup-integration.md?terminal-sdk-platform=server-driven). 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/S710 - (Optional) Une carte bancaire de test pour vos essais ![Architecture intelligente d’intégration des lecteurs](https://b.stripecdn.com/docs-statics-srv/assets/smart-reader-architecture.9adb3e895895b6513b9188ed74a9315e.png) ## Créer un compte Stripe Avant d’intégrer Stripe, vous devez créer un compte Stripe. 1. [Créez un compte](https://dashboard.stripe.com/register) en saisissant votre adresse e-mail, votre nom complet, votre pays et en créant un mot de passe. 1. Renseignez le profil de votre entreprise. 1. Dans le Dashboard, cliquez sur **Vérifier votre e-mail**. Stripe envoie un e-mail de vérification à votre adresse e-mail. 1. Vérifiez votre adresse e-mail. Après avoir créé votre compte, récupérez vos [API keys](https://docs.stripe.com/keys.md) dans le Dashboard Stripe, sous **Développeurs** > [API Keys](https://dashboard.stripe.com/apikeys). 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](https://docs.stripe.com/get-started/use-cases/in-person-payments.md#testing) pour tester votre intégration. 1. dans le Dashboard, allez dans **terminal** > [aperçu](https://dashboard.stripe.com/terminal). 1. Dans la section Commandes de matériel, cliquez sur **Acheter**. 1. Sélectionnez **Je souhaite créer une nouvelle intégration à l’aide des API Stripe** et cliquez sur **Continuer**. 1. Sélectionnez **Stripe Reader S700** ou **Stripe Reader S710** et ajoutez-le à votre panier. 1. 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](https://docs.stripe.com/terminal/payments/setup-reader/stripe-reader-s700-s710.md#connect-the-reader-to-the-internet) via Ethernet (station requise) ou WiFi. Assurez-vous de respecter les [exigences de connectivité](https://docs.stripe.com/terminal/network-requirements.md#smart-readers). ### Enregistrez votre lecteur Après avoir trouvé le numéro de série, enregistrez le lecteur dans le Dashboard. 1. dans le Dashboard, accédez à l’icône [commandes de matériel](https://dashboard.stripe.com/terminal/hardware_orders) et sélectionnez votre lecteur pour trouver le numéro de série du lecteur. 1. Sur le [Lecteurs](https://dashboard.stripe.com/terminal/readers), cliquez sur **Enregistrer le lecteur**. 1. 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. 1. Vous pouvez facultativement choisir un nom pour le lecteur. 1. Si vous avez déjà créé un emplacement, sélectionnez le nouvel emplacement du lecteur. Sinon, créez un [location](https://docs.stripe.com/terminal/fleet/locations-and-zones.md) représentant votre emplacement d’exploitation physique en cliquant sur **+ Ajouter**. 1. 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](https://docs.stripe.com/api/terminal/readers/list.md?api-version=2025-09-30.preview&rds=1) puis en filtrant par emplacement ou par numéro de série. Ainsi, vous pourrez 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](https://docs.stripe.com/api/payment_intents.md?api-version=2025-09-30.preview&rds=1), un objet représentant une seule session de paiement. 1. [Créer un PaymentIntent](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=server-driven#create-payment). Vous pouvez définir si vous souhaitez [automatiquement](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-capture_method) ou [manuellement](https://docs.stripe.com/payments/place-a-hold-on-a-payment-method.md) capturer vos paiements. ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d currency=usd \ -d "payment_method_types[]=card_present" \ -d capture_method=manual \ -d amount=1000 ``` 1. [Traitez le paiement](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=server-driven#process-payment). L’autorisation sur la carte bancaire du client a lieu lorsque le lecteur traite le paiement. ```curl curl https://api.stripe.com/v1/terminal/readers/tmr_xxx/process_payment_intent \ -u "<>:" \ -d payment_intent=pi_xxx ``` 1. [Confirmez que le paiement a été collecté et autorisé](https://docs.stripe.com/webhooks.md) en inspectant les événements webhook`terminal.reader.action_succeeded` et`terminal.reader.action_failed`. 1. (Facultatif) [Capturer la PaymentIntent](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=server-driven#capture-payment). ```curl curl -X POST https://api.stripe.com/v1/payment_intents/pi_xxx/capture \ -u "<>:" ``` ## 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](https://dashboard.stripe.com/terminal/shop). Nous prenons également en charge les cartes de test physiques de fournisseurs tels que [B2](https://b2ps.com/product-category/b2-payment-testing-products/). 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](https://docs.stripe.com/sandboxes.md). 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_issuer`. | | **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_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. | | **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_or_offline_pin_required` 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_decline`. | | **55** | Le paiement est refusé avec le code `incorrect_pin`. | | **65** | Le paiement est refusé avec le code `withdrawal_count_limit_exceeded`. | | **75** | Le 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é. > Certaines devises ont [zéro décimale](https://docs.stripe.com/currencies.md#zero-decimal). Pour ces devises, utilisez les deux chiffres décimaux du tableau ci-dessus comme les deux chiffres les plus à droite. > > Par exemple, pour que votre paiement soit refusé avec le code `generic_decline`, vous avez besoin d’un montant de *105 JPY*. ### 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](https://dashboard.stripe.com/terminal/shop) 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_present` et les remboursements `interac_present`. Vous pouvez utiliser les mêmes [montants test](https://docs.stripe.com/terminal/references/testing.md#physical-test-cards) 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`. > 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](https://dashboard.stripe.com/terminal/shop) 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](https://docs.stripe.com/terminal/references/testing.md#physical-test-cards) 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. ## Passer en mode production 1. Dans le Dashboard, ouvrez vos [paramètres du compte](https://dashboard.stripe.com/account/onboarding). 1. 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). 1. Ajoutez des coordonnées bancaires pour confirmer la destination de votre argent. 1. Configurez l’authentification à deux étapes pour sécuriser votre compte. 1. Vous pouvez également activer la collecte automatique des taxes ou les dons climatiques basés sur les revenus. 1. Vérifiez les informations saisies, puis cliquez sur **Accepter et envoyer**. 1. Après l’activation de votre profil, Stripe met à jour votre statut, passant du mode test au mode actif. En savoir plus sur la [configuration de votre compte Stripe](https://docs.stripe.com/get-started/account/set-up.md) Avant d’accepter de vrais paiements, vous devez également : 1. Créez un emplacement en mode production. 1. Réenregistrez votre lecteur avec l’emplacement en mode production. ## É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](https://docs.stripe.com/terminal/features/receipts.md) pour vos clients. - [Collectez des pourboires](https://docs.stripe.com/terminal/features/collecting-tips/overview.md) sur le lecteur ou sur un reçu.