Weiter zum Inhalt
Konto erstellen
 oder
anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellen
Anmelden
ÜbersichtAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case findenZahlungen verwalten
Zahlungsmethoden
Zahlungsschnittstellen
Zahlungsszenarien
Präsenzzahlungen
Mehr als Zahlungen

Zahlungsdaten bei der Zahlung speichern

So akzeptieren Sie eine Zahlung uns speichern die Zahlungsdetails Ihrer Kundin/Ihres Kunden für zukünftige Käufe.

Notiz

Unterstützung für gespeicherte Zahlungsmethoden unter Verwendung von Elements und der Checkout Sessions API umfasst nur Karten. Andere gespeicherte Zahlungsmethoden wie Bankkonten werden nicht unterstützt.

Gespeicherte Zahlungsmethoden aktivieren

Vorsicht

Die weltweiten Datenschutzgesetze sind komplex und vielschichtig. Bevor Sie die Möglichkeit implementieren, Zahlungsmethodendetails von Kundinnen und Kunden zu speichern, lassen Sie sich rechtlich beraten, um sicherzustellen, dass sie Ihren Datenschutz- und Compliance-Bestimmungen entspricht.

Damit Kundinnen und Kunden ihre Zahlungsmethoden für die zukünftige Verwendung speichern können, geben Sie beim Erstellen der Checkout-Sitzung den Parameter saved_payment_method_options.payment_method_save an.

Zum Speichern einer Zahlungsmethode ist ein Kunden-Objekt erforderlich. Übergeben Sie einen/eine bestehende/n Kunden/Kundin oder, um einen neuen Kunden/eine neue Kundin zu erstellen, setzen Sie die customer_creation der Checkout-Sitzung auf always.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}}
 \
  -d "line_items[0][quantity]"=2 \
  -d mode=payment \
  -d ui_mode=custom \
  -d customer_creation=always \
  -d "saved_payment_method_options[payment_method_save]"=enabled

Nachdem Sie die Checkout-Sitzung erstellt haben, verwenden Sie das in der Antwort zurückgegebene Client-Geheimnis, um Ihre Bezahlseite zu erstellen.

Pass in additional elementsOptions on initCheckout to enable the Payment Element to display a consent collection checkbox for you.

checkout.js
const checkout = await stripe.initCheckout({
  fetchClientSecret,
  elementsOptions: {
    savedPaymentMethod: {
      enableSave: 'auto',
    }
  }
});

Eine zuvor gespeicherte Zahlungsmethode erneut verwenden

Jede gespeicherte Zahlungsmethode ist mit einem Kunden-Objekt verknüpft. Bevor Sie die Checkout-Sitzung erstellen, authentifizieren Sie Ihre Kundin/Ihren Kunden und übergeben Sie die entsprechende Kunden-ID an die Checkout-Sitzung.

Das Payment Element zeigt automatisch erneut die zuvor gespeicherten Zahlungsmethoden an, die Ihre Kundin/Ihr Kunde beim Checkout verwenden kann.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}}
 \
  -d "line_items[0][quantity]"=2 \
  -d mode=payment \
  -d ui_mode=custom \
  -d customer=
{{CUSTOMER_ID}}

Pass in additional elementsOptions on initCheckout to enable the Payment Element to redisplay previously saved payment methods for your customer to use during checkout.

checkout.js
const checkout = await stripe.initCheckout({
  fetchClientSecret,
  elementsOptions: {
    savedPaymentMethod: {
      enableSave: 'auto',
      enableRedisplay: 'auto',
    }
  }
});

OptionalErstellen Sie Ihre eigene Nutzeroberfläche für gespeicherte Zahlungsmethoden

Sie können sich dafür entscheiden, Ihre eigene Nutzeroberfläche für gespeicherte Zahlungsmethoden zu erstellen, anstatt die integrierte Nutzeroberfläche des Payment Elements zu verwenden.

You can prevent the Payment Element from handling consent collection and displaying the previously saved payment methods by passing in additional elementsOptions on initCheckout.

