Accéder directement au contenu
Créez un compte
ou
connecter-vous
Logo de la documentation Stripe
/
Demander à l'assistant IA
Créez un compte
Connectez-vous
Démarrer
Paiements
Revenus
Plateformes et places de marché
Gestion de fonds
Ressources pour les développeurs
Aperçu
À propos des paiements Stripe
Mettre votre intégration à niveau
Analyses des paiements
Paiements en ligne
PrésentationTrouver votre cas d'usageManaged Payments
Utiliser Payment Links
Créer une page de paiement
Développer une intégration avancée
Développer une intégration dans l'application
Moyens de paiement
Ajouter des moyens de paiement
Gérer les moyens de paiement
Paiement accéléré avec Link
Interfaces de paiement
Payment Links
Checkout
Elements pour le web
Elements intégrés à l'application
Scénarios de paiement
Gérer plusieurs devises
Tunnels de paiement personnalisés
Acquisition flexible
Orchestration
Paiements par TPE
Terminal
    Présentation
    Accepter les paiements par TPE
    Conception d'intégration
    Choisir votre lecteur
    Concevoir une intégration
    Démarrage rapide
    Exemples d'applications
    Tests
    Configuration de Terminal
    Configurer votre intégration
    Se connecter à un lecteur
    Acceptation d'un paiement
    Encaisser des paiements par carte
    Autres moyens de paiement
    Accepter les paiements hors ligne
    Paiement des commande par courrier/par téléphone
    Spécificités régionales
    Lors du règlement
    Collecter des pourboires
    Collecter et enregistrer des informations de paiement pour une utilisation ultérieure
    Autorisations flexibles
    Après le paiement
    Rembourser des transactions
    Fournir des reçus
    Personnalisez Checkout
    Affichage du panier
    Collecter les données saisies à l'écran
    Collecter les données des lectures de la piste magnétique
    Collecter les données des paiements NFC sans contact
    Applications sur des appareils
    Gérer les lecteurs
    Commander, renvoyer ou remplacer des lecteurs
    Enregistrer des lecteurs
    Gérer les emplacements et les zones
    Configurer des lecteurs
    Suivre les lecteurs
    Chiffrement
    Références
    Documentation de l'API
    Lecteurs mobiles
    Lecteurs intelligents
    Guide de migration du SDK
    Liste de contrôle pour le déploiement
    Fiches produit du lecteur Stripe Terminal
Au-delà des paiements
Constituez votre entreprise
Cryptomonnaies
Financial Connections
Climate
AccueilPaiementsTerminal

Gérer les emplacements

Groupez et gérez vos lecteurs par emplacement physique.

Vous pouvez rationaliser la gestion de plusieurs lecteurs répartis sur différents sites physiques en utilisant des emplacements et des zones.

Les emplacements et les zones permettent d’associer chaque lecteur à des sites opérationnels spécifiques et garantissent le téléchargement des bonnes configurations régionales.

  • Emplacements : Vous permet de regrouper des lecteurs, de surveiller leur état de connectivité et de modifier vos paramètres en fonction de leur emplacement physique. Cette fonctionnalité est bénéfique pour les places de marché disposant de plusieurs comptes connectés.

  • Zones : méthode facultative pour catégoriser plus précisément les emplacements et les lecteurs. Les zones vous permettent de représenter des groupes plus importants de lecteurs ou d’emplacements, tels que des régions géographiques plus vastes (par exemple, des pays) ou des sous-marques d’organisation. Plusieurs emplacements peuvent appartenir à une même zone et vous pouvez créer une structure hiérarchique en regroupant plusieurs zones sous une même zone.

Remarque

Les zones représentent une manière supplémentaire de regrouper des emplacements. Vous devez toujours affecter les lecteurs à un emplacement et vous ne pouvez affecter un emplacement qu’à une seule zone.

Emplacements

Vous pouvez créer un emplacement pour chaque emplacement physique où vos lecteurs opèrent. Vous pouvez enregistrer plusieurs lecteurs dans chaque emplacement et imbriquer ces emplacements dans des zones. Avant de pouvoir utiliser un lecteur, vous devez l’enregistrer dans un emplacement.

Les propriétés d’adresse requises pour un emplacement varient d’un pays à l’autre :

PaysPropriétés d'adresse requises
Australie
Canada
Italie
Espagne
États-Unis
line1, city, state, postal_code, and country
Autriche
Belgique
République tchèque
Danemark
Finlande
France
Allemagne
Luxembourg
Malaisie
Pays-Bas
Nouvelle-Zélande
Norvège
Pologne+
Portugal
Suède
Suisse
Royaume-Uni
line1, city, postal_code, and country
Irlande
Singapour
line1, postal_code, and country
+Terminal est actuellement disponible en version bêta dans ce pays.
**La compatibilité de ce SDK mobile s'applique également lorsqu'il est utilisé avec React Native.

