# 支払い方法の設定 連結アカウントが購入時に提供できる設定可能な支払い方法のリストを表示します。 連結アカウントの[支払い方法の設定](https://docs.stripe.com/api/payment_method_configurations.md)を表示して、購入時に表示される支払い方法をカスタマイズできるようにします。連結アカウントは、購入時の支払い方法をカスタマイズし、その利用に関して必要な法令遵守の詳細を提供できます。 > この Connect 組み込みコンポーネントは、現在プライベートプレビュー段階です。コンポーネントが利用可能になった際に通知を受け取るには、以下から[購読](https://docs.stripe.com/connect/supported-embedded-components/payment-method-settings.md#next-steps)してください。 Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production. > 埋め込みコンポーネントでは、次の支払い方法に対応しています。 > > - ACH Direct Debit - Affirm - Afterpay Clearpay - Amazon Pay - Apple Pay - カナダのプレオーソリデビット - Bancontact - BLIK - カード - EPS - Google Pay - iDEAL - Klarna - Link - P24 - Zip 埋込型支払い方法の設定は、[Payment Method Configurations](https://docs.stripe.com/connect/payment-method-configurations.md) API と [Account Capabilities](https://docs.stripe.com/connect/account-capabilities.md) APIを使用して、カスタマイズ可能な支払い方法のリストを連結アカウントに表示します。連結アカウントが支払い方法の [Capability](https://docs.stripe.com/api/capabilities/object.md) をリクエストする前に、追加の法令遵守データを必要とする場合、コンポーネントはこれを示し、必要な情報を事前に収集します。 ## 要件 貴社で構築済みの Stripe システムでは、[動的な支払い方法](https://docs.stripe.com/connect/dynamic-payment-methods.md)を使用して、決済時に連結アカウントの設定を自動的に適用する必要があります。[Payment Element](https://stripe.com/payments/elements) や [Checkout](https://stripe.com/payments/checkout) などの構築済みの決済 UI では、Stripe は、取引ごとに対象の支払い方法を表示するためのロジックを処理します。 Stripe SDK (ベータバージョン) をインストールして、非公開プレビュー版のコンポーネントのアカウントセッションを作成します。 - [Ruby](https://github.com/stripe/stripe-ruby/#public-preview-sdks) `>=15.5.0-beta.1` - [Python](https://github.com/stripe/stripe-python/#public-preview-sdks) `>=12.5.0b1` - [PHP](https://github.com/stripe/stripe-php/#public-preview-sdks) `>=17.6.0-beta.1` - [ノード](https://github.com/stripe/stripe-node/#public-preview-sdks)`>=18.5.0-beta.1` - [.NET](https://github.com/stripe/stripe-dotnet#public-preview-sdks) `>=48.5.0-beta.1` - [Java](https://github.com/stripe/stripe-java#public-preview-sdks) `>=29.5.0-beta.1` - [進む](https://github.com/stripe/stripe-go#public-preview-sdks) `>=82.5.0-beta.1` Stripe のクライアント側ライブラリ (ベータバージョン) を使用して、非公開プレビュー版のコンポーネントをレンダリングします。 #### npm ライブラリをインストールします。 ```bash npm install --save @stripe/connect-js@preview ``` アプリケーションで React を使用している場合は、以下のようにします。 ```bash npm install --save @stripe/react-connect-js@preview ``` #### GitHub [@stripe/connect-js](https://github.com/stripe/connect-js) ライブラリと [@stripe/react-connect-js](https://github.com/stripe/react-connect-js) ライブラリのソースコードを GitHub から直接ダウンロードします。 ## コンポーネントを導入する [アカウントセッションを作成する](https://docs.stripe.com/api/account_sessions/create.md)ときに、`components` パラメーターに `payment_method_settings` を指定して決済手段の設定を有効にします。 ```curl curl https://api.stripe.com/v1/account_sessions \ -u "<>:" \ -H "Stripe-Version: 2026-04-22.preview; embedded_connect_beta=v2;" \ -d "account={{CONNECTEDACCOUNT_ID}}" \ -d "components[payment_method_settings][enabled]=true" ``` アカウントセッションを作成し、[ConnectJS を初期化](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions)すると、フロントエンドに決済手段の設定コンポーネントを表示できます。 #### JavaScript ```js // Include this element in your HTML const paymentMethodSettings = stripeConnectInstance.create('payment-method-settings'); container.appendChild(paymentMethodSettings); ``` ### プラットフォームレベルの管理 支払い方法の設定の埋め込みコンポーネントは、[ダッシュボード](https://docs.stripe.com/connect/payment-methods.md) または [Payment Method Configurations API](https://docs.stripe.com/connect/payment-method-configurations.md) で設定したプラットフォームレベルのデフォルトを考慮します。 **デフォルトで有効にする** または **デフォルトで無効にする** に設定された決済手段の場合、連結アカウントはコンポーネント内のその設定を上書きできます。決済手段を **ブロック済み** に設定すると、コンポーネント内で完全に非表示になります。 ### 複数の支払い方法の設定 デフォルトの設定では、埋込型の支払い方法の設定コンポーネントに連結アカウントのデフォルトの支払い方法の設定が表示されます。プレビュー期間中、コンポーネントでは `payment-method-configuration` 属性を持つ[複数の設定](https://docs.stripe.com/connect/multiple-payment-method-configurations.md)がサポートされます。 ### サポートされているパラメーター この組み込みコンポーネントは、次のパラメーターに対応します。 #### HTML + JS | 方法 | タイプ | 説明 | | | ------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- | | `setPaymentMethodConfiguration` | `string` | コンポーネントに表示する決済手段の設定 ID を設定します。連結アカウントが所有するすべての決済手段の設定を渡すことができます。このパラメーターを設定しない場合、組み込みコンポーネントは、プラットフォームの設定を継承した、連結アカウントのデフォルトの決済手段の設定を表示します。詳細については、[決済手段の設定](https://docs.stripe.com/payments/payment-method-configurations.md) または [決済手段の設定を一覧表示する](https://docs.stripe.com/api/payment_method_configurations/list.md) をご覧ください。 | 任意 | | #### React | React プロパティ | タイプ | 説明 | | | ---------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- | | `paymentMethodConfiguration` | `string` | コンポーネントに表示される決済手段の設定 ID。連結アカウントが所有するすべての決済手段の設定を渡すことができます。このパラメーターを設定しない場合、組み込みコンポーネントは、プラットフォームの設定を継承した、連結アカウントのデフォルトの決済手段の設定を表示します。詳細については、[決済手段の設定](https://docs.stripe.com/payments/payment-method-configurations.md) または[決済手段の設定を一覧表示する](https://docs.stripe.com/api/payment_method_configurations/list.md) をご覧ください。 | 任意 | ## 次のステップ (プライベートプレビュー) サインインして、この Connect 組み込みコンポーネントに関する更新を購読してください。 Stripe アカウントがない場合は、[こちらから登録](https://dashboard.stripe.com/register)できます。 ## See also - [Connect の導入ガイド](https://docs.stripe.com/connect/charges.md) - [動的な支払い方法にアップグレードする](https://docs.stripe.com/connect/dynamic-payment-methods.md) - [Payment Method Configurations API](https://docs.stripe.com/connect/payment-method-configurations.md) - [アカウントのケイパビリティ API](https://docs.stripe.com/connect/account-capabilities.md)