Gérer les emplacements

Groupez et gérez vos lecteurs par emplacement physique.

Lecteur Stripe S700

Recevez une notification lorsque le lecteur Stripe S700 sera disponible dans votre pays.

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.

Command Line

curl https://api.stripe.com/v1/terminal/locations \
  -u sk_test_VePHdqKTYQjKNInc7u56JBrQ
: \
  -d "display_name"="HQ" \
  -d "address[line1]"="19 Rue de Vienne" \
  -d "address[city]"="Paris" \
  -d "address[country]"="FR" \
  -d "address[postal_code]"="75008" \

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`

⁺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.

Créer un emplacement avec Standard Connect

Pour créer un emplacement pour un compte Connect standard, utilisez l’en-tête Stripe-Account dans votre requête. Les emplacements ainsi créés ne sont accessibles que par le compte Connect avec lequel vous vous authentifiez. Si l’entreprise opère sur plusieurs sites physiques, vous pouvez créer plusieurs emplacements pour un compte Connect standard individuel.

Command Line

curl https://api.stripe.com/v1/terminal/locations \
  -u sk_test_VePHdqKTYQjKNInc7u56JBrQ
: \
  -d "display_name"="HQ" \
  -d "address[line1]"="19 Rue de Vienne" \
  -d "address[city]"="Paris" \
  -d "address[country]"="FR" \
  -d "address[postal_code]"="75008" \
  -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}
"

Créer un emplacement avec Custom Connect

Concernant les intégrations Custom Connect, les emplacements appartiennent au compte de la plateforme et ne sont pas mappés strictement aux comptes Connect. Si votre plateforme doit associer des comptes Custom Connect à des emplacements, vous pouvez enregistrer une référence au(x) compte(s) concerné(s) dans la propriété metadata de l’emplacement.

Command Line

curl https://api.stripe.com/v1/terminal/locations \
  -u sk_test_VePHdqKTYQjKNInc7u56JBrQ
: \
  -d "display_name"="HQ" \
  -d "address[line1]"="19 Rue de Vienne" \
  -d "address[city]"="Paris" \
  -d "address[country]"="FR" \
  -d "address[postal_code]"="75008" \
  -d "metadata[connected_account]"={{CONNECTED_ACCOUNT_ID}}

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.

Command Line

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

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.

Command Line

curl https://api.stripe.com/v1/terminal/readers \
  -u sk_test_VePHdqKTYQjKNInc7u56JBrQ
: \
  -d "registration_code"="{{READER_REGISTRATION_CODE}}" \
  -d "label"="Alice's Reader" \
  -d "location"={{LOCATION_ID}}

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.

async function discoverReaders() {
  const config = {simulated: false, location: '{{LOCATION_ID}}'}
  const discoverResult = await terminal.discoverReaders(config);
  if (discoverResult.error) {
    console.log('Failed to discover: ', discoverResult.error);
  } else if (discoverResult.discoveredReaders.length === 0) {
    console.log('No available readers.');
  } else {
    // You should show the list of discoveredReaders to the
    // cashier here and let them select which to connect to (see below).
    connectReader(discoverResult);
  }
}

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.