External payment methodsVeraltet

Add external payment methods to the Payment Element.

Vorsicht

We created a custom payment methods feature that allows you to extend your payment integration with payment methods processed outside of Stripe. We recommend using it for your integration instead of external payment methods.

The Payment Element can display external payment methods that you support in addition to the payment methods processed through Stripe. Integrating external payment methods requires additional integration work, because external payment method transactions are processed and finalized outside of Stripe.

External payment methods disclaimer

When customers choose an external payment method, they’re redirected to a URL you configured for the external payment method. Learn about what you’re responsible for and the ongoing availability of external payment methods.

This guide adds an external payment method, Divido, using the HTML/JS example from the Payment Element quickstart.

Bevor Sie loslegen

Create a Stripe account or sign in.
Follow the Payment Element quickstart to complete a payments integration.
For each external payment method you want to add, ensure you’ve completed the integration with each external payment method and confirmed that it’s working in the region that you want to enable them in.

Add external payment method types

In your checkout.js file, where you initialize Stripe Elements, specify the external payment methods you want to add to the Payment Element. This example adds Divido:

checkout.js
elements = stripe.elements({
    clientSecret: clientSecret,
    externalPaymentMethodTypes: ['external_divido']
  });

Handle payment method selection listener

There are two ways to handle the redirect to the external payment method:

Replace the action of the Stripe Pay now button to redirect to the external payment method.
Replace the Stripe Pay now button with the external payment method provider’s button.

This listener replaces the action of the Stripe Pay now button to redirect the customer to the Divido checkout page where they can complete the transaction. In checkout.js, add the listener code after the paymentElement.mount call:

checkout.js
paymentElement.mount("#payment-element");

// Track selected payment method
let selectedPaymentMethod;
paymentElement.on('change', (event) => {
  selectedPaymentMethod = event?.value?.type;
});

Update the handleSubmit function to redirect to the Divido checkout page:

