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 können einen SetupIntent erstellen und die Parameter customer, onBehalfOf (nur Connect) und usage angeben.

const { createSetupIntent } = useStripeTerminal();

const { paymentIntent, error } = await createSetupIntent({
  customer: 
'{{CUSTOMER_ID}}',
});

if (error) {
  // Placeholder for handling exception
  return;
}

// Placeholder for collecting a payment method with setupIntent

Wenn die zum Starten einer Zahlung erforderlichen Informationen nicht ohne weiteres in Ihrer App verfügbar sind, können Sie den SetupIntent auf Ihrem Server erstellen. Rufen Sie unter Verwendung des Client-Geheimnisses retrieveSetupIntent auf und rufen Sie dann unter Verwendung des abgerufenen SetupIntent collectSetupIntentPaymentMethod auf.

Zahlungsmethode zum Speichern erfassen

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

Zum Erfassen einer Zahlungsmethode müssen Sie mit einem Lesegerät verbunden sein. Das verbundene Lesegerät wartet auf eine Karte, nachdem Ihre App collectSetupIntentPaymentMethod aufruft.

const { setupIntent, error } = await collectSetupIntentPaymentMethod({
  setupIntentId: setupIntentId,
  allowRedisplay: "always"
});

if (error) {
  // Placeholder for handling exception
  return;
}

// Placeholder for confirming setupIntent

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 von Zahlungsmethoden abbrechen, indem Sie cancelCollectSetupIntent im SDK aufrufen.

Kundenseitig initiierte Stornierung

Wenn Sie enableCustomerCancellation für eine Transaktion auf „true“ gesetzt haben, wird Nutzerinnen und Nutzern von intelligenten Lesegeräten eine Schaltfläche zum Abbrechen angezeigt. Durch Tippen auf die Schaltfläche „Abbrechen“ wird die aktive Transaktion abgebrochen.

const { setupIntent, error } = await collectSetupIntentPaymentMethod({
  setupIntentId: setupIntentId,
  allowRedisplay: "always"
  enableCustomerCancellation: true
});

if (error) {
  // Placeholder for handling exception
}

// Placeholder for processing SetupIntent

Angaben zur Zahlungsmethode an Stripe übermitteln

Verwenden Sie confirmSetupIntent , um die Einrichtung abzuschließen.

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.

const { setupIntent, error } = await confirmSetupIntent(setupIntentId);

if (error) {
  // Placeholder for handling exception
  return;
}

// The SetupIntent is now ready to be used as a payment method on a future payment

Ü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“.