Setup Intents API

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

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

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

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

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

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

注

Checkout では、将来のための支払い方法を設定することもできます。

始める

支払い方法を保存する許可を得る

法令遵守

顧客の支払いの詳細を保存する際に、お客様は適用されるすべての法律、規制、ネットワークの規則に従う責任があります。将来の購入ページに支払い方法を表示するなど、将来のオンセッションの支払いに使用するための支払い方法を設定する場合は、必ず、この特定目的の使用に関する同意を顧客から明示的に収集してください。たとえば、「今後の使用に備えて支払い方法を保存する」のチェックボックスを含めて、同意を収集します。オフラインで使用するためにのみ保存された支払い方法と、将来のオンセッションでの購入時に顧客に提示可能な支払い方法を区別する必要がある場合は、 PaymentMethod オブジェクトの allow_redisplay パラメーターを利用できます。

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

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

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

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

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

使用状況を指定して成功率を上げる

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 免除をお客様の代理として求めることができ、各支払いの認証の必要性を最小限に抑えます。