Connect アカウントに対する複数の設定

Stripe ダッシュボードで、連結アカウントの支払い方法の設定にアクセスします。ここで、プラットフォームレベルの「親」設定を管理します。連結アカウントは、それぞれの親の「子」構成を受け取り、以下に設定する制約の範囲内でカスタマイズできます。

デフォルトで、1 つの親設定から開始します。追加の設定を作成するには、新しい設定を追加をクリックし、名前を付けます。

新しい親設定に対して支払い方法ごとにデフォルトの設定を適用し、連結アカウントが実行できるカスタマイズを管理できます。ドロップダウンを使用して次のように希望の設定を選択します。

• On by default: 支払い方法はデフォルトで有効です。連結アカウントが有効と無効を切り替えることができます。
• Off by default: 支払い方法はデフォルトで無効です。連結アカウントが有効と無効を切り替えることができます。
• Blocked: すべての連結アカウントの支払い方法を無効にします。連結アカウントは有効にできません。

Stripe ダッシュボードの全機能を利用できる連結アカウントは、支払い方法が On by default と Off by default のいずれかに設定されている場合、ダッシュボードにアクセスして有効と無効を切り替えることができます。連結アカウントの支払い方法の設定ページには、新しく作成された子設定が表示されます。連結アカウントはページ上部のドロップダウンメニューを使用して、編集する設定を選択できます。

連結アカウントが Stripe ダッシュボードではなくプラットフォームのダッシュボードから支払い方法設定をカスタマイズできるようにする場合、または Stripe ダッシュボードへのアクセス権のない連結アカウントが存在する場合は、Payment Method Configurations API を組み込むことができます。

連結アカウント ID と子設定 ID を指定して 支払い方法の設定 API を使用することで、特定の連結アカウントに関する支払い方法の現在の状況を読み取ります。

curl https://api.stripe.com/v1/payment_method_configurations/
{{PAYMENT_METHOD_CONFIGURATION_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
"

{
  "object": "list",
  "data": [
    {
      "id": 
"{{PAYMENT_METHOD_CONFIGURATION_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"
}

成功すると、返されるリストには各決済手が表示され、可用性と表示設定を示す 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 値を反映します。

連結アカウントの所有者が支払い方法を有効または無効にするときに、お客様は display_preference の preference 属性を更新できます。これにより、その支払い方法に対する連結アカウントの所有者の設定が保管されて、支払い方法を買い手に表示するかどうかの判断に使用されます。

curl https://api.stripe.com/v1/payment_method_configurations/
{{PAYMENT_METHOD_CONFIGURATION_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "affirm[display_preference][preference]"=on

{
  "id": 
"{{PAYMENT_METHOD_CONFIGURATION_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
}

連結アカウントが API を使用して支払い方法を有効にすると、買い手の場所、注文の金額、その他の要素に基づいて Stripe が支払い方法のランクをインテリジェントに決定し、最もコンバージョン率が高い支払い方法が常に最初に表示されます。

決済フローのレンダリング時に親設定 ID を渡して新しい設定を使用するようにします。

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d mode=payment \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel" \
  -d currency=usd \
  -d payment_method_configuration=
{{PAYMENT_METHOD_CONFIGURATION_ID}}