Setup Intents API

支払い方法を保存するための Setup Intents API についてご紹介します。

Setup Intents API を使用し、将来の支払いに使用する支払い方法を設定します。支払いと類似していますが、請求は作成されません。今すぐ将来の支払い用に備えて、支払い方法を設定しましょう。

目的は、将来の支払いに備えた支払い認証情報の保存と最適化です。このため、あらゆるシナリオに備えて支払い方法を設定します。たとえば、カードを設定する場合には、顧客の認証や、顧客の銀行でのカードの有効性の確認などが必要になる可能性があります。Stripe は、そのプロセス全体において SetupIntent オブジェクトを更新します。

支払い方法を保存して再利用する

Setup Intents API は、以下のような、顧客をアカウント登録してもすぐには請求が発生しないビジネスで使用すると便利です。

顧客がレンタカーを借りる前に支払い方法の詳細を収集し、レンタル期間が終了してからカードに請求するレンタカー会社
カードの詳細を収集しておき、キャンペーンが一定額に達した場合にのみ、実際の請求を行うクラウドファンディングのウェブサイト
使用量に基づいて月ごとに請求金額が異なり、最初の月の支払いの前に SEPA 支払いの詳細を収集する公共事業会社

メモ

You can also set up payment methods for future use when you do charge them during Checkout.

始める

Get permission to save a payment method

You’re responsible for your compliance with all applicable laws, regulations, and network rules when saving a customer’s payment details.

Future on-session use

If you set up a payment method for future on-session payments, such as displaying the payment method on a future checkout page, you must explicitly collect consent from the customer for this specific use. For example, include a “Save my payment method for future use” checkbox to collect consent.

If you need to differentiate between payment methods saved only for offline usages and payment methods you can present to your customer for future on-session purchases, you can utilize the allow_redisplay parameter on the PaymentMethod object.

Future off-session use

将来のオフセッション支払いの支払い方法を設定する場合は、許可が必要です。あらかじめ契約 (「同意書」とも呼ばれます) を作成しておくことで、顧客がお客様のウェブサイトやアプリを能動的に使用していないときでも請求できるようになります。

支払いの処理方法を示す規約をウェブサイトおよびアプリに追加し、顧客が承諾できるようにします。規約には、少なくとも以下の内容が含まれていることを確認してください。

顧客の代理として単独の支払いまたは一連の支払いを開始することを許可する、顧客からお客様への許可
予測される支払い頻度 (1 回限り、継続など)
支払い金額の決定方法

カードの保存または SEPA 銀行口座情報の保存に関して推奨される同意書のテキストをご覧ください。

SCA の影響を受けるユーザーは、この契約を使用することで、支払いを中断なく成功させることが可能になります。カードが適切に保存されるように組み込みを設定すると、Stripe は、その後のオフセッション支払いを加盟店が開始した取引 (MIT) としてマークし、顧客がオンラインに戻って認証する必要をなくします。加盟店が開始した取引には、お客様と顧客間の契約が必要です。

Specify usage to increase success rate

usage パラメーターは、支払い方法の詳細を後でどのように使用するかを Stripe に伝えます。一部の支払い方法では、Stripe は usage 設定を使用して、顧客にとって最も負担の少ないフローを選択できます。この最適化は、成功する支払いの数を増やすように設計されています。

たとえば、ヨーロッパの SCA 規制対象のクレジットカードとデビットカードでは、保存プロセスの際に顧客によるカードの認証が必要になる場合があります。usage を off_session に設定すると、オフセッション支払いに対してクレジットカードやデビットカードが適切に認証されるため、顧客はオンラインに戻って再度認証する必要がなくなります。そのため、初期の設定フローでは負担が生じますが、usage を off_session に設定することで、以降のオフセッション支払いにおける顧客の介入を減らすことができます。

ただし、顧客が購入する際にのみカードを使用する予定の場合は、usage を on_session に設定します。これにより、顧客が認証できる場合に限り、そのカードを使用することを銀行に知らせることができます。これにより、カード詳細の認証をその時点まで延ばし、事前の負担を避けることができます。

カードの使用計画	使用する Usage 列挙値
オンセッション支払いのみ	`on_session`
オフセッション支払いのみ	`off_session` (デフォルト)
オンセッション支払いとオフセッション支払いの両方	`off_session` (デフォルト)

Usage は最適化の 1 つです。オンセッション用に設定されたカードをオフセッション支払いに使用することもできますが、銀行がオフセッション支払いを拒否し、顧客に認証を求める確率が高くなります。いずれの場合も、後で認証が必要になる可能性があるため、アプリにはリカバリプロセスを構築します。オフセッションのカード支払いで認証が要求される場合は、顧客をオンラインに戻して支払いを完了します。

指定がない場合、usage はデフォルトで off_session になります。サーバー上で SetupIntent を作成し、usage を指定する方法をご覧ください。

メモ

このページのガイダンスに従い、組み込みが強力な顧客認証を必要とするカードを処理できるようにします。取引に正しくフラグを付けることにより、Stripe は適正な SCA 免除をお客様の代理として求めることができ、各支払いの認証の必要性を最小限に抑えます。