支払い方法の設定非公開プレビュー

連結アカウントの支払い方法の設定を表示して、購入時に表示される支払い方法をカスタマイズできるようにします。連結アカウントは、購入時の支払い方法をカスタマイズし、その利用に関して必要な法令遵守の詳細を提供できます。

埋込型支払い方法の設定は、Payment Method Configurations API と Account Capabilities APIを使用して、カスタマイズ可能な支払い方法のリストを連結アカウントに表示します。連結アカウントが支払い方法の Capability をリクエストする前に、追加の法令遵守データを必要とする場合、コンポーネントはこれを示し、必要な情報を事前に収集します。

要件

貴社で構築済みの Stripe システムでは、動的な支払い方法を使用して、決済時に連結アカウントの設定を自動的に適用する必要があります。Payment Element や Checkout などの構築済みの決済 UI では、Stripe は、取引ごとに対象の支払い方法を表示するためのロジックを処理します。

Stripe SDK (ベータバージョン) をインストールして、非公開プレビュー版のコンポーネントのアカウントセッションを作成します。

• Ruby >=15.3.0-beta.1
• Python >=12.3.0b1
• PHP >=17.4.0-beta.1
• Node >=18.3.0-beta.1
• .NET >=48.3.0-beta.1
• Java >=29.3.0-beta.1
• Go >=82.3.0-beta.1

Stripe のクライアント側ライブラリ (ベータバージョン) を使用して、非公開プレビュー版のコンポーネントをレンダリングします。

コンポーネントを導入する

アカウントセッションを作成するときに、components パラメーターに payment_method_settings を指定して決済手段の設定を有効にします。

curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-06-30.basil; embedded_connect_beta=v2;" \
  -d account=
{{CONNECTED_ACCOUNT_ID}} \
  -d "components[payment_method_settings][enabled]"=true

アカウントセッションを作成し、ConnectJS を初期化すると、フロントエンドに決済手段の設定コンポーネントを表示できます。

// Include this element in your HTML
const paymentMethodSettings = stripeConnectInstance.create('payment-method-settings');
container.appendChild(paymentMethodSettings);

プラットフォームレベルの管理

支払い方法の設定の埋め込みコンポーネントは、ダッシュボード または Payment Method Configurations API で設定したプラットフォームレベルのデフォルトを考慮します。

デフォルトで有効にするまたはデフォルトで無効にするに設定された支払い方法の場合、連結アカウントはコンポーネント内のその設定を上書きできます。支払い方法をブロック済みに設定すると、コンポーネント内で完全に非表示になります。

複数の支払い方法の設定

デフォルトの設定では、埋込型の支払い方法の設定コンポーネントに連結アカウントのデフォルトの支払い方法の設定が表示されます。プレビュー期間中、コンポーネントでは payment-method-configuration 属性を持つ複数の設定がサポートされます。

サポートされているパラメーター

この組み込みコンポーネントは、次のパラメーターに対応します。

早期アクセスをリクエストする プライベートプレビュー

サインインして、プレビュー版の Connect の埋込型コンポーネントへのアクセスをリクエストします。

Stripe アカウントがない場合は、こちらから登録できます。