コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン

External payment methods非推奨

Add external payment methods to the Payment Element.

注意

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.

はじめに

  1. Create a Stripe account or sign in.
  2. Follow the Payment Element quickstart to complete a payments integration.
  3. For each external payment method you want to add, ensure you have completed the integration with each external payment method and confirmed that it is 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 {
    ...
  }

オプションPosition external payment methods

External payment methods aren’t intelligently ranked by Stripe’s smart ordering logic as Stripe doesn’t have context on these payment methods. You can use paymentMethodOrder to explicitly position the external payment method in the Payment Element. The Stripe-supported payment methods following the external payment method are still intelligently ranked. This example configures Divido in the second position after cards.

メモ

When setting up your payment methods, you can’t set external payment methods as the default selection. When placed first, external payment methods appear from the second slot onwards.

checkout.js
const paymentElement = elements.create("payment");
const paymentElement = elements.create("payment", {
      paymentMethodOrder: ['card', 'external_divido']
  });

Test your integration

  1. Go through your checkout flow and verify that the Payment Element displays Divido. This example configures Divido in the second position after cards.
    Screenshot of what Payment Element looks like when Divido is added

    Payment Element with Divido

  2. Choose the Divido payment method to verify messaging about the next step redirecting to Divido.
    Screenshot of what Payment Element looks like when Divido is selected
  3. Click Pay now to test your existing Divido integration. Verify that you are 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.

ダッシュボードに関する考慮事項

外部の支払い方法の提供業者に対する PaymentIntent は Stripe ダッシュボードでは、incomplete ステータスになります。Stripe は外部の支払い方法による取引に関与しないため、これらの取引のステータスを特定できません。

インテントを作成する前に支払いの詳細を収集する場合、外部の支払い方法の提供業者で処理された取引に対して、Stripe ダッシュボードに incomplete 取引は表示されません。

外部の支払い方法の免責事項

Stripe Payment Element を使用して、Stripe では対応していないがお客様が直接実装している外部の支払い方法をいくつか表示できます。顧客は、外部の支払い方法を選択すると、外部の支払い方法用にお客様が設定した URL にリダイレクトされます。お客様は以下を承認するものとします。

  1. 外部の支払い方法が提供されても、Stripe で対応してもいません。外部の支払い方法の運用とサポートは外部の支払い方法の提供業者によって提供されます。
  2. 外部の支払い方法の提供業者との直接実装の保守はお客様自身で行う必要があります。
  3. お客様は外部の支払い方法の提供業者との契約を維持する必要があり、各提供業者との契約を遵守する責任があります。
  4. 決済機能内で外部の支払い方法の提供業者のマークとロゴを使用するのに必要なすべての権利は、お客様がこれらのドキュメントの記載に従って取得する必要があります。
  5. Stripe は、いかなる外部の支払い方法の提供業者とのいかなる取引 (支払い、返金、不審請求の申請、売上処理、資金フローなど) も処理する責任を負いません。
  6. 顧客が外部の支払い方法を選択した後で、たとえば注文の確定や注文の照合などを含む、注文の購入フローを完了する責任は、お客様または外部の支払い方法の提供業者にあります。
  7. 外部の支払い方法へのリダイレクト URL は、お客様自身の責任で正しく設定する必要があります。
  8. 外部の支払い方法の提供業者との契約が終了するか、Stripe が外部の支払い方法を利用不可にした場合、お客様はすぐに外部の支払い方法を削除する必要があります。
  9. Payment Element に実装して提示できる外部の支払い方法は、このガイドのリストにあるものに限られます。
  10. 買い手が指定の外部の支払い方法に正しくリダイレクトされるようにする作業は、お客様単独の責任で行う必要があります。

外部の支払い方法の継続的な利用可能性

Stripe は、いつでも外部の支払い方法として任意の支払い方法を利用不可にすることを決定できます。お客様が使用している外部の支払い方法が利用不可になる場合は Stripe から通知されるため、コードで外部の支払い方法をすぐに削除する必要があります。これに失敗すると、外部の支払い方法が顧客に表示されなくなります。

利用可能な外部の支払い方法

以下の外部の支払い方法を表示できます。該当する外部の支払い方法タイプをコード内でお使いください。

地域決済手段外部の支払い方法タイプ
AMERInteracexternal_interac
APACau PAYexternal_au_pay
APACatoneexternal_atone
APACTouch’n Goexternal_tng_ewallet
APACソフトバンクまとめて支払いexternal_softbank_carrier_payment
APACToss Payexternal_toss_pay
APACLaybuyexternal_laybuy
APACBank Payexternal_bank_pay
APACauかんたん決済external_au_easy_payment
APACBitCashexternal_bitcash
APACAzupayexternal_azupay
APACd払いexternal_dbarai
APACFamiPayexternal_famipay
APACGCashexternal_gcash
APACGrabPay Laterexternal_grabpay_later
APACMoMoexternal_momo
APACNET CASHexternal_net_cash
APACOctopusexternal_octopus
APACPaidyexternal_paidy
APACPayPayexternal_paypay
APACPlanPayexternal_planpay
APACペイジーexternal_pay_easy
APAC楽天ペイexternal_rakuten_pay
APACメルペイexternal_merpay
APACWebMoneyexternal_webmoney
APAC、ヨーロッパShopback Payexternal_shopback_pay
ヨーロッパAplazameexternal_aplazame
ヨーロッパBizumexternal_bizum
ヨーロッパDividoexternal_divido
ヨーロッパFonixexternal_fonix
ヨーロッパIwocapayexternal_iwocapay
ヨーロッパKBCexternal_kbc
ヨーロッパNexi Payexternal_nexi_pay
ヨーロッパOneyexternal_oney
ヨーロッパPayconiqexternal_payconiq
ヨーロッパPayPoexternal_paypo
ヨーロッパSofincoexternal_sofinco
ヨーロッパPostepayexternal_postepay
ヨーロッパPostFinanceexternal_postfinance
ヨーロッパScalapayexternal_scalapay
ヨーロッパTrueLayerexternal_truelayer
ヨーロッパWalleyexternal_walley
ヨーロッパYounitedPayexternal_younited_pay
グローバルLINE Payexternal_line_pay
グローバルPaySafeCardexternal_paysafecard
グローバルSamsung Payexternal_samsung_pay
グローバルSezzleexternal_sezzle
LATAMDappexternal_dapp
LATAMPicPayexternal_picpay
MEATabbyexternal_tabby
MEABenefitexternal_benefit
MEAFawryexternal_fawry