Erreur fréquente

Vous pouvez utiliser le Dashboard ou l’API pour modifier un objet Location. Une fois que vous avez créé un emplacement, vous ne pouvez pas modifier le pays associé. Au lieu de cela, créez un nouvel emplacement dans le nouveau pays, puis réenregistrez tous les lecteurs associés à l’ancien emplacement.

Zones

Les zones sont les groupes de niveau supérieur qui peuvent être constitués d’autres zones ou d’autres emplacements. Vous pouvez ajouter des sous-zones sous une zone existante, créant ainsi des niveaux hiérarchiques supplémentaires, tels que « Côte ouest ». Toutefois, cette organisation des emplacements par zones est facultative.

Créer des emplacements et des zones

Remarque

Vous ne pouvez pas créer ou modifier des zones à l’aide de l’API.

Tout d’abord, vous devez enregistrer votre lecteur dans un emplacement pour accepter des paiements.

Pour créer un nouvel objet Terminal Location à l’aide de l’API, utilisez la requête de création d’un emplacement.

Command Line
cURL
curl https://api.stripe.com/v1/terminal/locations \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d display_name=HQ \ -d "address[line1]"="1272 Valencia Street" \ -d "address[city]"="San Francisco" \ -d "address[state]"=CA \ -d "address[country]"=US \ -d "address[postal_code]"=94110

Créer un emplacement pour les comptes utilisant les paiements directs

Pour créer un emplacement pour un compte utilisant les paiements directs, utilisez l’en-tête Stripe-Account dans votre requête. Seul le compte Connect sous lequel vous vous authentifiez peut accéder à ces emplacements. Si l’entreprise opère sur plusieurs sites physiques, vous pouvez créer plusieurs emplacements pour tout compte individuel utilisant les paiements directs.

Command Line
cURL
curl https://api.stripe.com/v1/terminal/locations \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -H "Stripe-Account:
{{CONNECTED_ACCOUNT_ID}}
"
\ -d display_name=HQ \ -d "address[line1]"="1272 Valencia Street" \ -d "address[city]"="San Francisco" \ -d "address[state]"=CA \ -d "address[country]"=US \ -d "address[postal_code]"=94110

Créer un emplacement pour les comptes utilisant les paiements indirects

Dans le cas des intégrations utilisant des paiements indirects, les emplacements sont associés au compte de la plateforme et ne sont pas strictement mappés aux comptes connectés. Si votre plateforme souhaite associer des comptes utilisant les paiements indirects à des emplacements, vous pouvez stocker une référence aux comptes concernés dans la propriété metadata de l’emplacement.

Command Line
curl
curl https://api.stripe.com/v1/terminal/locations \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d "display_name"="HQ" \ -d "address[line1]"="1272 Valencia Street" \ -d "address[city]"="San Francisco" \ -d "address[state]"="CA" \ -d "address[country]"="US" \ -d "address[postal_code]"="94110" \ -d "metadata[connected_account]"=
{{CONNECTED_ACCOUNT_ID}}

Lorsque vous enregistrez votre lecteur dans un emplacement, l’emplacement spécifié regroupe le lecteur et définit ses paramètres de pays.

Limitation des tokens de connexion Server-side Smart readers

Lorsque vous créez un ConnectionToken pour le SDK Terminal, vous pouvez fournir un paramètre location afin de contrôler l’accès aux lecteurs intelligents. Si vous spécifiez un emplacement, le ConnectionToken ne sera utilisable qu’avec les lecteurs intelligents assignés à cet emplacement. Si vous ne le faites pas, le ConnectionToken sera utilisable avec tous les lecteurs.

Remarque

Pour les lecteurs Bluetooth, le location d’un ConnectionToken n’a aucun effet. Cela permet de s’assurer que tout lecteur Bluetooth situé à proximité reste détectable.

Command Line
cURL
curl https://api.stripe.com/v1/terminal/connection_tokens \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d location=
{{LOCATION_ID}}
Cette page vous a-t-elle été utile ?
OuiNon
  • Besoin d'aide ? Contactez le service Support.
  • Rejoignez notre programme d'accès anticipé.
  • Consultez notre log des modifications.
  • Des questions ? Contactez l'équipe commerciale.
  • LLM ? Lire llms.txt.
  • Propulsé par Markdoc