Gérer les emplacements
Si votre déploiement de Terminal utilise un grand nombre de lecteurs sur plusieurs emplacements physiques, le suivi de tous ces lecteurs peut s’avérer complexe. Facilitez la gestion de vos lecteurs et de leur activité en les associant à un emplacement physique. Les emplacements vous permettent également de vous assurer que vos lecteurs téléchargent les bonnes configurations régionales.
Utilisez l’objet Locations de Terminal pour regrouper les lecteurs, consulter leur état de connectivité et personnaliser leurs paramètres par emplacement physique. Ceci est particulièrement utile pour les places de marché qui comptent de nombreux comptes connectés.
Après avoir créé des objets Locations, vous pouvez les utiliser pour vous aider à regrouper les lecteurs, améliorer les flux de découverte de lecteurs, personnaliser leurs paramètres par emplacement physique, et bien plus encore.
Créer un emplacement Server-side Dashboard
Créez un objet Location pour chaque emplacement physique dans lequel vos lecteurs sont actifs. Si votre entreprise vous demande souvent de déplacer vos lecteurs, vos emplacements peuvent utiliser des adresses qui représentent un lieu d’activité principal.
Pour créer un nouvel emplacement à l’aide de l’API, utilisez la requête create location.
Les propriétés d’adresse requises d’un emplacement varient en fonction du pays :
Pays | Proprié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+ Portugal+ Suède Suisse+ Royaume-Uni | line1 , city , postal_code , and country |
Irlande Singapour | line1 , postal_code , and country |
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.
Créer un emplacement pour les comptes utilisant les paiements indirects
Pour les intégrations utilisant les paiements indirects, les emplacements sont relié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.
Vous pouvez également créer des emplacements dans le Dashboard Stripe, sur la page Gérer les emplacements.
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 définissez un lieu, le ConnectionToken n’est utilisable qu’avec les lecteurs intelligents assignés à cet emplacement. Sans emplacement défini, le ConnectionToken peut s’utiliser avec tous les lecteurs.
Note
Pour les lecteurs Bluetooth , le location
d’un ConnectionToken n’a aucun effet. Ainsi, les lecteurs Bluetooth à proximité de chez vous resteront toujours détectables.
Enregistrer un lecteur dans un emplacement
Vous devez enregistrer votre lecteur dans un emplacement afin d’accepter des paiements. Le processus d’enregistrement de votre lecteur dans un emplacement diffère selon qu’il s’agit d’un lecteur intelligent ou d’un lecteur Bluetooth.
Lecteurs intelligents Server-side
Enregistrez les lecteurs intelligents (Verifone P400, BBPOS WisePOS E et le lecteur Stripe S700) à un emplacement lors de l’enregistrement des lecteurs.
Vous pouvez également enregistrer des lecteurs dans le Dashboard sur la page Lecteurs ou sur la page Gérer les emplacements.
Lecteurs Bluetooth Client-side
Enregistrez les lecteurs Bluetooth comme le (lecteur M2 de Stripe, le BBPOS Chipper 2X BT et le BBPOS WisePad 3) dans un emplacement pendant la connexion au lecteur en spécifiant le locationId
dans votre BluetoothConnectionConfiguration
. Si vous le souhaitez, vous pouvez enregistrer le lecteur dans le dernier emplacement utilisé en transmettant le reader.locationId
à partir d’un lecteur découvert.
Note
Les versions du SDK Terminal antérieures à v2.0.0 ne prennent pas en charge l’enregistrement des lecteurs BBPOS Chipper 2X BT ou WisePad 3 dans les emplacements.
Filtrer les lecteurs découverts
Lecteurs intelligents Client-side
Votre application utilise la méthode discoverReaders
du SDK pour rechercher les lecteurs auxquels elle peut se connecter. Lorsque vous recherchez un lecteur intelligent comme Verifone P400 ou BBPOS WisePOS E, vous pouvez découvrir le lecteur souhaité plus facilement en filtrant les résultats par emplacement.
Avec le code ci-dessous, le rappel de votre application ne renvoie que les lecteurs d’un emplacement donné. Vous trouverez l’ID de l’emplacement sur la page Gérer les emplacements du Dashboard.
Lecteurs Bluetooth Client side
Comme les lecteurs mobiles utilisent Bluetooth pour se connecter, discoverReaders
retourne tous les lecteurs à proximité. Aucun filtrage supplémentaire n’est appliqué par défaut. Cependant, vous pouvez utiliser le paramètre registeredLocation
retourné sur l’objet Reader pour appliquer de manière facultative un filtrage supplémentaire à votre application.