Wenn Sie das Card Element oder einzelne Elements für Zahlungsmethoden in Ihrer Integration verwenden, empfehlen wir die Migration zu Payment Elements. Mit dieser einfachen, einheitlichen Integration können Sie mehr als 25 verschiedene Zahlungsmethoden akzeptieren.
PaymentIntent erstellen
In dieser Version der API ist die Angabe des Parameters automatic_payment_methods.enabled optional. Wenn Sie den Parameter nicht angeben, nimmt Stripe den Wert true
an, wodurch seine Funktionalität standardmäßig aktiviert wird.
curl https://api.stripe.com/v1/payment_intents \
-u "sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
-d amount=1099 \
-d currency=usd
Clientseitige Bestätigungen mit Stripe.js
Wenn Ihre Integration Stripe.js verwendet, um Zahlungen mit confirmPayment oder per Zahlungsmethode zu bestätigen, bleiben Ihre bestehenden Prozesse unverändert und erfordern keine weiteren Änderungen.
Wir empfehlen, beim Bestätigen von Zahlungen den Parameter return_url anzugeben. Auf diese Weise können Sie Zahlungsmethoden akzeptieren, die eine Weiterleitung erfordern.
const form = document.getElementById('payment-form');
form.addEventListener('submit', async (event) => {
event.preventDefault();
const {error} = await stripe.confirmPayment({
elements,
confirmParams: {
return_url: 'https://example.com/return_url',
},
});
if (error) {
const messageContainer = document.querySelector('#error-message');
messageContainer.textContent = error.message;
} else {
}
});
Serverseitige Bestätigung
Wenn Sie die serverseitige Bestätigung nutzen, müssen Sie den Parameter return_url in Ihrer Integration verwenden.
curl https://api.stripe.com/v1/payment_intents \
-u "sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
-d amount=1099 \
-d currency=usd \
-d confirm=true \
-d payment_method= \
--data-urlencode return_url="https://example.com/return_url"
Alternativ können Sie den PaymentIntent oder SetupIntent mit dem auf never
festgelegten Parameter automatic_payment_methods.allow_redirects erstellen. Dadurch wird die Anforderung der return_url
bei der Bestätigung deaktiviert. Zahlungsmethoden können Sie weiterhin über das Dashboard verwalten. Für Zahlungsmethoden, die Weiterleitungen erfordern, ist dies jedoch nicht möglich.
curl https://api.stripe.com/v1/payment_intents \
-u "sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
-d amount=1099 \
-d currency=usd \
-d confirm=true \
-d payment_method= \
-d "automatic_payment_methods[enabled]"=true \
-d "automatic_payment_methods[allow_redirects]"=never
Abschließend können Sie den PaymentIntent oder den SetupIntent mit dem Parameter payment_method_types erstellen. Dadurch wird außerdem die Anforderung der return_url
bei der Bestätigung deaktiviert. Mit dieser Option können Sie Zahlungsmethoden nicht über das Dashboard verwalten.
curl https://api.stripe.com/v1/payment_intents \
-u "sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
-d amount=1099 \
-d currency=usd \
-d confirm=true \
-d payment_method= \
-d "payment_method_types[]"=card