checkout.js
const checkout = await stripe.initCheckout({
  fetchClientSecret,
  elementsOptions: {
    savedPaymentMethod: {
      enableSave: 'never',
      enableRedisplay: 'never',
    }
  }
});

Einwilligung einholen

Vorsicht

Die weltweiten Datenschutzgesetze sind komplex und vielschichtig. Bevor Sie die Möglichkeit implementieren, Zahlungsmethodendetails von Kundinnen und Kunden zu speichern, lassen Sie sich rechtlich beraten, um sicherzustellen, dass sie Ihren Datenschutz- und Compliance-Bestimmungen entspricht.

In den meisten Fällen müssen Sie die Zustimmung eines Kunden/einer Kundin einholen, bevor Sie seine/ihre Zahlungsmethoden speichern. Das folgende Beispiel zeigt, wie Sie mithilfe eines Kontrollkästchens die Zustimmung einholen.

index.html
<label>
  <input type="checkbox" id="save-payment-method-checkbox" />
  Save my payment information for future purchases
</label>
<button id="pay-button">Pay</button>
<div id="confirm-errors"></div>

Informieren Sie Stripe darüber, ob Ihr Kunde/Ihre Kundin seine/ihre Einwilligung gegeben hat, wenn Sie „confirm“ aufrufen, indem Sie den Parameter savePaymentMethod übergeben. Wenn Sie die Zahlungsdaten eines Kunden/einer Kundin speichern, sind Sie für die Einhaltung aller geltenden Gesetze, Vorschriften und Netzwerkregeln verantwortlich.

checkout.js
stripe.initCheckout({fetchClientSecret}).then((checkout) => {
  const button = document.getElementById('pay-button');
  const errors = document.getElementById('confirm-errors');
  const checkbox = document.getElementById('save-payment-method-checkbox');
  button.addEventListener('click', () => {
    // Clear any validation errors
    errors.textContent = '';

    const savePaymentMethod = checkbox.checked;
    checkout.confirm({savePaymentMethod}).then((result) => {
      if (result.type === 'error') {
        errors.textContent = result.error.message;
      }
    });
  });
});

Gespeicherte Zahlungsmethoden rendern

Verwenden Sie das Array savedPaymentMethods im Frontend, um die verfügbaren Zahlungsmethoden der Kundin/des Kunden zu rendern.

Notiz

Das Array savedPaymentMethods enthält nur die Zahlungsmethoden, bei denen allow_redisplay auf always festgelegt ist. Befolgen Sie die Schritte zum Einholen der Einwilligung von Ihren Kundinnen/Kunden. Dadurch wird sichergestellt, dass allow_redisplay ordnungsgemäß festgelegt ist.

index.html
<div id="saved-payment-methods"></div>
checkout.js
stripe.initCheckout({fetchClientSecret}).then((checkout) => {
  const container = document.getElementById('saved-payment-methods');
  checkout.session().savedPaymentMethods.forEach((pm) => {
    const label = document.createElement('label');
    const radio = document.createElement('input');

    radio.type = 'radio';
    radio.value = pm.id;

    label.appendChild(radio);
    label.appendChild(document.createTextNode(`Card ending in ${pm.card.last4}`));
    container.appendChild(label);
  });
});

Mit einer gespeicherten Zahlungsmethode bestätigen

Wenn Ihre Kundin/Ihr Kunde eine gespeicherte Zahlungsmethode ausgewählt hat und bereit ist, den Bezahlvorgang abzuschließen, rufen Sie bestätigen auf und übergeben die paymentMethod-ID.

index.html
<button id="pay-button">Pay</button>
checkout.js
stripe.initCheckout({fetchClientSecret}).then((checkout) => {
  const button = document.getElementById('pay-button');
  button.addEventListener('click', () => {
    checkout.confirm({paymentMethod: selectedPaymentMethod}).then((result) => {
      if (result.error) {
        // Confirmation failed. Display the error message.
      }
    });
  });
});
War diese Seite hilfreich?
JaNein