Zahlungsdetails nach Zahlung speichern
Nehmen Sie eine persönliche Zahlung entgegen und speichern Sie die Zahlungsdetails, um sie später zu verwenden, wenn der/die Karteninhaber/in nicht physisch anwesend ist.
Sie können das Stripe-Terminal verwenden, um Zahlungsdaten von einem Kartenkauf im Geschäft zu speichern. Eine erfolgreiche card_
-Zahlung gibt eine wiederverwendbare card
-Zahlungsmethode im generated_
-Attribut zurück. Es gibt mehrere Use cases:
- Eine Kundin/ein Kunde eines Fitnessstudios bezahlt persönlich für eine erste Sitzung und ein Mitgliedsabonnement. Bei der Transaktion wird eine
generated_
erstellt, die für zukünftige automatische Verlängerungen der Mitgliedschaft verwendet wird.card - Eine Kundin/ein Kunde in einem Bekleidungsgeschäft gibt ihre/seine E-Mail-Adresse an, wenn sie/er einen Einkauf an der Kasse tätigt. Bei der Transaktion wird ein Kundendatensatz und eine zugehörige gespeicherte
generated_
angelegt. Damit kann sich die Kundin/der Kunde später auf der Website des Geschäfts anmelden und mit derselben Karte eine Bestellung aufgeben.card
Für die erste persönliche Zahlung gelten die Vorteile der Haftungsverlagerung und für manche Märkte niedrigere Preisen für Standard-Terminal-Zahlungen. Spätere Zahlungen mit der generated_
sind jedoch Card-Not-Present-Online-Transaktionen.
Notiz
Wir haben das Modell für die Kundeneinwilligung in diese Funktion geändert, sodass der Parameter allow_
erforderlich ist. Sie müssen Ihre Integration aktualisieren, um allow_
zu nutzen. Dieses Update ist seit dem 31. März 2025 für Nicht-React Native-Nutzer/innen und ab dem 30. September 2025 für React Native-Nutzer/innen verpflichtend. Eine Anleitung finden Sie unter Eintrag in Änderungsprotokoll.
Kundin/Kunden erstellen
Um eine Karte für zukünftige Zahlungen einzurichten, müssen Sie sie einem/einer Kund/in hinzufügen. Erstellen Sie ein Customer-Objekt, wenn Ihr/e Kund/in ein Konto bei Ihrem Unternehmen erstellt. Customer-Objekte ermöglichen die Wiederverwendung von Zahlungsmethoden und die Nachverfolgung über mehrere Zahlungen hinweg.
Bei erfolgreicher Erstellung wird das Kundenobjekt zurückgegeben. Sie können das Objekt bezüglich der Kunden-id
überprüfen and den Wert zum späteren Abruf in Ihrer Datenbank speichern.
Sie finden diese Kundinnen/Kunden auf der Seite Kundinnen/Kunden im Dashboard.
PaymentIntent erstellen
Fordern Sie beim Erstellen eines PaymentIntent eine generated_
an, indem Sie einen Wert für setup_future_usage angeben. Wenn Sie beabsichtigen, die Zahlungsmethode nur dann wiederzuverwenden, wenn der Kunde/die Kundin während des Bezahlvorgangs anwesend ist, verwenden Sie on_
. Andernfalls verwenden Sie off_
.
Notiz
Visa-, Mastercard-, American Express-, Discover-, eftpos-, Interac- und girocard-Karten mit Co-Branding werden als card_
-Zahlungsmethoden unterstützt, die als Typ card
gespeichert werden können.
Zahlungsmethode erfassen und verarbeiten
Notiz
Für diese Funktion müssen Ihre API-Anfragen Stripe-Version: 2024-09-30.
enthalten. Eine Anleitung finden Sie unter Eintrag in Änderungsprotokoll.
Wenn der Kunde/die Kundin zahlen möchte und der Speicherung der Angaben zur Zahlungsmethode zugestimmt hat, übergeben Sie allow_redisplay als always
oder limited
an den Aufruf process_
oder collect_
Preview. Der Wert gibt an, inwieweit eine Zahlungsmethode in einem Bezahlvorgang eines Kunden/einer Kundin angezeigt werden kann.
Wenn Sie den collect_
-Ablauf verwenden, der den Zugriff auf nützliche Daten wie Kartenmarke und Finanzierung über die PaymentMethod ermöglicht, bevor Sie diese bestätigen, müssen Sie die PaymentIntent auch separat bestätigen.
Auf die generated_card zugreifen
Eine erfolgreiche Zahlung mit einer Methode, die die zukünftige Verwendung unterstützt, gibt eine PaymentIntent im Status requires_
oder succeeded
zurück. Sie können die generated_card-Zahlungsmethode abrufen, indem Sie die Eigenschaft latest_charge des PaymentIntent erweitern und payment_method_details.card_present anzeigen. Wenn Sie die Kunden-ID an den Erstellungsaufruf des PaymentIntent übergeben haben, wird die wiederverwendbare PaymentMethod automatisch dem Kundenobjekt zugeordnet. Andernfalls können Sie es in einem separaten Aufruf manuell hinzufügen.
Überprüfen Sie immer, ob die PaymentIntent.latest_charge einen generated_
-Wert enthält. Bei einigen Zahlungen, wie z. B. Zahlungen über Digital Wallets und Interac-, eftpos- oder girocard-Kartenzahlungen mit nur einer Marke, wird möglicherweise keine generierte Karte erstellt. Wenn das passiert und Sie eine wiederverwendbare Zahlungsmethode benötigen, haben Sie zwei Möglichkeiten:
- Fordern Sie den Kunden/die Kundin auf, eine andere Zahlungsmethode zu speichern, indem Sie den Ablauf verwenden, um eine Zahlungsmethode zu speichern, ohne eine Zahlung anzunehmen.
- Erstatten Sie die persönliche Zahlung, weisen Sie darauf hin, dass die Transaktion fehlgeschlagen ist, und fordern Sie den Kunden/die Kundin auf, eine andere Zahlungsmethode zu verwenden.
Überlegungen zu Mobile Wallets
Gespeicherte Mobile Wallets sind nur für off_session-Zahlungen vorgesehen, z. B. für zukünftige Abonnementzahlungen oder andere Zahlungen, die Sie im Namen Ihrer Kundinnen und Kunden initiieren. Wenn Sie eine Zahlungsmethode für eine Digital Wallet speichern, ist für die generated_
die Option allow_
festgelegt, um die spezifischen Nutzungsüberlegungen anzugeben.
Wenn Sie versuchen, ein Mobil Wallet zu belasten, achten Sie darauf, dass bei der PaymentIntent-Bestätigung off_
übergeben wird. Wenn sich der Kunde/die Kundin in Ihrem Bezahlvorgang befindet, müssen Sie stattdessen die Integrationen von Apple Pay und Google Pay verwenden, um erneut zur Anzeige der Zahlungsmethode aufzufordern.
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“.