Bereitstellungscheckliste
Diese Checkliste hilft bei einer unkomplizierten Bereitstellung von Stripe Terminal.
Stripe Terminal erfordert die Integration von Hardware und Software, damit Stripe auf physischen Terminals genutzt werden kann. Bei der Entwicklung Ihrer Integration sollten Sie sich an dieser Checkliste orientieren, damit alle wichtigen Schritte abgedeckt werden.
Sie müssen nicht alles genau einhalten, aber wenn Sie den gesamten Umfang einer Terminal-Integration verstehen, können Sie die einzelnen Teile leichter umsetzen.
Nachdem Sie die Integrationshinweise für Stripe Terminal befolgt haben, prüfen Sie, ob Ihre Anwendung korrekt eingerichtet ist.
Um den ConnectionToken-Lebenszyklus zu verwalten, richten Sie einen Endpoint in Ihrem Backend ein, mit dem ein ConnectionToken für Ihre Client-Anwendung erstellt wird. Authentifizieren Sie diesen Endpoint, um den Zugriff auf die Lesegeräte zu steuern. Betten Sie das ConnectionToken nicht durch Hartcodierung in Ihre Anwendung ein – sonst können Sie sich nicht erneut mit einem Lesegerät verbinden. Um den Zugriff auf intelligente Lesegeräte wie das Verifone P400 und das BBPOS WisePOS E noch besser steuern zu können, können Sie Standorte nutzen.
Wenn Sie den PaymentIntent capture_method als
manualdefiniert haben, wird die Zahlung autorisiert, aber nicht erfasst, wenn das SDK einen verarbeiteten PaymentIntent an Ihre Anwendung zurückgibt. Um den Einzug der Gelder abzuschließen, müssen Sie den PaymentIntent erfassen.Wenn Ihre Anwendung einen verarbeiteten PaymentIntent vom SDK empfängt, muss Ihr Backend zum Erfassen des PaymentIntent aufgefordert werden.
Bieten Sie Kund/innen die Möglichkeit, einen Zahlungsbeleg auf Papier oder per E-Mail zu erhalten. Sie können vordefinierte Zahlungsbelege von Stripe verwenden oder nutzerdefinierte, an Ihr Unternehmen angepasste Zahlungsbelege mit Zahlungsbelegdaten aus der Stripe-API erstellen. Testen Sie, ob Sie einen Zahlungsbeleg erhalten, wenn Sie im Live-Modus eine Zahlung mit Ihrer Anwendung erstellen.
Wenn Sie Ihren Kundinnen/Kunden benutzerdefinierte Zahlungsbelege zur Verfügung stellen möchten, sollten Sie von jedem Zahlungsbeleg eine Kopie als Nachweis für Zahlungsanfechtungen speichern. Wenn Sie die vordefinierten Zahlungsbelege von Stripe verwenden, wird automatisch eine Kopie des Zahlungsbelegs gespeichert, welche im Dashboard verfügbar ist.
Gleichen Sie Zahlungen am Ende eines Tages mit dem internen Auftragssystem auf Ihrem Server ab, um unbeabsichtigte Autorisierungen oder nicht erfasste Gelder zu vermeiden:
- Wenn Nutzer/innen den Bezahlvorgang vorzeitig abbrechen, kann dies zu einem nicht erfassten PaymentIntent führen, der Karteninhaber/innen als unbeabsichtigte Autorisierung angezeigt werden kann.
- In ähnlicher Weise kann die Anforderung Ihrer App, mit der das Backend zum Erfassen des PaymentIntent aufgefordert wird, zu einem unvollständigen Einzug der Gelder führen.
Das BBPOS Chipper 2X BT aktualisiert sich nicht automatisch, daher ist es wichtig, dass Ihre Anwendung Updates unterstützt. Updates sind zwar selten, enthalten aber normalerweise wichtige Funktionen oder Fehlerbehebungen. Stellen Sie sicher, dass Ihre Anwendung Folgendes unterstützt:
- Überprüfen, ob ein Update verfügbar ist.
- Falls ja, in der Nutzeroberfläche die geschätzte Zeit bis zur Fertigstellung des Updates und Optionen zum Fortfahren oder Abbrechen anzeigen.
- Während des Updates die Nutzer/innen über die Nutzeroberfläche auffordern, das Lesegerät eingeschaltet und in der Nähe zu lassen. Verhindern, dass Nutzer/innen die Seite verlassen.
- Zeigen Sie eine optische Darstellung für den Update-Fortschritt an (z. B. Prozentsatz oder Fortschrittsbalken).
Eine mögliche Nutzeroberfläche finden Sie in unseren Beispielanwendungen (iOS, Android).
Für intelligente Lesegeräte wie das Verifone P400 und das BBPOS WisePOS E müssen Sie das Lesegerät für Ihr Konto registrieren, damit Sie Ihre Anwendung mit dem Gerät verbinden können.
Wie Lesegeräte registriert werden, hängt vom Anwendungsszenario ab:
Größe der Bereitstellung: Bei kleineren Bereitstellungen müssen Sie jedes Lesegerät im Stripe-Dashboard registrieren. Bei größeren Bereitstellungen, die den Versand von Lesegeräten an verschiedene Standorte erfordern, müssen Sie sicherstellen, dass die zuständigen Personen am jeweiligen Standort neue Lesegeräte zum Stripe-Konto Ihres Unternehmens hinzufügen können. Erstellen Sie einen Ablauf in Ihrer Anwendung, mit dem andere Personen Lesegeräte in Ihrem Stripe-Konto registrieren können. Der Endpoint zum Registrieren eines Lesegeräts muss serverseitig aufgerufen werden. Wenn Sie die Registrierung von Lesegeräten über Ihre Client-Anwendung unterstützen, muss die App mit Ihrem Backend kommunizieren.
Verwendung von Connect: Wenn Sie Direct Charges mit Connect verwenden, müssen Sie Lesegeräte mithilfe des
Stripe-Account-Headers beim verbundenen Konto registrieren. Bei Destination Charges müssen Sie die neuen Lesegeräte beim Plattformkonto registrieren.
Erstellen Sie ein Standort-Objekt für Terminal für jeden physischen Standort, an dem Ihr Unternehmen persönliche Zahlungen akzeptiert. Sie müssen jedes Lesegerät an einem Standort registrieren, damit die richtige regionale Konfiguration heruntergeladen wird.
Unterstützen Sie bei intelligenten Lesegeräten die Angabe eines Standorts bei der Registrierung des Lesegeräts. Unterstützen Sie bei Bluetooth-Lesegeräten die Angabe eines Standorts bei der Verbindung mit dem Lesegerät.
Vergewissern Sie sich, dass in Ihrer Anwendung eine aktualisierte Liste der gefundenen Lesegeräte mit der jeweiligen Bezeichnung und/oder Seriennummer angezeigt werden kann. In unseren Beispielanwendungen finden Sie ein Beispiel für die Nutzeroberfläche.
Wenn Sie erwarten, dass die App mit mehreren Bluetooth-Lesegeräten verwendet wird, sollte die Erkennung von Bluetooth-Geräten mithilfe des Näherungssensors erfolgen. Fügen Sie in Ihre App die Aufforderung ein, das Lesegerät nahe an das App-Gerät zu halten und auf das mehrfarbige Blinken zu warten. Die Nutzeroberfläche Ihrer App sollte es auch ermöglichen, den Suchprozess abzubrechen.
Beim Verifone P400 oder BBPOS WisePOS E müssen sich das Lesegerät und das Gerät, auf dem Ihre Anwendung läuft, im richtigen LAN befinden. Fügen Sie Anweisungen zum Überprüfen der LAN-Verbindung in Ihre Anwendung ein.
Stripe veröffentlicht regelmäßig Updates, die neue Funktionen, Fehlerkorrekturen und Sicherheitsupdates enthalten können. Aktualisieren Sie Ihr SDK, sobald eine neue Version verfügbar ist. Die derzeit verfügbaren SDKs sind:
Der Name und das Logo von BBPOS und Chipper™ sind Marken oder eingetragene Marken von BBPOS Limited in den Vereinigten Staaten und/oder anderen Ländern. Der Name und das Logo von Verifone® sind entweder Marken oder eingetragene Marken von Verifone in den Vereinigten Staaten und/oder anderen Ländern. Die Verwendung der Marken stellt keine Billigung durch BBPOS oder Verifone dar.