顧客の支払い方法を保存および取得する
Payment Element に保存された支払い方法についてご紹介します。
Payment Element の支払い方法の保存機能を使用して、顧客の支払い方法を将来使用できるように Customer オブジェクトに保存できます。こうすると、以下が可能になります。
card
、us_
、bank_ account sepa_
など、支払い方法を保存することの 同意 を買い手に求めます。debit - 買い手が 1 回限りの支払いと継続取引の両方に対して GDPR 準拠の同意を提供したときに支払い方法を保存します。
- 将来の購入時に保存した支払い方法を買い手に表示します。顧客は、決済情報の削除と更新も行うことができます。
- 指定の取引でセキュリティコードの再収集を要求するように Payment Element を設定します。
Payment Element に、保存された支払い方法を導入するため、Payment Element を初めて使用する場合は、まず導入方法の設計をご確認ください。既存の Payment Element の実装がある場合は、支払い方法の保存を有効にする際に使用した導入ガイドで、顧客の支払い方法を保存および取得するステップをご覧ください。
Link で保存済みの支払い方法を使用する
Link は、すべての Stripe ユーザーに対して機能する保存済みの支払い方法のネットワークです。設定を追加することなく、Link を保存済みの支払い方法で使用できます。
- 新規顧客は支払い方法を特定のビジネス、Link、またはその両方に保存できます。
- 保存された Link による支払い方法と保存されたビジネスの支払い方法の両方がある顧客には、ページの読み込み後に、保存されたビジネスの支払い方法が表示されます。
Link で支払い方法を保存します。
以前に保存した支払い方法を再利用します。
支払いの詳細を再収集する
セキュリティ強化のため、require_cvc_recollection を指定して、顧客がカードで支払う場合にセキュリティコードを再収集するように Payment Element にリクエストすることができます。
payment_method_options: { card: {required_cvc_recollection: true} }
サブスクリプションまたは継続取引の支払い方法を保存する
支払いの確定時に今後の購入のために決済情報を保存するチェックボックスが表示および選択されている場合、支払い方法の allow_redisplay 値は always
に設定されます。この場合、顧客は、支払い方法がサブスクリプションと今後のセッションで使用されることに同意したものとみなされます。顧客がこのチェックボックスのチェックを外したままにする場合、allow_
値は limited
に設定されます。この場合、お客様は支払い方法を今後の購入に使用することはできず、現在設定しているサブスクリプションに限定されます。
サブスクリプションから支払い方法が削除されないようにする
支払い方法が再利用できるように保存されており、継続的なサブスクリプションの支払い方法でもある場合は、その支払い方法を Payment Element の保存済みセクションから削除すると、サブスクリプションからも削除されます。支払い方法が有効なサブスクリプションから削除されないように、保存された支払い方法の Payment Element からの 削除を無効 にすることをお勧めします。代わりに、アカウントの設定ページや既存のサブスクリプションを示す同様のページで支払い方法を管理してください。
既存の保存された支払い方法を表示する
Card Element の組み込み、Stripe API の直接使用、またはその他の方法によって Stripe アカウントの顧客に既存の支払い方法が設定されている場合、それらの支払い方法は allow_
プロパティが unspecified
であるため、Payment Element に表示されません。allow_
プロパティが always
の場合、支払い方法は Payment Element で表示されます。
以下のいずれかの方法を使用して、以前に保存した支払い方法を表示できます。
- 支払い方法の保存時に顧客から適切な同意を収集している場合は、
allow_
をredisplay always
に更新します。- 支払い方法更新 API を使用して、個々の支払い方法を更新します。
allow_
の場合に支払い方法を含めるようにするには、カスタマーセッション API を設定します。redisplay="unspecified"
Payment Element 以外で支払い方法を再利用するための同意を収集する
Payment Element では、今後の購入のために決済情報を保存するチェックボックスの状態を使用して、顧客が支払い方法を保存することに同意したかどうかを判別します。別の方法 (ウェブサイトの利用規約や Payment Element の外部で表示される同意の文言など) でこの同意を収集している場合は、意図を確定する際に Elements インスタンスが示す同意を上書きすることができます。
組み込みで stripe.confirmPayment、stripe.confirmSetup、または stripe.createConfirmationToken を使用している場合は、明示的な allow_redisplay 値をオプションハッシュに渡して、 Elements インスタンスの値を上書きします。