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 :
| Pays | Propriétés d'adresse requises |
|---|---|
Australie Canada Italie Espagne États-Unis | line1, city, state, postal_, 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_, and country |
Irlande Singapour | line1, postal_, and country |
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.
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
For integrations using destination charges, Locations belong to the platform account and aren’t mapped strictly to connected accounts. If your platform needs to associate accounts using destination charges with Locations, you can store a reference to the relevant accounts in the Location’s metadata property.
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.