Gérer les emplacements

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.

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 :

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

curl https://api.stripe.com/v1/terminal/locations \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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

curl https://api.stripe.com/v1/terminal/locations \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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

curl https://api.stripe.com/v1/terminal/locations \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -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}}

curl https://api.stripe.com/v1/terminal/connection_tokens \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d location=
{{LOCATION_ID}}