checkout.js
async function handleSubmit(e) {
  if (selectedPaymentMethod === 'external_divido') {
    // Redirect customer to the Divido checkout page to complete the transaction
    const dividoRedirectUrl = "<< fill the Divido redirect URL here >>";
    window.location.href = dividoRedirectUrl;
  } else {
    ...
  }

OptionalPosition external payment methods

Test your integration

Go through your checkout flow and verify that the Payment Element displays Divido. This example configures Divido in the second position after cards.
Payment Element with Divido
Choose the Divido payment method to verify messaging about the next step redirecting to Divido.
Click Pay now to test your existing Divido integration. Verify that you’re redirected to Divido to complete the transaction and any post-payment actions (for example, display a confirmation page, success message, or failure message) still work with your Divido integration.

Überlegungen zum Dashboard

PaymentIntents für Transaktionen, die mit einem externen Anbieter von Zahlungsmethoden verarbeitet werden, weisen im Dashboard den Status incomplete auf. Stripe ist nicht an Transaktionen mit externen Zahlungsmethoden beteiligt und kann den Status dieser Transaktionen nicht ermitteln.

Wenn Sie Zahlungsdetails erfassen, bevor Sie einen Intent erstellen, werden im Stripe-Dashboard keine incomplete Transaktionen für Transaktionen angezeigt, die mit einem externen Zahlungsmethodenanbieter verarbeitet wurden.

Haftungsausschluss für externe Zahlungsmethoden

Sie können das Stripe Payment Element verwenden, um einige externe Zahlungsmethoden anzuzeigen, die derzeit von Stripe nicht unterstützt werden, mit denen Sie jedoch direkt vernetzt sind. Wenn Kundinnen/Kunden eine externe Zahlungsmethode wählen, werden sie zu einer URL weitergeleitet, die Sie für die externe Zahlungsmethode konfiguriert haben. Sie bestätigen Folgendes:

Externe Zahlungsmethoden werden von Stripe weder angeboten noch unterstützt. Der Betrieb und die Unterstützung externer Zahlungsmethoden wird durch den externen Anbieter von Zahlungsmethoden bereitgestellt.
Sie sind für die Bereitstellung einer direkten Integration mit dem externen Zahlungsmethodenanbieter verantwortlich.
Sie müssen eine Vereinbarung mit dem externen Zahlungsmethodenanbieter abschließen und sind für die Einhaltung Ihrer Vereinbarung(en) mit jedem externen Zahlungsmethodenanbieter verantwortlich.
Sie sind dafür verantwortlich, alle erforderlichen Rechte zu erwerben, um die Marken und Logos der externen Zahlungsmethodenanbieter in Ihrem Bezahlvorgang, wie in diesen Dokumenten beschrieben, zu verwenden.
Stripe ist nicht verantwortlich für die Verarbeitung von Transaktionen mit einem externen Zahlungsmethodenanbieter, einschließlich beispielsweise Zahlungen, Rückerstattungen, Anfechtungen, Zahlungsabwicklungen oder Geldbewegungen.
Sie oder der externe Zahlungsmethodenanbieter sind für den Abschluss des Kaufvorgangs verantwortlich, nachdem ein Kunde/eine Kundin eine externe Zahlungsmethode ausgewählt hat, einschließlich beispielsweise der Bestellbestätigung und des Bestellabgleichs.
Sie sind dafür verantwortlich, dass die Weiterleitungs-URL für die externe Zahlungsmethode korrekt konfiguriert wird.
Sie müssen alle externen Zahlungsmethoden sofort entfernen, falls Ihre Vereinbarung(en) mit einem externen Zahlungsmethodenanbieter beendet werden oder Stripe die Verfügbarkeit einer externen Zahlungsmethode aufhebt.
Sie dürfen nur die in diesem Leitfaden aufgeführten externen Zahlungsmethoden im Payment Element integrieren und dort darstellen.
Sie alleine sind dafür verantwortlich, sicherzustellen, ass Käufer/innen korrekt an die von ihnen ausgewählte externe Zahlungsmethode weitergeleitet werden.

Ständige Verfügbarkeit externer Zahlungsmethoden

Stripe kann jederzeit beschließen, die Verfügbarkeit einer Zahlungsmethode als externe Zahlungsmethode aufzuheben. Stripe benachrichtigt Sie über die Aufheben einer externen Zahlungsmethode, die Sie verwenden, und Sie müssen die externe Zahlungsmethode sofort aus Ihrem Code entfernen. Andernfalls wird die externe Zahlungsmethode für Ihre Kundinnen/Kunden nicht gerendert.

Verfügbare externe Zahlungsmethoden

Sie können die folgenden externen Zahlungsmethoden anzeigen. Sie müssen den entsprechenden externen Zahlungsmethodentyp in Ihrem Code verwenden.

Region	Zahlungsmethode	Typ der externen Zahlungsmethode

AMER	Interac	`external_interac`
APAC	au PAY	`external_au_pay`
APAC	atone	`external_atone`
APAC	Touch’n Go	`external_tng_ewallet`
APAC	ソフトバンクまとめて支払い (Softbank-Zahlungen)	`external_softbank_carrier_payment`
APAC	Toss Pay	`external_toss_pay`
APAC	Laybuy	`external_laybuy`
APAC	Bank Pay	`external_bank_pay`
APAC	auかんたん決済 (au easy-Zahlungen)	`external_au_easy_payment`
APAC	BitCash	`external_bitcash`
APAC	Azupay	`external_azupay`
APAC	d払い (d-barai)	`external_dbarai`
APAC	FamiPay	`external_famipay`
APAC	GCash	`external_gcash`
APAC	GrabPay Later	`external_grabpay_later`
APAC	MoMo	`external_momo`
APAC	NET CASH	`external_net_cash`
APAC	Octopus	`external_octopus`
APAC	Paidy	`external_paidy`
APAC	PayPay	`external_paypay`
APAC	PlanPay	`external_planpay`
APAC	ペイジー (Pay-easy)	`external_pay_easy`
APAC	楽天ペイ (Rakuten Pay)	`external_rakuten_pay`
APAC	メルペイ (Merpay)	`external_merpay`
APAC	WebMoney	`external_webmoney`
Asien-Pazifik, Europa	ShopBack Pay	`external_shopback_pay`
Europa	Aplazame	`external_aplazame`
Europa	Bizum	`external_bizum`
Europa	Divido	`external_divido`
Europa	Fonix	`external_fonix`
Europa	Iwocapay	`external_iwocapay`
Europa	KBC	`external_kbc`
Europa	Nexi Pay	`external_nexi_pay`
Europa	Oney	`external_oney`
Europa	Payconiq	`external_payconiq`
Europa	PayPo	`external_paypo`
Europa	Sofinco	`external_sofinco`
Europa	Postepay	`external_postepay`
Europa	PostFinance	`external_postfinance`
Europa	Scalapay	`external_scalapay`
Europa	TrueLayer	`external_truelayer`
Europa	Walley	`external_walley`
Europa	YounitedPay	`external_younited_pay`
Global	LINE Pay	`external_line_pay`
Global	paysafecard	`external_paysafecard`
Global	Samsung Pay	`external_samsung_pay`
Global	Sezzle	`external_sezzle`
LATAM	Dapp	`external_dapp`
LATAM	PicPay	`external_picpay`
MEA	Tabby	`external_tabby`
MEA	Benefit	`external_benefit`
MEA	Fawry	`external_fawry`