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

連結アカウントが、シナリオの違いに応じて買い手に異なる支払い方法のセットを表示できるようにする方法をご紹介します。

プラットフォームが、[動的な支払い方法](https://docs.stripe.com/connect/dynamic-payment-methods.md)を使用していて、取引のタイプや請求金額の違いに応じた異なる支払い方法の設定に対応している場合は、この機能を使用してください。取引のタイプごとにサブスクリプションまたは 1 回限りの決済を設定することや、一定のドル額を超える請求金額は BNPL を使用して支払いできるようにすることなどが考えられます。

## 新しい支払い方法の設定を作成する [ダッシュボード]

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

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

有効にする決済手段の設定がダッシュボードで `active` に設定されていることを確認する手順は、次のとおりです。

1. 決済手段の設定に移動します。
1. **決済設定** セクションで決済手段をクリックし、オーバーフローメニュー (⋯) > **設定の管理** をクリックします。
1. **設定ステータス** で、 **アクティブ** オプションを有効にします。
1. **変更を保存** をクリックして、更新を適用します。
![支払い方法の設定ページ](https://b.stripecdn.com/docs-statics-srv/assets/ppc-dashboard-demo-connect.93d78670fd3582900915ab57e3e219ec.png)

## 各支払い方法のデフォルトの状態を設定する [ダッシュボード]

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

- **On by default**: 支払い方法はデフォルトで有効です。連結アカウントが有効と無効を切り替えることができます。
- **Off by default**: 支払い方法はデフォルトで無効です。連結アカウントが有効と無効を切り替えることができます。
- **ブロック**: すべての連結アカウントの支払い方法を無効にします。連結アカウントは有効にできませんが、プラットフォームは個々の連結アカウントに対してこれを上書きできます。
![支払い方法ごとに設定を構築する](https://b.stripecdn.com/docs-statics-srv/assets/settings-api-wallets.956b27fd0756e064d433aaa5999130fe.png)

## 連結アカウントによる支払い方法のカスタマイズを許可する

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

連結アカウントが Stripe ダッシュボードではなくプラットフォームのダッシュボードから**支払い方法**設定をカスタマイズできるようにする場合、または*Stripe ダッシュボードへのアクセス権* (Platforms can provide connected accounts with access to the full Stripe Dashboard or the Express Dashboard. Otherwise, platforms build an interface for connected accounts using embedded components or the Stripe API)のない連結アカウントが存在する場合は、Payment Method Configurations API を組み込むことができます。

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

```curl
curl https://api.stripe.com/v1/payment_method_configurations/{{PAYMENTMETHODCONFIGURATION_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}"
```

```json
{
  "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` は、[ケイパビリティ](https://docs.stripe.com/api/capabilities/object.md) の値 (`active`、`inactive`、`pending` または `unrequested`) と `display_preference` の値の組み合わせです。

  `available` フィールドを使用して、Checkout で買い手にこの決済手段を表示するかどうかを確認できます。`available` が `true` の場合、決済手段のケイパビリティは有効で、`display_preference` はオンです。`available` が `false` の場合、決済手段に有効なケイパビリティがないか、`display_preference` の値がオフで、Checkout で買い手に表示されません。

  統合を簡素化し、その他の機能を利用するには、Checkout 時にダッシュボードで管理する決済手段を使用します。ダッシュボードでは、このパラメーターが自動的に読み取られ、適切な決済手段が買い手に表示されます。

- `display_preference` には、`overridable`、`preference`、`value` の 3 つのコンポーネントがあります。

  - `overridable` は読み取り専用であり、上記で設定したデフォルトを連結アカウントの設定で上書きできるかどうかを示します。
  - `preference` は書き込み可能であり、連結アカウントの設定を保存します。
  - `value` は読み取り専用で、有効な `display_preference` 値を反映します。

> 連結アカウントの国に関連する支払い方法のみが API レスポンスで表示され、設定可能です。[各国のサポート状況をご確認ください](https://docs.stripe.com/payments/payment-methods/integration-options.md)。

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

```curl
curl https://api.stripe.com/v1/payment_method_configurations/{{PAYMENTMETHODCONFIGURATION_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "affirm[display_preference][preference]=on"
```

```json
{
  "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 を渡して新しい設定を使用するようにします。

#### Checkout

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

#### Payment Element

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d amount=1099 \
  -d currency=usd \
  -d "automatic_payment_methods[enabled]=true" \
  -d "payment_method_configuration={{PAYMENTMETHODCONFIGURATION_ID}}"
```

[インテント作成猶予の導入パス](https://docs.stripe.com/payments/accept-a-payment-deferred.md)を使用して Payment Element を使用する場合は、Element セッションオプションに親 ID を渡すことができます。

```javascript
const options = {
   mode: 'payment',
   amount: 1099,
   currency: 'usd',
   payment_method_configuration: ''{{PAYMENT_METHOD_CONFIGURATION_ID}}''
}
```

## Optional: Apple Pay および Google Pay

Apple Payと Google Pay は、PaymentIntent に単独の決済手段タイプとして含まれていないため、カードが指定されるときにのみ確定されます。Payment Method Configurations API を使用すると、連結アカウントの所有者がこれらの特定の決済手段をオプトインまたはオプトアウトして、UI に表示されないように設定できます。Apple Pay と Google Pay を使用できるようにするには、カードを有効化する必要があります。