Connect アカウントに対する複数の設定
プラットフォームが、動的な決済手段を使用していて、取引のタイプや請求金額の違いに応じた異なる決済手段の設定に対応している場合は、この機能を使用してください。取引のタイプごとにサブスクリプションまたは 1 回限りの決済を設定することや、一定のドル額を超える請求金額は BNPL を使用して支払いできるようにすることなどが考えられます。
ダッシュボードで新しい決済手段の設定を作成する
Stripe ダッシュボードで、連結アカウントの決済手段の設定にアクセスします。ここで、プラットフォームレベルの「親」設定を管理します。連結アカウントは、それぞれの親の「子」構成を受け取り、以下に設定する制約の範囲内でカスタマイズできます。
デフォルトで、1 つの親設定から開始します。追加の設定を作成するには、新しい設定を追加をクリックし、名前を付けます。
プラットフォームレベルのデフォルト状態を設定する
新しい親設定に対して決済手段ごとにデフォルトの設定を適用し、連結アカウントが実行できるカスタマイズを管理できます。ドロップダウンを使用して次のように希望の設定を選択します。
- On by default: 決済手段はデフォルトで有効です。連結アカウントが有効と無効を切り替えることができます。
- Off by default: 決済手段はデフォルトで無効です。連結アカウントが有効と無効を切り替えることができます。
- Blocked: すべての連結アカウントの決済手段を無効にします。連結アカウントは有効にできません。
連結アカウントによるカスタマイズを許可する
Standard 連結アカウントは、決済手段が On by default
と Off by default
のいずれかに設定されている場合、ダッシュボードにアクセスして有効と無効を切り替えることができます。連結アカウントの決済手段の設定ページには、新しく作成された子設定が表示されます。連結アカウントはページ上部のドロップダウンメニューを使用して、編集する設定を選択できます。
連結アカウントが Stripe ダッシュボードではなくプラットフォームのダッシュボードから決済手段設定をカスタマイズできるようにする場合、または Stripe ダッシュボードへのアクセス権のない連結アカウントが存在する場合は、Payment Method Configurations API を組み込むことができます。
連結アカウント ID と子設定 ID を指定して 決済手段の設定 API を使用することで、特定の連結アカウントに関する決済手段の現在の状況を読み取ります。
{ "object": "list", "data": [ { "id":
, "object": "payment_method_configuration", "name": "My Custom Configuration", "active": true, "is_default": true, "livemode": false, "parent":"{{PAYMENT_METHOD_CONFIGURATION_ID}}", "acss_debit": { "available": false, "display_preference": { "overridable": true, "preference": "off", "value": "off" } }, "affirm": { "available": false, "display_preference": { "overridable": true, "preference": "off", "value": "off" } }, "afterpay_clearpay": { "available": false, "display_preference": { "overridable": true, "preference": "off", "value": "off" } }, ... additional payment methods } ], "has_more": false, "url": "/v1/payment_method_configurations" }"{{PAYMENT_METHOD_CONFIGURATION_ID}}"
成功すると、返されるリストには各決済手が表示され、可用性と表示設定を示す 2 つのパラメーターが含まれます。
available
は、ケイパビリティ の値 (active
、inactive
、pending
またはunrequested
) とdisplay_preference
の値の組み合わせです。available
フィールドを使用して、購入時にこの決済手段が買い手に表示されるかどうかを確認できます。available
がtrue
の場合、その決済手段のケイパビリティは有効であり、display_preference
は on です。available
がfalse
の場合、その決済手段に有効なケイパビリティがないか、display_preference
値が off であり、購入時にこの決済手段は買い手に表示されません。実装をシンプルにしてその他の機能のメリットを活かすには、ダッシュボードで管理している決済手段を購入時に使用してください。そうすると、このパラメーターが自動的に読み取られ、適切な決済手段が買い手に表示されます。display_preference
には、overridable
、preference
、value
の 3 つのコンポーネントがあります。overridable
は読み取り専用であり、上記で設定したデフォルトを連結アカウントの設定で上書きできるかどうかを示します。preference
は書き込み可能であり、連結アカウントの設定を保存します。value
は読み取り専用で、有効なdisplay_preference
値を反映します。
注
連結アカウントの国に関連する決済手段のみが API レスポンスで表示され、設定可能です。各国のサポート状況をご確認ください。
連結アカウントの所有者が決済手段を有効または無効にするときに、お客様は display_preference
の preference
属性を更新できます。これにより、その決済手段に対する連結アカウントの所有者の設定が保管されて、決済手段を買い手に表示するかどうかの判断に使用されます。
{ "id":
, "object": "payment_method_configuration", "name": "My Custom Configuration", "active": true, "is_default": true, "livemode": false, "acss_debit": { "available": false, "display_preference": { "overridable": true, "preference": "off", "value": "off" } }, "affirm": { "available": true, "display_preference": { "overridable": true, "preference": "on", "value": "on" } }, "afterpay_clearpay": { "available": false, "display_preference": { "overridable": true, "preference": "off", "value": "off" } }, ... additional payment methods }"{{PAYMENT_METHOD_CONFIGURATION_ID}}"
連結アカウントが API を使用して決済手段を有効にすると、買い手の場所、注文の金額、その他の要素に基づいて Stripe が決済手段のランクをインテリジェントに決定し、最もコンバージョン率が高い決済手段が常に最初に表示されます。
決済時に利用可能な決済手段を表示する
決済フローのレンダリング時に親設定 ID を渡して新しい設定を使用するようにします。
Payment Element を使用し、その Payment Element のレンダリング前に PaymentIntent を作成する場合は、PaymentIntent に親 ID を渡すことができます。
インテント作成猶予の導入パスを使用して Payment Element を使用する場合は、Element セッションオプションに親 ID を渡すことができます。
const options = { mode: 'payment', amount: 1099, currency: 'usd', payment_method_configuration:
}'{{PAYMENT_METHOD_CONFIGURATION_ID}}'
Checkout セッションを作成する場合は、Checkout セッションオプションに親 ID を渡すことができます。
(オプション): Apple Pay、Google Pay、Link
Apple Pay、Google Pay、Link などの一部の決済手段は、PaymentIntent に単独の決済手段タイプとして含まれていないため、カードが提示されるときにのみ確定されます。Payment Method Configurations API を使用すると、連結アカウントの所有者がこれらの特定の決済手段をオプトインまたはオプトアウトして、UI に表示されないように設定できます。