Collecter les données saisiesBêta
Disponible dans : 🌎 pour le Stripe S700 et le BBPOS WisePOS E qui utilisent l’intégration pilotée par serveur, le Javascript SDK, le SDK iOS ou le SDK Android.
Note
Pour demander l’accès à la version bêta de Collect Inputs pour l’intégration pilotée par serveur, le SDK Javascript, le SDK iOS ou le SDK Android, contactez-nous à l’adresse stripe-terminal-betas@stripe.com.
Collecter les données saisies
En plus d’encaisser les paiements, les lecteurs intelligents Terminal vous permettent d’afficher les formulaires et de recueillir des informations auprès des clients. La collecte d’informations auprès des clients fonctionne même en mode hors ligne.
Lorsque vous appelez collectInputs
avec le SDK Terminal, le SDK indique au lecteur d’afficher une interface utilisateur prédéfinie afin de collecter la saisie du client.
Une fois que le client a saisi ses données, le SDK renvoie les données du client avec un rappel.
Vous pouvez spécifier jusqu’à 5 entrées à la fois, et le lecteur les collecte dans l’ordre. Les lecteurs intelligents Stripe prennent actuellement en charge 6 types d’entrées :
- Le type de saisie
selection
vous permet d’afficher jusqu’à 4 réponses que le client pourra sélectionner. - Le type de saisie
signature
vous permet de collecter une signature à l’aide de l’écran tactile du lecteur. - Le type de saisie
email
vous permet de recueillir l’adresse e-mail d’un client. - Le type de saisie
phone
vous permet de recueillir le numéro de téléphone d’un client. - Le type de saisie
text
vous permet de recueillir des informations supplémentaires auprès de vos clients. - Le type de saisie
numeric
vous permet de recueillir des informations supplémentaires auprès de vos clients.
Types de saisie pris en charge.
Vous pouvez personnaliser l’apparence et le comportement de tous les types de saisie :
- Attribuez aux saisies importantes la valeur
required
pour vous assurer qu’elles seront collectées. Pour ces saisies obligatoires, le bouton Ignorer sera masqué. - Fournissez des explications à votre client en spécifiant un texte à afficher sur l’écran du lecteur pour chaque saisie à l’aide des champs
title
etdescription
. - Ajoutez jusqu’à 4 boutons d’activation que les clients peuvent activer ou désactiver pour les options booléennes, les contrats ou les adhésions.
Formulaire d’e-mail et de sélection avec bouton d’activation
Une personnalisation supplémentaire est disponible pour les saisies de type selection
. Lorsque vous spécifiez les choices
que vous souhaitez afficher au client, vous pouvez les mettre en évidence ou les atténuer à l’aide du paramètre style
.
Styles principal et secondaire des options du type de saisie « selection »
Note
N’utilisez pas collect_inputs
pour collecter des informations sensibles (y compris des données de santé relevant du secret médical et les informations de paiement du client), ou des informations protégées par la loi.
Interaction avec le client
Lorsque le lecteur commence à collecter les données saisies, la première donnée à saisir de la liste que vous avez spécifiée s’affiche. Si la saisie est obligatoire, le client doit sélectionner une option ou signer pour continuer. Si la saisie est facultative, il peut passer à la prochaine donnée demandée.
Une fois que le client a saisi ou ignoré toutes les saisies, le SDK renvoie une liste des données collectées.
Note
Il vous incombe de connaître et de respecter toutes les lois et réglementations applicables régissant votre utilisation de cette fonctionnalité, et vous devez, dans le cadre d’une telle utilisation, obtenir, le cas échéant, l’ensemble des consentements, licences, droits et autorisations nécessaires. Si vous utilisez les données collectées par un lecteur intelligent Terminal ou les résultats affichés pour conclure des contrats avec vos clients ou leur adresser des notifications, il vous incombe de vous assurer de la validité juridique et du caractère exécutoire de ces contrats ou notifications.
Recevoir les données saisies
Une fois que toutes les saisies ont été effectuées/ignorées, le SDK Terminal renvoie la liste des données collectées.
- Pour les saisies de type signature, les données renvoyées sont une chaîne au format SVG.
- Pour les saisies de type sélection, les données renvoyées sont la chaîne du
text
du bouton sélectionné. - Pour les saisies de type numéro de téléphone, adresse e-mail, texte et chiffres, la valeur renvoyée est la chaîne de la réponse du client.
- Si une saisie facultative est ignorée par le client, le booléen
skipped
est défini surtrue
. - Pour chaque bouton d’activation, l’option
enabled
,disabled
ouskipped
est renvoyée en fonction de l’index de la liste d’entrée des boutons d’activation.
Note
Les boutons d’activation nécessitent la version 2.21
du lecteur (ou ultérieure).