Direkt speichern, ohne die Karte zu belasten
Verwenden Sie SetupIntents, um Kartendaten zu sammeln, ohne die Karte zu belasten. Zum Speichern von Karten mit Stripe Terminal mithilfe von SetupIntents müssen Sie Folgendes tun:
- Erstellen oder Abrufen eines Kunden-Objekts
- Erstellen eines SetupIntent-Objekts, um den Vorgang zu verfolgen
- Erfassen einer Zahlungsmethode nach Zustimmung der Kundin/des Kunden
- Übermitteln der Angaben zur Zahlungsmethode an Stripe
Verfügbarkeit
Sie können SetupIntents verwenden, um Kartenangaben für Visa-, Mastercard-, American Express, Discover- und EFTPOS-Karten mit Co-Branding zu erfassen. Interac-Karten, EFTPOS-Karten mit nur einer Marke und Mobile Wallets (zum Beispiel Apple Pay oder Google Pay) werden nicht unterstützt.
Notiz
Die servergestützte SetupIntents API ist kompatibel mit den BBPOS WisePOS E-Lesegeräten und dem Stripe Reader S700.
Kundinnen/Kunden erstellen oder abrufen
Um eine bei Stripe gespeicherte Karte zu belasten, müssen Sie sie einem Customer-Objekt zuordnen.
Wenn Sie vor dem Bestätigen, eine/n Kund/in in Ihrer SetupIntent angeben, fügt Stripe die generierte Zahlungsmethode „Karte“ automatisch zum angegebenen Customer-Objekt hinzu.
Fügen Sie den folgenden Code auf Ihrem Server ein, um einen neuen Customer
zu erstellen.
SetupIntent erstellen
Notiz
Es wird empfohlen, bei der Erstellung einer SetupIntent eine Kunden-ID anzugeben, damit die Zahlungsmethode „Karte“ bei erfolgreicher Einrichtung dem/der Customer
hinzugefügt wird. Wenn Sie keine Kunden-ID angeben, müssen Sie die Zahlungsmethode in einem separaten Aufruf hinzufügen.
Ein SetupIntent ist ein Objekt, das Ihre Absicht darstellt, die Zahlungsmethode eines/einer Kund/in für zukünftige Zahlungen einzurichten. Der SetupIntent verfolgt die Schritte dieses Einrichtungsvorgangs. Bei Terminal umfasst dies die Einholung und Aufzeichnung der Zustimmung der Karteninhaber/innen.
Sie müssen den SetupIntent auf Ihrem Server erstellen und card_present
im Parameter payment_method_types
.
Der SetupIntent enthält ein Client-Geheimnis, einen eindeutigen Schlüssel für den SetupIntent. Sie müssen dieses Client-Geheimnis vom SetupIntent auf Ihrem Server beziehen und an den Client übergeben.
Erfassen einer Zahlungsmethode zum Speichern von Karten
Nachdem Sie eine SetupIntent erstellt haben, erfassen Sie als Nächstes eine Zahlungsmethode mit dem SDK und holen die Zustimmung des/der Kund/in ein. Wenn der Kunde/die Kundin die erforderliche Zustimmung gibt, legen Sie den booleschen Wert customer_consent_collected
auf true
fest.
Notiz
Holen Sie die Zustimmung mündlich oder über ein Kontrollkästchen in Ihrer Anwendung ein. Sie müssen auf die Einhaltung sämtlicher in Ihrer Region geltenden Gesetze, Regeln und Richtlinien achten.
Sie müssen den Endpoint process_setup_intent aufrufen, der sowohl die Erfassung als auch die Bestätigung des SetupIntent übernimmt. Wenn der/die Kund/in seine/ihre Zustimmung erteilt, legen Sie den booleschen Wert customer_consent_collected
auf true
fest.
Diese Methode erfasst verschlüsselte Zahlungsmethodendaten mithilfe des verbundenen Kartenlesegeräts und ordnet die verschlüsselten Daten dem SetupIntent zu.
Cancel collection
Programmatic cancellation
Sie können die Erfassung einer Zahlungsmethode durch Aufrufen von cancel_action abbrechen.
Vorsicht
Die Erfassung einer Zahlungsmethode erfolgt lokal und erfordert bis zum nächsten Schritt keine Autorisierung oder Aktualisierung des SetupIntent-Objekts.
Angaben zur Zahlungsmethode an Stripe senden
Ihr vorheriger Aufruf von process_setup_intent verarbeitet die Bestätigung für Sie, es sind also keine Maßnahmen erforderlich.
Eine erfolgreiche Einrichtung gibt den Wert succeeded
für die Status-Eigenschaft des SetupIntent zurück, zusammen mit einer generated_card, bei der es sich um eine wiederverwendbare card
-Zahlungsmethode handelt.
Notiz
Bei der setup_intent.payment_method handelt es sich um eine card_present
-PaymentMethod, die die Tokenisierung der Karte im Geschäft darstellt und die nicht online abrechenbar ist.
Die Zahlungsmethode generated_card
wird automatisch dem Kunden/der Kundin zugeordnet, den/die Sie bei der Erstellung des SetupIntent angegeben haben. Sie können die Zahlungsmethode generated_card
abrufen, indem Sie die Eigenschaft latest_attempt
des SetupIntent erweitern.
Alternativ können Sie die angehängte Zahlungsmethode abrufen, indem Sie die Liste der Zahlungsmethoden abrufen, die dem Kunden/der Kundin angehängt wird.
Wenn Sie während der Erstellung des SetupIntent keinen Kunden/keine Kundin angeben, können Sie auch in einem separaten Aufruf die generated_card
an das Customer-Objekt anhängen.
Wenn die Einrichtung nicht erfolgreich ist, prüfen Sie den zurückgegebenen Fehler, um die Ursache zu ermitteln. Wurde beispielsweise die Zustimmung des/der Kund/in nicht eingeholt und Stripe nicht über die Zustimmung informiert, tritt ein Fehler auf.
Compliance
Sie sind dafür verantwortlich, dass Sie alle geltenden Gesetze, Vorschriften und Netzwerkregeln einhalten, wenn Sie die Zahlungsdaten eines Kunden/einer Kundin speichern. Beispielsweise hat der Europäische Datenschutzausschuss Leitlinien zum Speichern von Zahlungsdaten herausgegeben. Diese Anforderungen gelten in der Regel, wenn Sie die Zahlungsmethode Ihrer Kundin/Ihres Kunden für die zukünftige Verwendung speichern möchten, zum Beispiel wenn Sie ihr/ihm die Zahlungsmethode einer Kundin/eines Kunden im Bestellvorgang für einen zukünftigen Kauf anzeigen oder ihr/sein Konto belasten möchten, wenn sie/er Ihre Website oder App nicht aktiv nutzt.
Binden Sie Konditionen in Ihre Website oder App ein, aus denen hervorgeht, wie Sie die Details der Zahlungsmethode speichern möchten, und ermöglichen Sie es den Kunden/Kundinnen, sich anzumelden. Wenn Sie planen, ein Kundenkonto zu belasten, während ein Kunde/eine Kundin offline ist, müssen Sie mindestens sicherstellen, dass Ihre Konditionen auch Folgendes abdecken:
- Die kundenseitige Zustimmung, eine Zahlung oder mehrere Zahlungen für bestimmte Transaktionen in deren Namen einzuleiten.
- Der erwartete Zeitpunkt und die voraussichtliche Häufigkeit von Zahlungen (z. B. Zahlungen für geplante Raten- oder Abonnementzahlungen oder für außerplanmäßige Aufstockungen).
- So wird der Zahlungsbetrag bestimmt.
- Ihre Stornorichtlinie, wenn Sie die Zahlungsmethode für einen Abonnementdienst einrichten.
Dokumentieren Sie unbedingt die schriftliche Zustimmung Ihrer Kundinnen und Kunden zu diesen Bedingungen.
Wenn Sie eine Zahlungsmethode speichern, kann sie nur für die in Ihren Konditionen festgelegte Nutzung verwendet werden. Wenn Sie ein Kundenkonto belasten möchten, während ein Kunde/eine Kundin offline ist, und auch die Zahlungsmethode des Kunden/der Kundin speichern möchten, um sie ihm/ihr als gespeicherte Zahlungsmethode für zukünftige Einkäufe anzuzeigen, müssen Sie explizit die Zustimmung des Kunden/der Kundin einholen. Eine Möglichkeit, dies zu tun, ist das Kontrollkästchen „Meine Zahlungsmethode für die zukünftige Verwendung speichern“.