Collecte des données saisies à l'écran

Vous pouvez collecter des informations sur les clients même lorsque le lecteur intelligent fonctionne hors ligne.

Pour collecter des saisies à l’aide des lecteurs intelligents Terminal, appelez collectInputs avec le SDK Terminal, le SDK communique avec le lecteur pour afficher une interface utilisateur préconfigurée. Vous pouvez spécifier jusqu’à 5 entrées à la fois, et le lecteur les collecte dans l’ordre. Une fois que le client a saisi ses données, le SDK renvoie les données collectées avec un rappel.

let signatureInput = try SignatureInputBuilder(title: "Please sign")
    .setStripeDescription("Please sign if you agree to the terms and conditions")
    .setSkipButtonText("skip form")
    .setSubmitButtonText("Submit signature")
    .build()


let firstSelectionButton = try SelectionButtonBuilder(style: .primary, text: "Yes", id: "yes_id")
    .build()

let secondSelectionButton = try SelectionButtonBuilder(style: .secondary, text: "No", id: "no_id")
    .build()

let firstToggle = try ToggleBuilder(defaultValue: .enabled)
    .setTitle("Sign up for promotional emails")
    .build()

let selectionInput = try SelectionInputBuilder(title: "Choose an option")
    .setStripeDescription("Were you happy with our customer service?")
    .setRequired(true)
    .setSelectionButtons([firstSelectionButton, secondSelectionButton])
    .setToggles([firstToggle])
    .build()

let collectInputsParams = try CollectInputsParametersBuilder(
    inputs: [signatureInput, selectionInput]
).build()

let cancelable = Terminal.shared.collectInputs(collectInputsParams) { (collectInputsResult, error) in
    if let error = error {
        // Placeholder for handling error
    } else if let result = collectInputsResult {
        // Placeholder for handling collected inputs
    }
}

Personnalisation

Vous pouvez personnaliser l’apparence et le comportement de tous les types de saisie :

• Définissez les saisies importantes comme required pour vous assurer qu’elles seront collectées. Le bouton Ignorer est masqué lorsque la saisie est obligatoire.
• Fournissez un contexte à votre client en précisant le texte que vous souhaitez afficher sur l’écran du lecteur pour chaque saisie à l’aide des champs title et description.

• Utilisez des sauts de ligne dans votre texte pour une meilleure mise en forme.
• 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

• Pour les saisies de type selection, vous pouvez mettre l’accent ou non sur choices à l’aide du paramètre style.

Styles principal et secondaire des options du type de saisie « selection »

Lorsque le lecteur commence à collecter des données saisies, il affiche la première donnée de la liste.

Une fois que le client a terminé toutes les saisies, le lecteur passe à un état transitoire pendant 3 secondes, en attendant une nouvelle demande. Si aucune requête n’est effectuée après 3 secondes, le lecteur revient à l’écran d’accueil.

Lorsque toutes les entrées ont été collectées ou ignorées, le SDK Terminal renvoie les 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 les champs text et id 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, la valeur booléenne skipped est définie sur true.
• Pour chaque bouton d’activation, l’option enabled, disabled ou skipped est renvoyée en fonction de l’index de la liste d’entrée des boutons d’activation.

Le SDK Terminal renvoie une erreur en cas d’action annulée, d’encaissement expiré ou de toute autre erreur.

Vous pouvez tester votre intégration à l’aide du lecteur de simulation du SDK. Avant de pouvoir tester la collecte des données saisies, vous devez d’abord vous connecter à un lecteur Internet simulé.

Le lecteur de simulation permet de simuler les scénarios suivants :

• Collecte des données saisies réussie sans omettre aucune saisie
• Collecte des données saisies réussie en ignorant toutes les saisies non requises
• Échec de la collecte des données saisies en raison d’un délai d’attente

Lors de la simulation d’une collecte réussie des entrées, le SDK renvoie une valeur codée en dur pour chaque entrée en fonction du type.

// Simulated internet reader must already be connected
Terminal.shared.simulatorConfiguration.simulatedCollectInputsResult = SimulatedCollectInputsResultSucceeded(
  simulatedCollectInputsSkipBehavior: .none
)

let collectInputsParams = try CollectInputsParametersBuilder(
    inputs: // Placeholder for specifying the inputs you want to simulate collecting
).build()

let cancelable = Terminal.shared.collectInputs(collectInputsParams) { (collectInputsResult, error) in
    if let error = error {
        // Placeholder for handling error
    } else if let result = collectInputsResult {
        // Placeholder for handling collected inputs
    }
}