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 processSetupIntent verarbeitet die Bestätigung für Sie, sodass keine weiteren Maßnahmen erforderlich sind.

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

You’re responsible for your compliance with all applicable laws, regulations, and network rules when saving a customer’s payment details. For example, the European Data Protection Board has issued guidance regarding saving payment details. These requirements generally apply if you want to save your customer’s payment method for future use. This applies in situations such as presenting a customer’s payment method to them in the checkout flow for a future purchase, or charging them when they’re not actively using your website or app, placing a MOTO order, or in your store.

Add terms to your checkout flow that state how you plan to save payment method details and allow customers to opt in. If you plan to charge the customer while they’re not actively checking out, make sure (at a minimum) that your terms also cover the following:

• 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.

When you save a payment method, you can only use it for the specific purpose that you included in your terms. If you want to charge customers when they’re not actively checking out and also save the customer’s payment method to present to them as a saved payment method for future purchases, you must explicitly collect consent from the customer. One way to do so is with a “Save my payment method for future use” checkbox.