In früheren Versionen der Stripe API hat Stripe standardmäßig Kartenzahlung sowohl für PaymentIntents als auch SetupIntents angewendet, wenn Sie keinen payment_method_types-Parameter angegeben haben.
Künftig wendet Stripe berechtigte Zahlungsmethoden standardmäßig auf Ihre PaymentIntents und SetupIntents an, wenn Sie den Parameter payment_method_types in der Erstellungsanfrage nicht angeben. Diese Einstellungen können Sie über Ihr Dashboard verwalten.
Payment methods
By default, Stripe enables cards and other common payment methods. You can turn individual payment methods on or off in the Stripe Dashboard. In Checkout, Stripe evaluates the currency and any restrictions, then dynamically presents the supported payment methods to the customer.
To see how your payment methods appear to customers, enter a transaction ID or set an order amount and currency in the Dashboard.
You can enable Apple Pay and Google Pay in your payment methods settings. By default, Apple Pay is enabled and Google Pay is disabled. However, in some cases Stripe filters them out even when they’re enabled. We filter Google Pay if you enable automatic tax without collecting a shipping address.
Checkout’s Stripe-hosted pages don’t need integration changes to enable Apple Pay or Google Pay. Stripe handles these payments the same way as other card payments.
Aktualisieren Sie Ihre Zahlungsabläufe
Wählen Sie aus dem Upgrade-Pfad, der Ihrer aktuellen Stripe-Integration entspricht:
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.
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.
Wenn Sie Zahlungen bestätigen, empfehlen wir Ihnen, den Parameter return_url anzugeben. Auf diese Weise können Sie Zahlungsmethoden akzeptieren, die eine Weiterleitung erfordern.
checkout.js
const form = document.getElementById('payment-form');
form.addEventListener('submit',async(event)=>{
event.preventDefault();const{error}=await stripe.confirmPayment({//`Elements` instance that was used to create the Payment Element
elements,
confirmParams:{
return_url:'https://example.com/return_url',},});if(error){// This point will only be reached if there is an immediate error when// confirming the payment. Show error to your customer (for example, payment// details incomplete)const messageContainer = document.querySelector('#error-message');
messageContainer.textContent= error.message;}else{// Your customer will be redirected to your `return_url`. For some payment// methods like iDEAL, your customer will be redirected to an intermediate// site first to authorize the payment, then redirected to the `return_url`.}});
Serverseitige Bestätigung
Wenn Sie die serverseitige Bestätigung nutzen, müssen Sie den Parameter return_url in Ihrer Integration verwenden.
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.
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.