Direkt speichern, ohne die Karte zu belasten

Kundinnen/Kunden erstellen oder abrufen

Um eine bei Stripe gespeicherte Karte zu belasten, müssen Sie sie einem Kunden-Objekt zuordnen.

Wenn Sie vor dem Bestätigen, eine Kundin/einen Kunden in Ihrer SetupIntent angeben, fügt Stripe die generierte Kartenzahlungsmethode automatisch zum angegebenen Kunden-Objekt hinzu.

Fügen Sie den folgenden Code auf Ihrem Server ein, um einen neuen Customer zu erstellen.

curl -X POST https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

SetupIntent erstellen

Ein SetupIntent ist ein Objekt, mit dem Sie eine Zahlungsmethode eines Kunden/einer Kundin für zukünftige Zahlungen einrichten können. Der SetupIntent verfolgt die Schritte dieses Einrichtungsvorgangs. Für Terminal beinhaltet dies die Einholung und Aufzeichnung der Zustimmung von dem/der Karteninhaber/in.

Sie müssen den SetupIntent auf Ihrem Server erstellen und card_present im Parameter payment_method_types. Geben Sie usage=on_session an, wenn Sie beabsichtigen, die Zahlungsmethode nur dann wiederzuverwenden, wenn sich der Kunde/die Kundin in Ihrem Bezahlvorgang befindet.

# Request
curl https://api.stripe.com/v1/setup_intents \
  -u "sk_test_26PHem9AhJZvU623DfE1x4sd:" \
  -d "payment_method_types[]"=card_present \
  -d "customer"={{CUSTOMER_ID}}

# Response
{
  "id": "seti_1234567890abcdefghijklmn",
  "object": "setup_intent",
  ...  # other SetupIntent fields
}

Zahlungsmethode zum Speichern erfassen

Nachdem Sie einen SetupIntent erstellt haben, müssen Sie eine Zahlungsmethode erfassen und die Zustimmung des Kunden/der Kundin einholen. Übergeben Sie allow_redisplay als always oder limited. Geben Sie damit an, inwieweit eine Zahlungsmethode in einem Bezahlvorgang einer Kundin/eines Kunden angezeigt werden kann.

Sie müssen den Endpoint process_setup_intent aufrufen, der sowohl die Erfassung als auch die Bestätigung des SetupIntent übernimmt. Wenn der Kunde/die Kundin seine/ihre Zustimmung erteilt, legen Sie allow_redisplay entweder auf always oder limited fest.

curl https://api.stripe.com/v1/terminal/readers/{{READER_ID}}/process_setup_intent \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d setup_intent={{SETUP_INTENT_ID}} \
  -d allow_redisplay=always

Diese Methode erfasst verschlüsselte Zahlungsmethodendaten mithilfe des verbundenen Kartenlesegeräts und ordnet die verschlüsselten Daten dem SetupIntent zu.

Erfassung abbrechen

Programmgesteuerte Stornierung

Sie können die Erfassung einer Zahlungsmethode durch Aufrufen von cancel_action abbrechen.

Angaben zur Zahlungsmethode an Stripe übermitteln

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 SetupAttempt.payment_method_details.card_present.generated_card, bei der es sich um eine wiederverwendbare card-Zahlungsmethode handelt, die Sie für Online-Zahlungen verwenden können.

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. Überprüfen Sie immer, ob ein Wert für generated_card angegeben wurde, da der Wert für Zahlungsmethoden, die keine generierten Karten zulassen, leer ist.

curl -G https://api.stripe.com/v1/setup_intents/
{{SETUP_INTENT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "expand[]"=latest_attempt

Alternativ können Sie die angehängte Zahlungsmethode abrufen, indem Sie die Liste der Zahlungsmethoden abrufen, die dem Kunden/der Kundin angehängt wird.

curl -G https://api.stripe.com/v1/customers/
{{CUSTOMER_ID}}
/payment_methods \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d type=card

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.

curl https://api.stripe.com/v1/payment_methods/
{{PAYMENT_METHOD_ID}}
/attach \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}}

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.

Ü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_card die Option allow_redisplay=limited 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_session=true ü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“.