ダッシュボードでデフォルトの支払い方法を管理する

API をアップグレードし、デフォルトとしてダッシュボードで支払い方法を管理します。

2023 年 8 月 16 日に、Stripe は /v1/payment_intents および /v1/setup_intents API で作成した PaymentIntent と SetupIntent に適用されるデフォルトの支払い方法の選定プロセスを更新しました。

以前のバージョンの Stripe API では、作成リクエスト中に payment_method_types パラメーターを指定しなかった場合、Stripe は PaymentIntent と SetupIntent の両方にカードの支払い方法をデフォルトで使用していました。

これ以降、作成リクエストで payment_method_types パラメーターを指定しない場合、Stripe は PaymentIntent と SetupIntent に、ダッシュボードでお客様が管理している対象の支払い方法をデフォルトで適用します。

決済手段

デフォルトでは、カードとその他の一般的な決済手段が有効になっています。Stripe ダッシュボードで個々の決済手段をオンまたはオフにできます。Checkout では、Stripe は通貨と制限事項を評価して、対応している決済手段を顧客に動的に提示します。

決済手段が顧客にどのように表示されるか確認するには、ダッシュボードで取引 ID を入力するか、または注文金額と通貨を設定します。

決済手段の設定では Apple Pay と Google Pay を有効にすることができます。デフォルトでは、Apple Pay は有効で、Google Pay は無効になっています。ただし、有効になっていても Stripe が除外する場合があります。配送先住所を収集せずに税金の自動計算を有効にした場合、Google Pay は除外されます。

Checkout の Stripe 上のオンラインページでは、Apple Pay や Google Pay を有効にするために実装内容を変更する必要はありません。Stripe は、これらの決済を他のカード決済と同じように処理します。

決済フローを更新する

現在の Stripe の実装に合ったアップグレードパスを選択してください。

お客様のシステムで Card Element または個別の支払い方法の Element を使用している場合は、Payment Element に移行することをお勧めします。この統合型の導入により、一度に 25 種類以上の支払い方法を受け付けられるようになります。

PaymentIntent を作成する

このバージョンの API では、automatic_payment_methods.enabled パラメーターの指定は任意です。このパラメーターを指定しない場合、Stripe では true の値を想定し、デフォルトでこの機能が有効になるとみなされます。

クライアント側での Stripe.js による確定

お客様のシステムが Stripe.js を使用し、confirmPayment または payment method で支払いを確定している場合、既存のプロセスは変わらず、これ以降の変更も必要ありません。

支払いを確定する場合は、return_url パラメーターを指定することをお勧めします。これにより、リダイレクトを必要とする支払い方法を受け付けることができます。

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`.
  }
});

サーバー側での確定

サーバー側で確定する場合は、実装で return_url パラメーターを使用する必要があります。

または、automatic_payment_methods.allow_redirects パラメーターを never に設定して PaymentIntent または SetupIntent を作成できます。これにより確定時の return_url 要件は無効になります。引き続きダッシュボードから支払い方法を管理できますが、リダイレクトを必要とする支払い方法は対象外になります。

最後に、payment_method_types パラメーターを指定して PaymentIntent または SetupIntent を作成できます。これにより、確定時の return_url 要件も無効になります。このオプションでは、ダッシュボードから支払い方法を管理できません。