Eingaben erfassenBeta
Verfügbar in: 🌎 für Stripe S700 und BBPOS WisePOS E mithilfe einer servergesteuerten Integration, Javascript SDK, iOS SDK oder Android SDK.
Notiz
Um Zugriff auf die Beta-Version von „Eingaben erfassen“ für servergesteuerte Integrationen, Javascript SDK, iOS SDK oder Android SDK anzufordern, senden Sie uns eine E-Mail an stripe-terminal-betas@stripe.com.
Eingaben erfassen
Neben dem Einzug von Zahlungen können Sie mit den intelligenten Terminal-Lesegeräten Formulare anzeigen und Informationen von Kunden/Kundinnen erfassen. Sie können Kundeninformationen auch dann erfassen, wenn das intelligente Lesegerät offline arbeitet.
Wenn Sie collectInputs collectInputs
dem Terminal SDK aufrufen, kommuniziert das SDK mit dem Lesegerät, um eine vorgefertigte Nutzeroberfläche zur Erfassung von Kundeneingaben anzuzeigen.
Nachdem der Kunde/die Kundin seine/ihre Daten eingegeben hat, gibt das SDK Kundendaten mit einem Callback zurück.
Sie können bis zu 5 Eingaben gleichzeitig angeben, die vom Lesegerät der Reihe nach erfasst werden. Die intelligenten Lesegeräte von Stripe unterstützen derzeit 6 Eingabetypen:
- Mit dem Eingabetyp
selection
können Sie bis zu vier Auswahlmöglichkeiten anzeigen. - Der Eingabetyp
signature
ermöglicht die Erfassung einer Unterschrift über den Touchscreen des Lesegeräts. - Mit dem Eingabetyp
email
können Sie eine E-Mail-Adresse von einer Kundin/einem Kunden erfassen. - Mit dem Eingabetyp
phone
können Sie eine Telefonnummer von einem Kunden/einer Kundin erfassen. - Mit dem Eingabetyp
text
können Sie zusätzliche Informationen von Kundinnen/Kunden erfassen. - Mit dem Eingabetyp
numeric
können Sie zusätzliche Informationen von Kundinnen/Kunden erfassen.
Unterstützte Eingabetypen.
Sie können das Erscheinungsbild und das Verhalten aller Eingabetypen anpassen:
- Legen Sie wichtige Eingaben auf
required
fest, um sicherzustellen, dass sie erfasst werden. Bei Pflichteingaben ist die Schaltfläche Überspringen ausgeblendet. - Geben Sie Ihrem Kunden/Ihrer Kundin Kontext zur Verfügung, indem Sie den Text angeben, den Sie auf dem Lesegerät für jede Eingabe mit
title
unddescription
anzeigen möchten). - Fügen Sie bis zu 4 Umschalter hinzu, die Kundinnen/Kunden für boolesche Optionen, Vereinbarungen oder Anmeldungen (Opt-Ins) aktivieren oder deaktivieren können.
E-Mail und Auswahlformular mit Umschalter
Es sind weitere Anpassungen für selection
-Eingaben verfügbar. Wenn Sie die choices
festlegen, die dem Kunden/der Kundin angezeigt werden sollen, können Sie die Auswahl mithilfe des style
-Parameters hervorheben oder in den Hintergrund stellen.
Primäre und sekundäre Auswahlstile für Designs.
Notiz
Verwenden Sie collect_inputs
nicht zum Erfassen vertraulicher Daten (einschließlich geschützter Gesundheitsinformationen und Informationen zu Kundenzahlungskarten) oder anderer gesetzlich eingeschränkter Informationen.
Interaktion mit Kundinnen/Kunden
Wenn das Lesegerät mit der Erfassung von Eingaben beginnt, zeigt es dem Kunden/der Kundin die erste Eingabe aus der von Ihnen angegebenen Liste an. Der Kunde/die Kundin muss eine Auswahl treffen oder eine Unterschrift leisten, um mit den erforderlichen Eingaben fortzufahren. Bei optionalen Eingaben hat der Kunde/die Kundin jedoch die Möglichkeit, zur nächsten angeforderten Eingabe überzugehen.
Nachdem der Kunde/die Kundin alle Eingaben übermittelt oder übersprungen hat, gibt das SDK eine Liste der erfassten Eingaben zurück.
Notiz
Sie verpflichten sich in vollem Umfang, sich mit allen geltenden Gesetzen und Vorschriften in Bezug auf Ihre Nutzung dieser Funktion vertraut zu machen und diese einzuhalten, und müssen in Bezug auf diese Nutzung alle erforderlichen Zustimmungen, Autorisierungen, Lizenzen, Rechte und Genehmigungen einholen. Wenn Sie die von einem Terminal-Lesegerät erfassten oder angezeigten Daten verwenden, um Verträge mit Ihren Kundinnen/Kunden abzuschließen oder ihnen Nachrichten zu senden, sind Sie in vollem Umfang für die Rechtsgültigkeit und Durchsetzbarkeit solcher Verträge oder Nachrichten verantwortlich.
Eingabedaten empfangen
Wenn kundenseitig alle Eingaben abgeschlossen oder übersprungen wurden, gibt das Terminal SDK die erfassten Daten zurück.
- Bei Eingaben vom Typ „Signatur“ sind die zurückgegebenen Daten eine Zeichenfolge im SVG-Format.
- Bei Eingaben vom Typ „Auswahl“ sind die zurückgegebenen Daten die Zeichenfolge des
text
der ausgewählten Schaltfläche. - Bei Telefon-, E-Mail-, Text- und numerischen Eingaben sind die zurückgegebenen Daten die Zeichenfolge der Kundenantwort.
- Wenn eine optionale Eingabe von der Kundin/dem Kunden übersprungen wird, wird der boolesche Wert
skipped
auftrue
gesetzt. - Für jeden Umschalter wird entsprechend dem Index der Liste der eingegebenen Umschalter
enabled
,disabled
oderskipped
zurückgegeben.
Notiz
Umschalter erfordert Lesegerät-Version 2.21
und höher.