# 動的な決済手段を使用するために更新する 既存のプラットフォームに動的な決済手段を追加します。 このガイドでは、既存のプラットフォームに動的な決済手段を導入する方法をご説明します。新しいプラットフォームを設定している場合は、最初に [Connect 連携ガイド](https://docs.stripe.com/connect/interactive-platform-guide.md)をご覧ください。 ## 動的な支払い方法の導入手順 以下のフォームを使用して組み込みを選択します。決済ソリューション、連結アカウントのタイプ、支払いタイプなど、プラットフォーム設定の決定についてご不明な点がある場合は、[支払いを作成する](https://docs.stripe.com/connect/charges.md)をご覧ください。 ## 連結アカウントの支払い方法を有効にする [推奨] 必要な場合は、支払い方法の情報に関する次のリソースをご覧ください。 - 自社のプラットフォームに適した支払い方法を選択するには、[支払い方法ガイド](https://stripe.com/payments/payment-methods-guide#choosing-the-right-payment-methods-for-your-business)をご覧ください。 - [アカウントのケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md) を使用して、選択した決済手段が連結アカウントで機能することを確認します。 - [決済手段と製品サポート](https://docs.stripe.com/payments/payment-methods/payment-method-support.md#product-support)の表を参照して、選択した決済手段が使用中の Stripe プロダクトと決済フローで機能することを確認します。 Stripe は連結アカウントに対して特定の決済手段をデフォルトで有効にします。ダッシュボードの[連結アカウントの決済手段を管理する](https://dashboard.stripe.com/settings/payment_methods/connected_accounts)ページに移動して、連結アカウントで受け付ける決済手段を設定します。デフォルト設定への変更は、新規および既存のすべての連結アカウントに適用されます。 支払い方法ごとに、次のいずれかのドロップダウンオプションを選択できます。 | | | | | **デフォルトで有効にする** | 連結アカウントは、決済フローでこの支払い方法に対応します。一部の支払い方法は、プラットフォームの連結アカウントの所有者がダッシュボードの設定ページで有効化する必要があるため、無効またはブロックになっている可能性があります。 | | **デフォルトで無効にする** | 連結アカウントは、決済フローでこの支払い方法に対応しません。プラットフォームの連結アカウントの所有者がダッシュボードで独自の支払い方法を管理することを許可されていても、連結アカウントはこれを有効にできません。 | | **ブロック済み** | 連結アカウントは、決済フローでこの支払い方法に対応しません。プラットフォームの連結アカウントの所有者がダッシュボードで独自の支払い方法を管理することを許可していても、連結アカウントはこれを有効にできません。 | ![支払い方法のドロップダウンオプション。支払い方法ごとに選択可能なオプション (ブロック済み、デフォルトで有効にする、デフォルトで無効にする) を示します。](https://b.stripecdn.com/docs-statics-srv/assets/dropdowns.ef651d721d5939d81521dd34dde4577f.png) 支払い方法のオプション 支払い方法を変更した場合は、画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、連結アカウントを更新する必要があります。 ![保存ボタンをクリックした後に表示される、ユーザーが変更した内容のリストを含むダイアログ](https://b.stripecdn.com/docs-statics-srv/assets/dialog.a56ea7716f60db9778706790320d13be.png) ダイアログを保存する ## 連結アカウントによる支払い方法の管理を許可する [推奨] Stripe では、プラットフォームの連結アカウントの所有者がダッシュボードから独自の支払い方法をカスタマイズできるようにすることをお勧めしています。このオプションを有効にすると、Stripe ダッシュボードにアクセスできる各連結アカウントが各自のダッシュボードにログインして[支払い方法](https://dashboard.stripe.com/settings/payment_methods)ページを表示できるようになります。ダッシュボードには、新規および既存のすべての連結アカウントに対して適用される支払い方法のデフォルトのセットが表示されます。プラットフォームの連結アカウントの所有者は、お客様がブロックした支払い方法を除き、これらのデフォルトを上書きできます。 このオプションを有効にするには、**アカウントのカスタマイズ**チェックボックスを選択します。画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、この設定を更新する必要があります。 ![連結アカウントの所有者に支払い方法のカスタマイズを許可する際に選択するチェックボックスのスクリーンショット](https://b.stripecdn.com/docs-statics-srv/assets/checkbox.275bd35d2a025272f03af029a144e577.png) アカウントのカスタマイズのチェックボックス ## 動的な支払い方法を使用して Checkout を実装する [必須] これまでは、Checkout セッションを定義するときに、`payment_method_types` パラメーターを使用して、さまざまな支払い方法に対応していたかもしれません。ダッシュボードで支払い方法の管理を開始するには、組み込みからこのパラメーターを削除します。 実装から `payment_method_types` パラメーターを削除すると、カードやウォレットなどの一部の支払い方法は自動的に有効になります。`currency` パラメーターにより、購入セッションの際に顧客に提示される支払い方法が制限されます。 #### Ruby ```ruby # Don't put any keys in code. See https://docs.stripe.com/keys-best-practices. # Find your keys at https://dashboard.stripe.com/apikeys. client = Stripe::StripeClient.new('<>') client.v1.checkout.sessions.create({ mode: 'payment', line_items: [{ price_data: { # The currency parameter determines which # payment methods are used in the Checkout Session. currency: 'eur', product_data: { name: 'T-shirt', }, unit_amount: 2000, }, quantity: 1, }], success_url: 'https://example.com/success', }) ``` ## Checkout で配送先住所の収集を有効にする [推奨] [配送先住所](https://docs.stripe.com/payments/collect-addresses.md?payment-ui=checkout)を収集する場合は、チェックアウトセッションの作成時に配送先の国を定義する必要があります。`shipping_address_collection.allowed_countries` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection-allowed_countries)で 2 文字の ISO 国コードを指定します。 必要に応じて、`shipping_options` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_options)を使用して配送料を追加できます。 Afterpay または Clearpay を使用している場合は配送先住所を収集する必要がありますが、これらの支払い方法で配送料金を指定する必要はありません。 > Checkout の支払い方法として Afterpay または Clearpay を使用するために、配送先住所を収集する必要がありますが、配送料金は不要です。 ## 通知遅延型の支払い方法を処理する (該当する場合) [推奨] [通知遅延型の決済手段を処理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)方法については、[ダッシュボードで決済手段を管理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)ステップに従ってください。 ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。いずれかのテストアカウントにログインして **決済手段** の設定に移動し、連結アカウントの設定を表示します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## Stripe ダッシュボードにアクセスできる連結アカウントが、設定ステップを必要とする支払い方法を有効化できるようにする [オプション] Stripe ダッシュボードにアクセスできる連結アカウントは、ほぼすべての決済手段をデフォルトで使用できます。ただし、一部の決済手段 (Alipay や WeChat Pay など) は、ユーザーがダッシュボードから手動で有効化にする必要があります。[決済手段ケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)の表を使用して、どの決済手段手動で有効化する必要があるかを確認します。**デフォルトで利用可能** 列に **いいえ** と表示されている場合、その決済手段を手動で有効化する必要があります。 プラットフォームの連結アカウントの所有者に対して支払い方法の管理を許可する場合は、これらの支払い方法を[ダッシュボード](https://dashboard.stripe.com/settings/payment_methods)から有効にするように指示します。 ![ダッシュボードを介した、連結アカウントの支払い方法のカスタマイズのスクリーンショット。利用可能な支払い方法が有効であり、利用可能であることを示します。](https://b.stripecdn.com/docs-statics-srv/assets/turn-on-payments.afef26196ebae8f5564d328d6ba73b92.png) 支払い方法のカスタマイズ プラットフォームの連結アカウントの所有者に対して支払い方法のカスタマイズを許可しない場合は、[手動の設定ページ](https://dashboard.stripe.com/settings/payment_methods)にアクセスするように指示します。 ![支払い方法が一覧表示された手動設定ページのスクリーンショット。アクセスのリクエスト、招待のリクエスト、設定を行うためのオプションを含みます。](https://b.stripecdn.com/docs-statics-srv/assets/manual-settings.db0a0c2abebb94e197e1bef683ea7db9.png) 支払い方法の手動設定 > **埋め込み支払い方法設定コンポーネント**を使用すると、接続アカウントは Stripe ダッシュボードにアクセスすることなく、Checkout で提供する支払い方法を設定できます。[埋め込み支払い方法設定コンポーネント](https://docs.stripe.com/connect/supported-embedded-components/payment-method-settings.md)の詳細を確認し、利用可能になった際に通知を受け取ってください。 ## 連結アカウントが支払い方法を受け付けるための条件を満たしていることを確認する [必須] で `on_behalf_of` パラメーターが使用されている場合、プラットフォームで連結アカウントを所有する売り手またはサービスプロバイダーは、ダイレクト支払いによる ノーコードのソリューションの場合、新しいアカウントの[連結アカウントの決済の設定ページ](https://docs.stripe.com/connect/payment-methods.md)でオプションを設定して、決済手段と国の組み合わせごとに新規と既存の連結アカウントのケイパビリティをリクエストします。 API システムでは、[ケイパビリティエンドポイント](https://docs.stripe.com/api/capabilities/update.md)を使用して、受け付ける決済手段ごとに新規と既存の連結アカウントの決済手段ケイパビリティをリクエストします。新規アカウントでケイパビリティのリクエストを開始すると、既存のアカウントより前に、自動設定によって決済手段を受け付けることができます。 ほとんどの決済手段にはカードと同じ確認要件がありますが、いくつかの制限と例外があります。[決済手段ケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)の表には、カードの追加確認が必要な決済手段がリストされています。 [Capabilities endpoints](https://docs.stripe.com/api/capabilities/list.md) を使用して、各アカウントがデフォルトで使用できる [payment method capabilities](https://docs.stripe.com/connect/account-capabilities.md#payment-methods) ケイパビリティに関するクエリを実行できます。使用できるケイパビリティは、アカウントの国やその他の要因によって異なる場合があります。 ```curl curl -X POST https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" ``` レスポンスには、`capabilities` ハッシュと、連結アカウントの現在のケイパビリティのステータスが含まれています。 ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", ..."capabilities": { "card_payments": "active", "ideal_payments": "active", "sepa_debit_payments": "pending", "transfers": "active" }, ... } ``` ## 連結アカウントの支払い方法を有効にする [推奨] 必要な場合は、支払い方法の情報に関する次のリソースをご覧ください。 - 自社のプラットフォームに適した支払い方法を選択するには、[支払い方法ガイド](https://stripe.com/payments/payment-methods-guide#choosing-the-right-payment-methods-for-your-business)をご覧ください。 - [アカウントのケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md) を使用して、選択した決済手段が連結アカウントで機能することを確認します。 - [決済手段と製品サポート](https://docs.stripe.com/payments/payment-methods/payment-method-support.md#product-support)の表を参照して、選択した決済手段が使用中の Stripe プロダクトと決済フローで機能することを確認します。 Stripe は連結アカウントに対して特定の決済手段をデフォルトで有効にします。ダッシュボードの[連結アカウントの決済手段を管理する](https://dashboard.stripe.com/settings/payment_methods/connected_accounts)ページに移動して、連結アカウントで受け付ける決済手段を設定します。デフォルト設定への変更は、新規および既存のすべての連結アカウントに適用されます。 支払い方法ごとに、次のいずれかのドロップダウンオプションを選択できます。 | | | | | **デフォルトで有効にする** | 連結アカウントは、決済フローでこの支払い方法に対応します。一部の支払い方法は、無効またはブロックになっている可能性があります。 | | **デフォルトで無効にする** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | | **ブロック済み** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | ![支払い方法のドロップダウンオプション。支払い方法ごとに選択可能なオプション (ブロック済み、デフォルトで有効にする、デフォルトで無効にする) を示します。](https://b.stripecdn.com/docs-statics-srv/assets/dropdowns.ef651d721d5939d81521dd34dde4577f.png) 支払い方法のオプション 支払い方法を変更した場合は、画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、連結アカウントを更新する必要があります。 ![保存ボタンをクリックした後に表示される、ユーザーが変更した内容のリストを含むダイアログ](https://b.stripecdn.com/docs-statics-srv/assets/dialog.a56ea7716f60db9778706790320d13be.png) ダイアログを保存する ## 動的な支払い方法を使用して Checkout を実装する [必須] これまでは、Checkout セッションを定義するときに、`payment_method_types` パラメーターを使用して、さまざまな支払い方法に対応していたかもしれません。ダッシュボードで支払い方法の管理を開始するには、組み込みからこのパラメーターを削除します。 実装から `payment_method_types` パラメーターを削除すると、カードやウォレットなどの一部の支払い方法は自動的に有効になります。`currency` パラメーターにより、購入セッションの際に顧客に提示される支払い方法が制限されます。 #### Ruby ```ruby # Don't put any keys in code. See https://docs.stripe.com/keys-best-practices. # Find your keys at https://dashboard.stripe.com/apikeys. client = Stripe::StripeClient.new('<>') client.v1.checkout.sessions.create({ mode: 'payment', line_items: [{ price_data: { # The currency parameter determines which # payment methods are used in the Checkout Session. currency: 'eur', product_data: { name: 'T-shirt', }, unit_amount: 2000, }, quantity: 1, }], success_url: 'https://example.com/success', }) ``` ## Checkout で配送先住所の収集を有効にする [推奨] [配送先住所](https://docs.stripe.com/payments/collect-addresses.md?payment-ui=checkout)を収集する場合は、チェックアウトセッションの作成時に配送先の国を定義する必要があります。`shipping_address_collection.allowed_countries` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection-allowed_countries)で 2 文字の ISO 国コードを指定します。 必要に応じて、`shipping_options` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_options)を使用して配送料を追加できます。 Afterpay または Clearpay を使用している場合は配送先住所を収集する必要がありますが、これらの支払い方法で配送料金を指定する必要はありません。 > Checkout の支払い方法として Afterpay または Clearpay を使用するために、配送先住所を収集する必要がありますが、配送料金は不要です。 ## 通知遅延型の支払い方法を処理する (該当する場合) [推奨] [通知遅延型の決済手段を処理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)方法については、[ダッシュボードで決済手段を管理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)ステップに従ってください。 ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## 連結アカウントが支払い方法を受け付けるための条件を満たしていることを確認する [必須] で `on_behalf_of` パラメーターが使用されている場合、プラットフォームで連結アカウントを所有する売り手またはサービスプロバイダーは、ダイレクト支払いによる ノーコードのソリューションの場合、新しいアカウントの [Express 設定](https://dashboard.stripe.com/settings/connect/express)または[連結アカウントの決済の設定ページ](https://docs.stripe.com/connect/payment-methods.md)でオプションを設定して、決済手段と国の組み合わせごとに新規と既存の連結アカウントのケイパビリティをリクエストします。 API システムでは、[ケイパビリティエンドポイント](https://docs.stripe.com/api/capabilities/update.md)を使用して、受け付ける決済手段ごとに新規と既存の連結アカウントの決済手段ケイパビリティをリクエストします。新規アカウントでケイパビリティのリクエストを開始すると、既存のアカウントより前に、自動設定によって決済手段を受け付けることができます。 ほとんどの決済手段にはカードと同じ確認要件がありますが、いくつかの制限と例外があります。[決済手段ケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)の表には、カードの追加確認が必要な決済手段がリストされています。 [Capabilities endpoints](https://docs.stripe.com/api/capabilities/list.md) を使用して、各アカウントがデフォルトで使用できる [payment method capabilities](https://docs.stripe.com/connect/account-capabilities.md#payment-methods) ケイパビリティに関するクエリを実行できます。使用できるケイパビリティは、アカウントの国やその他の要因によって異なる場合があります。 ```curl curl -X POST https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" ``` レスポンスには、`capabilities` ハッシュと、連結アカウントの現在のケイパビリティのステータスが含まれています。 ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", ..."capabilities": { "card_payments": "active", "ideal_payments": "active", "sepa_debit_payments": "pending", "transfers": "active" }, ... } ``` ## 連結アカウントの支払い方法を有効にする [推奨] 必要な場合は、支払い方法の情報に関する次のリソースをご覧ください。 - 自社のプラットフォームに適した支払い方法を選択するには、[支払い方法ガイド](https://stripe.com/payments/payment-methods-guide#choosing-the-right-payment-methods-for-your-business)をご覧ください。 - [アカウントのケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md) を使用して、選択した決済手段が連結アカウントで機能することを確認します。 - [決済手段と製品サポート](https://docs.stripe.com/payments/payment-methods/payment-method-support.md#product-support)の表を参照して、選択した決済手段が使用中の Stripe プロダクトと決済フローで機能することを確認します。 Stripe は連結アカウントに対して特定の決済手段をデフォルトで有効にします。ダッシュボードの[連結アカウントの決済手段を管理する](https://dashboard.stripe.com/settings/payment_methods/connected_accounts)ページに移動して、連結アカウントで受け付ける決済手段を設定します。デフォルト設定への変更は、新規および既存のすべての連結アカウントに適用されます。 支払い方法ごとに、次のいずれかのドロップダウンオプションを選択できます。 | | | | | **デフォルトで有効にする** | 連結アカウントは、決済フローでこの支払い方法に対応します。一部の支払い方法は、無効またはブロックになっている可能性があります。 | | **デフォルトで無効にする** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | | **ブロック済み** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | ![支払い方法のドロップダウンオプション。支払い方法ごとに選択可能なオプション (ブロック済み、デフォルトで有効にする、デフォルトで無効にする) を示します。](https://b.stripecdn.com/docs-statics-srv/assets/dropdowns.ef651d721d5939d81521dd34dde4577f.png) 支払い方法のオプション 支払い方法を変更した場合は、画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、連結アカウントを更新する必要があります。 ![保存ボタンをクリックした後に表示される、ユーザーが変更した内容のリストを含むダイアログ](https://b.stripecdn.com/docs-statics-srv/assets/dialog.a56ea7716f60db9778706790320d13be.png) ダイアログを保存する ## 動的な支払い方法を使用して Checkout を実装する [必須] これまでは、Checkout セッションを定義するときに、`payment_method_types` パラメーターを使用して、さまざまな支払い方法に対応していたかもしれません。ダッシュボードで支払い方法の管理を開始するには、組み込みからこのパラメーターを削除します。 実装から `payment_method_types` パラメーターを削除すると、カードやウォレットなどの一部の支払い方法は自動的に有効になります。`currency` パラメーターにより、購入セッションの際に顧客に提示される支払い方法が制限されます。 #### Ruby ```ruby # Don't put any keys in code. See https://docs.stripe.com/keys-best-practices. # Find your keys at https://dashboard.stripe.com/apikeys. client = Stripe::StripeClient.new('<>') client.v1.checkout.sessions.create({ mode: 'payment', line_items: [{ price_data: { # The currency parameter determines which # payment methods are used in the Checkout Session. currency: 'eur', product_data: { name: 'T-shirt', }, unit_amount: 2000, }, quantity: 1, }], success_url: 'https://example.com/success', }) ``` ## Checkout で配送先住所の収集を有効にする [推奨] [配送先住所](https://docs.stripe.com/payments/collect-addresses.md?payment-ui=checkout)を収集する場合は、チェックアウトセッションの作成時に配送先の国を定義する必要があります。`shipping_address_collection.allowed_countries` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection-allowed_countries)で 2 文字の ISO 国コードを指定します。 必要に応じて、`shipping_options` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_options)を使用して配送料を追加できます。 Afterpay または Clearpay を使用している場合は配送先住所を収集する必要がありますが、これらの支払い方法で配送料金を指定する必要はありません。 > Checkout の支払い方法として Afterpay または Clearpay を使用するために、配送先住所を収集する必要がありますが、配送料金は不要です。 ## 通知遅延型の支払い方法を処理する (該当する場合) [推奨] [通知遅延型の決済手段を処理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)方法については、[ダッシュボードで決済手段を管理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)ステップに従ってください。 ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 > Stripe では、Stripe ダッシュボードにアクセスできる連結アカウントに対して、デスティネーション支払いではなくダイレクト支払いを使用することを推奨しています。詳細については、[支払いタイプ](https://docs.stripe.com/connect/charges.md#types)をご覧ください。 ## 連結アカウントの支払い方法を有効にする [推奨] 必要な場合は、支払い方法の情報に関する次のリソースをご覧ください。 - 自社のプラットフォームに適した支払い方法を選択するには、[支払い方法ガイド](https://stripe.com/payments/payment-methods-guide#choosing-the-right-payment-methods-for-your-business)をご覧ください。 - [アカウントのケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md) を使用して、選択した決済手段が連結アカウントで機能することを確認します。 - [決済手段と製品サポート](https://docs.stripe.com/payments/payment-methods/payment-method-support.md#product-support)の表を参照して、選択した決済手段が使用中の Stripe プロダクトと決済フローで機能することを確認します。 Stripe は連結アカウントに対して特定の決済手段をデフォルトで有効にします。ダッシュボードの[連結アカウントの決済手段を管理する](https://dashboard.stripe.com/settings/payment_methods/connected_accounts)ページに移動して、連結アカウントで受け付ける決済手段を設定します。デフォルト設定への変更は、新規および既存のすべての連結アカウントに適用されます。 支払い方法ごとに、次のいずれかのドロップダウンオプションを選択できます。 | | | | | **デフォルトで有効にする** | 連結アカウントは、決済フローでこの支払い方法に対応します。一部の支払い方法は、プラットフォームの連結アカウントの所有者がダッシュボードの設定ページで有効化する必要があるため、無効またはブロックになっている可能性があります。 | | **デフォルトで無効にする** | 連結アカウントは、決済フローでこの支払い方法に対応しません。プラットフォームの連結アカウントの所有者がダッシュボードで独自の支払い方法を管理することを許可されていても、連結アカウントはこれを有効にできません。 | | **ブロック済み** | 連結アカウントは、決済フローでこの支払い方法に対応しません。プラットフォームの連結アカウントの所有者がダッシュボードで独自の支払い方法を管理することを許可していても、連結アカウントはこれを有効にできません。 | ![支払い方法のドロップダウンオプション。支払い方法ごとに選択可能なオプション (ブロック済み、デフォルトで有効にする、デフォルトで無効にする) を示します。](https://b.stripecdn.com/docs-statics-srv/assets/dropdowns.ef651d721d5939d81521dd34dde4577f.png) 支払い方法のオプション 支払い方法を変更した場合は、画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、連結アカウントを更新する必要があります。 ![保存ボタンをクリックした後に表示される、ユーザーが変更した内容のリストを含むダイアログ](https://b.stripecdn.com/docs-statics-srv/assets/dialog.a56ea7716f60db9778706790320d13be.png) ダイアログを保存する ## 連結アカウントによる支払い方法の管理を許可する [推奨] Stripe では、プラットフォームの連結アカウントの所有者がダッシュボードから独自の支払い方法をカスタマイズできるようにすることをお勧めしています。このオプションを有効にすると、Stripe ダッシュボードにアクセスできる各連結アカウントが各自のダッシュボードにログインして[支払い方法](https://dashboard.stripe.com/settings/payment_methods)ページを表示できるようになります。ダッシュボードには、新規および既存のすべての連結アカウントに対して適用される支払い方法のデフォルトのセットが表示されます。プラットフォームの連結アカウントの所有者は、お客様がブロックした支払い方法を除き、これらのデフォルトを上書きできます。 このオプションを有効にするには、**アカウントのカスタマイズ**チェックボックスを選択します。画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、この設定を更新する必要があります。 ![連結アカウントの所有者に支払い方法のカスタマイズを許可する際に選択するチェックボックスのスクリーンショット](https://b.stripecdn.com/docs-statics-srv/assets/checkbox.275bd35d2a025272f03af029a144e577.png) アカウントのカスタマイズのチェックボックス ## 動的な支払い方法を使用して Checkout を実装する [必須] これまでは、Checkout セッションを定義するときに、`payment_method_types` パラメーターを使用して、さまざまな支払い方法に対応していたかもしれません。ダッシュボードで支払い方法の管理を開始するには、組み込みからこのパラメーターを削除します。 実装から `payment_method_types` パラメーターを削除すると、カードやウォレットなどの一部の支払い方法は自動的に有効になります。`currency` パラメーターにより、購入セッションの際に顧客に提示される支払い方法が制限されます。 #### Ruby ```ruby # Don't put any keys in code. See https://docs.stripe.com/keys-best-practices. # Find your keys at https://dashboard.stripe.com/apikeys. client = Stripe::StripeClient.new('<>') client.v1.checkout.sessions.create({ mode: 'payment', line_items: [{ price_data: { # The currency parameter determines which # payment methods are used in the Checkout Session. currency: 'eur', product_data: { name: 'T-shirt', }, unit_amount: 2000, }, quantity: 1, }], success_url: 'https://example.com/success', }) ``` ## Checkout で配送先住所の収集を有効にする [推奨] [配送先住所](https://docs.stripe.com/payments/collect-addresses.md?payment-ui=checkout)を収集する場合は、チェックアウトセッションの作成時に配送先の国を定義する必要があります。`shipping_address_collection.allowed_countries` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection-allowed_countries)で 2 文字の ISO 国コードを指定します。 必要に応じて、`shipping_options` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_options)を使用して配送料を追加できます。 Afterpay または Clearpay を使用している場合は配送先住所を収集する必要がありますが、これらの支払い方法で配送料金を指定する必要はありません。 > Checkout の支払い方法として Afterpay または Clearpay を使用するために、配送先住所を収集する必要がありますが、配送料金は不要です。 ## 通知遅延型の支払い方法を処理する (該当する場合) [推奨] [通知遅延型の決済手段を処理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)方法については、[ダッシュボードで決済手段を管理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)ステップに従ってください。 ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。いずれかのテストアカウントにログインして **決済手段** の設定に移動し、連結アカウントの設定を表示します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## Stripe ダッシュボードにアクセスできる連結アカウントが、設定ステップを必要とする支払い方法を有効化できるようにする [オプション] [決済手段の機能](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)の表には、使用前に手動で有効化する必要がある決済手段と、カードに加えて必要な確認要件が記載されています。プラットフォームの連結アカウントの所有者に、[手動設定ページ](https://dashboard.stripe.com/settings/payment_methods)にアクセスして、Stripe ダッシュボードにアクセスできる連結アカウントでデフォルトでは利用できない決済手段を有効にするよう案内します。 ![支払い方法が一覧表示された手動設定ページのスクリーンショット。アクセスのリクエスト、招待のリクエスト、設定を行うためのオプションを含みます。](https://b.stripecdn.com/docs-statics-srv/assets/manual-settings.db0a0c2abebb94e197e1bef683ea7db9.png) 支払い方法の手動設定 > **埋め込み支払い方法設定コンポーネント**を使用すると、接続アカウントは Stripe ダッシュボードにアクセスすることなく、Checkout で提供する支払い方法を設定できます。[埋め込み支払い方法設定コンポーネント](https://docs.stripe.com/connect/supported-embedded-components/payment-method-settings.md)の詳細を確認し、利用可能になった際に通知を受け取ってください。 > Stripe では、Stripe ダッシュボードにアクセスできる連結アカウントに対して、デスティネーション支払いではなくダイレクト支払いを使用することを推奨しています。詳細については、[支払いタイプ](https://docs.stripe.com/connect/charges.md#types)をご覧ください。 ## 購入時に利用できる支払い方法を選択する [推奨] ダッシュボードの[支払い方法](https://dashboard.stripe.com/settings/payment_methods)ページから、アカウントの支払い方法を設定します。連結アカウントは支払い方法をカスタマイズできません。 ## 動的な支払い方法を使用して Checkout を実装する [必須] 前セクションのオプションのステップを実装した後に、自動パラメーターを組み込む準備が整います。[Checkout の実装を更新する](https://docs.stripe.com/payments/dashboard-payment-methods.md)ステップに従ってください。`payment_method_types` パラメーターを削除して、動的な決済手段の設定を適用します。 ## Checkout で配送先住所の収集を有効にする [推奨] [配送先住所](https://docs.stripe.com/payments/collect-addresses.md?payment-ui=checkout)を収集する場合は、チェックアウトセッションの作成時に配送先の国を定義する必要があります。`shipping_address_collection.allowed_countries` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection-allowed_countries)で 2 文字の ISO 国コードを指定します。 必要に応じて、`shipping_options` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_options)を使用して配送料を追加できます。 Afterpay または Clearpay を使用している場合は配送先住所を収集する必要がありますが、これらの支払い方法で配送料金を指定する必要はありません。 > Checkout の支払い方法として Afterpay または Clearpay を使用するために、配送先住所を収集する必要がありますが、配送料金は不要です。 ## 通知遅延型の支払い方法を処理する (該当する場合) [推奨] [通知遅延型の決済手段を処理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)方法については、[ダッシュボードで決済手段を管理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)ステップに従ってください。 ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。いずれかのテストアカウントにログインして **決済手段** の設定に移動し、連結アカウントの設定を表示します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## 連結アカウントが支払い方法を受け付けるための条件を満たしていることを確認する [必須] デスティネーション支払いで `on_behalf_of` パラメーターが使用されている場合、プラットフォームで連結アカウントを所有する売り手またはサービスプロバイダーは、[売上処理加盟店](https://docs.stripe.com/connect/destination-charges.md#settlement-merchant)です。そのため、プラットフォームの連結アカウントの所有者が追加の決済手段を受け付けられるようにするには、連結アカウントで受け付ける[各決済手段のケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)が有効になっていることを確認する必要があります。 ノーコードのソリューションの場合、新しいアカウントの[連結アカウントの決済の設定ページ](https://docs.stripe.com/connect/payment-methods.md)でオプションを設定して、決済手段と国の組み合わせごとに新規と既存の連結アカウントのケイパビリティをリクエストします。 API システムでは、[ケイパビリティエンドポイント](https://docs.stripe.com/api/capabilities/update.md)を使用して、受け付ける決済手段ごとに新規と既存の連結アカウントの決済手段ケイパビリティをリクエストします。新規アカウントでケイパビリティのリクエストを開始すると、既存のアカウントより前に、自動設定によって決済手段を受け付けることができます。 ほとんどの決済手段にはカードと同じ確認要件がありますが、いくつかの制限と例外があります。[決済手段ケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)の表には、カードの追加確認が必要な決済手段がリストされています。 [Capabilities endpoints](https://docs.stripe.com/api/capabilities/list.md) を使用して、各アカウントがデフォルトで使用できる [payment method capabilities](https://docs.stripe.com/connect/account-capabilities.md#payment-methods) ケイパビリティに関するクエリを実行できます。使用できるケイパビリティは、アカウントの国やその他の要因によって異なる場合があります。 ```curl curl -X POST https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" ``` レスポンスには、`capabilities` ハッシュと、連結アカウントの現在のケイパビリティのステータスが含まれています。 ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", ..."capabilities": { "card_payments": "active", "ideal_payments": "active", "sepa_debit_payments": "pending", "transfers": "active" }, ... } ``` ## 連結アカウントの支払い方法を有効にする [推奨] 必要な場合は、支払い方法の情報に関する次のリソースをご覧ください。 - 自社のプラットフォームに適した支払い方法を選択するには、[支払い方法ガイド](https://stripe.com/payments/payment-methods-guide#choosing-the-right-payment-methods-for-your-business)をご覧ください。 - [アカウントのケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md) を使用して、選択した決済手段が連結アカウントで機能することを確認します。 - [決済手段と製品サポート](https://docs.stripe.com/payments/payment-methods/payment-method-support.md#product-support)の表を参照して、選択した決済手段が使用中の Stripe プロダクトと決済フローで機能することを確認します。 Stripe は連結アカウントに対して特定の決済手段をデフォルトで有効にします。ダッシュボードの[連結アカウントの決済手段を管理する](https://dashboard.stripe.com/settings/payment_methods/connected_accounts)ページに移動して、連結アカウントで受け付ける決済手段を設定します。デフォルト設定への変更は、新規および既存のすべての連結アカウントに適用されます。 支払い方法ごとに、次のいずれかのドロップダウンオプションを選択できます。 | | | | | **デフォルトで有効にする** | 連結アカウントは、決済フローでこの支払い方法に対応します。一部の支払い方法は、無効またはブロックになっている可能性があります。 | | **デフォルトで無効にする** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | | **ブロック済み** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | ![支払い方法のドロップダウンオプション。支払い方法ごとに選択可能なオプション (ブロック済み、デフォルトで有効にする、デフォルトで無効にする) を示します。](https://b.stripecdn.com/docs-statics-srv/assets/dropdowns.ef651d721d5939d81521dd34dde4577f.png) 支払い方法のオプション 支払い方法を変更した場合は、画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、連結アカウントを更新する必要があります。 ![保存ボタンをクリックした後に表示される、ユーザーが変更した内容のリストを含むダイアログ](https://b.stripecdn.com/docs-statics-srv/assets/dialog.a56ea7716f60db9778706790320d13be.png) ダイアログを保存する ## 動的な支払い方法を使用して Checkout を実装する [必須] これまでは、Checkout セッションを定義するときに、`payment_method_types` パラメーターを使用して、さまざまな支払い方法に対応していたかもしれません。ダッシュボードで支払い方法の管理を開始するには、組み込みからこのパラメーターを削除します。 実装から `payment_method_types` パラメーターを削除すると、カードやウォレットなどの一部の支払い方法は自動的に有効になります。`currency` パラメーターにより、購入セッションの際に顧客に提示される支払い方法が制限されます。 #### Ruby ```ruby # Don't put any keys in code. See https://docs.stripe.com/keys-best-practices. # Find your keys at https://dashboard.stripe.com/apikeys. client = Stripe::StripeClient.new('<>') client.v1.checkout.sessions.create({ mode: 'payment', line_items: [{ price_data: { # The currency parameter determines which # payment methods are used in the Checkout Session. currency: 'eur', product_data: { name: 'T-shirt', }, unit_amount: 2000, }, quantity: 1, }], success_url: 'https://example.com/success', }) ``` ## Checkout で配送先住所の収集を有効にする [推奨] [配送先住所](https://docs.stripe.com/payments/collect-addresses.md?payment-ui=checkout)を収集する場合は、チェックアウトセッションの作成時に配送先の国を定義する必要があります。`shipping_address_collection.allowed_countries` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection-allowed_countries)で 2 文字の ISO 国コードを指定します。 必要に応じて、`shipping_options` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_options)を使用して配送料を追加できます。 Afterpay または Clearpay を使用している場合は配送先住所を収集する必要がありますが、これらの支払い方法で配送料金を指定する必要はありません。 > Checkout の支払い方法として Afterpay または Clearpay を使用するために、配送先住所を収集する必要がありますが、配送料金は不要です。 ## 通知遅延型の支払い方法を処理する (該当する場合) [推奨] [通知遅延型の決済手段を処理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)方法については、[ダッシュボードで決済手段を管理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)ステップに従ってください。 ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## 購入時に利用できる支払い方法を選択する [推奨] ダッシュボードの[支払い方法](https://dashboard.stripe.com/settings/payment_methods)ページから、アカウントの支払い方法を設定します。連結アカウントは支払い方法をカスタマイズできません。 ## 動的な支払い方法を使用して Checkout を実装する [必須] 前セクションのオプションのステップを実装した後に、自動パラメーターを組み込む準備が整います。[Checkout の実装を更新する](https://docs.stripe.com/payments/dashboard-payment-methods.md)ステップに従ってください。`payment_method_types` パラメーターを削除して、動的な決済手段の設定を適用します。 ## Checkout で配送先住所の収集を有効にする [推奨] [配送先住所](https://docs.stripe.com/payments/collect-addresses.md?payment-ui=checkout)を収集する場合は、チェックアウトセッションの作成時に配送先の国を定義する必要があります。`shipping_address_collection.allowed_countries` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection-allowed_countries)で 2 文字の ISO 国コードを指定します。 必要に応じて、`shipping_options` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_options)を使用して配送料を追加できます。 Afterpay または Clearpay を使用している場合は配送先住所を収集する必要がありますが、これらの支払い方法で配送料金を指定する必要はありません。 > Checkout の支払い方法として Afterpay または Clearpay を使用するために、配送先住所を収集する必要がありますが、配送料金は不要です。 ## 通知遅延型の支払い方法を処理する (該当する場合) [推奨] [通知遅延型の決済手段を処理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)方法については、[ダッシュボードで決済手段を管理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)ステップに従ってください。 ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## 連結アカウントが支払い方法を受け付けるための条件を満たしていることを確認する [必須] デスティネーション支払いで `on_behalf_of` パラメーターが使用されている場合、プラットフォームで連結アカウントを所有する売り手またはサービスプロバイダーは、[売上処理加盟店](https://docs.stripe.com/connect/destination-charges.md#settlement-merchant)です。そのため、プラットフォームの連結アカウントの所有者が追加の決済手段を受け付けられるようにするには、連結アカウントで受け付ける[各決済手段のケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)が有効になっていることを確認する必要があります。 ノーコードのソリューションの場合、新しいアカウントの [Express 設定](https://dashboard.stripe.com/settings/connect/express)または[連結アカウントの決済の設定ページ](https://docs.stripe.com/connect/payment-methods.md)でオプションを設定して、決済手段と国の組み合わせごとに新規と既存の連結アカウントのケイパビリティをリクエストします。 API システムでは、[ケイパビリティエンドポイント](https://docs.stripe.com/api/capabilities/update.md)を使用して、受け付ける決済手段ごとに新規と既存の連結アカウントの決済手段ケイパビリティをリクエストします。新規アカウントでケイパビリティのリクエストを開始すると、既存のアカウントより前に、自動設定によって決済手段を受け付けることができます。 ほとんどの決済手段にはカードと同じ確認要件がありますが、いくつかの制限と例外があります。[決済手段ケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)の表には、カードの追加確認が必要な決済手段がリストされています。 [Capabilities endpoints](https://docs.stripe.com/api/capabilities/list.md) を使用して、各アカウントがデフォルトで使用できる [payment method capabilities](https://docs.stripe.com/connect/account-capabilities.md#payment-methods) ケイパビリティに関するクエリを実行できます。使用できるケイパビリティは、アカウントの国やその他の要因によって異なる場合があります。 ```curl curl -X POST https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" ``` レスポンスには、`capabilities` ハッシュと、連結アカウントの現在のケイパビリティのステータスが含まれています。 ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", ..."capabilities": { "card_payments": "active", "ideal_payments": "active", "sepa_debit_payments": "pending", "transfers": "active" }, ... } ``` ## 連結アカウントの支払い方法を有効にする [推奨] 必要な場合は、支払い方法の情報に関する次のリソースをご覧ください。 - 自社のプラットフォームに適した支払い方法を選択するには、[支払い方法ガイド](https://stripe.com/payments/payment-methods-guide#choosing-the-right-payment-methods-for-your-business)をご覧ください。 - [アカウントのケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md) を使用して、選択した決済手段が連結アカウントで機能することを確認します。 - [決済手段と製品サポート](https://docs.stripe.com/payments/payment-methods/payment-method-support.md#product-support)の表を参照して、選択した決済手段が使用中の Stripe プロダクトと決済フローで機能することを確認します。 Stripe は連結アカウントに対して特定の決済手段をデフォルトで有効にします。ダッシュボードの[連結アカウントの決済手段を管理する](https://dashboard.stripe.com/settings/payment_methods/connected_accounts)ページに移動して、連結アカウントで受け付ける決済手段を設定します。デフォルト設定への変更は、新規および既存のすべての連結アカウントに適用されます。 支払い方法ごとに、次のいずれかのドロップダウンオプションを選択できます。 | | | | | **デフォルトで有効にする** | 連結アカウントは、決済フローでこの支払い方法に対応します。一部の支払い方法は、無効またはブロックになっている可能性があります。 | | **デフォルトで無効にする** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | | **ブロック済み** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | ![支払い方法のドロップダウンオプション。支払い方法ごとに選択可能なオプション (ブロック済み、デフォルトで有効にする、デフォルトで無効にする) を示します。](https://b.stripecdn.com/docs-statics-srv/assets/dropdowns.ef651d721d5939d81521dd34dde4577f.png) 支払い方法のオプション 支払い方法を変更した場合は、画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、連結アカウントを更新する必要があります。 ![保存ボタンをクリックした後に表示される、ユーザーが変更した内容のリストを含むダイアログ](https://b.stripecdn.com/docs-statics-srv/assets/dialog.a56ea7716f60db9778706790320d13be.png) ダイアログを保存する ## 動的な支払い方法を使用して Checkout を実装する [必須] これまでは、Checkout セッションを定義するときに、`payment_method_types` パラメーターを使用して、さまざまな支払い方法に対応していたかもしれません。ダッシュボードで支払い方法の管理を開始するには、組み込みからこのパラメーターを削除します。 実装から `payment_method_types` パラメーターを削除すると、カードやウォレットなどの一部の支払い方法は自動的に有効になります。`currency` パラメーターにより、購入セッションの際に顧客に提示される支払い方法が制限されます。 #### Ruby ```ruby # Don't put any keys in code. See https://docs.stripe.com/keys-best-practices. # Find your keys at https://dashboard.stripe.com/apikeys. client = Stripe::StripeClient.new('<>') client.v1.checkout.sessions.create({ mode: 'payment', line_items: [{ price_data: { # The currency parameter determines which # payment methods are used in the Checkout Session. currency: 'eur', product_data: { name: 'T-shirt', }, unit_amount: 2000, }, quantity: 1, }], success_url: 'https://example.com/success', }) ``` ## Checkout で配送先住所の収集を有効にする [推奨] [配送先住所](https://docs.stripe.com/payments/collect-addresses.md?payment-ui=checkout)を収集する場合は、チェックアウトセッションの作成時に配送先の国を定義する必要があります。`shipping_address_collection.allowed_countries` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection-allowed_countries)で 2 文字の ISO 国コードを指定します。 必要に応じて、`shipping_options` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_options)を使用して配送料を追加できます。 Afterpay または Clearpay を使用している場合は配送先住所を収集する必要がありますが、これらの支払い方法で配送料金を指定する必要はありません。 > Checkout の支払い方法として Afterpay または Clearpay を使用するために、配送先住所を収集する必要がありますが、配送料金は不要です。 ## 通知遅延型の支払い方法を処理する (該当する場合) [推奨] [通知遅延型の決済手段を処理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)方法については、[ダッシュボードで決済手段を管理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)ステップに従ってください。 ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## 購入時に利用できる支払い方法を選択する [推奨] ダッシュボードの[支払い方法](https://dashboard.stripe.com/settings/payment_methods)ページから、アカウントの支払い方法を設定します。連結アカウントは支払い方法をカスタマイズできません。 ## 動的な支払い方法を使用して Checkout を実装する [必須] 前セクションのオプションのステップを実装した後に、自動パラメーターを組み込む準備が整います。[Checkout の実装を更新する](https://docs.stripe.com/payments/dashboard-payment-methods.md)ステップに従ってください。`payment_method_types` パラメーターを削除して、動的な決済手段の設定を適用します。 ## Checkout で配送先住所の収集を有効にする [推奨] [配送先住所](https://docs.stripe.com/payments/collect-addresses.md?payment-ui=checkout)を収集する場合は、チェックアウトセッションの作成時に配送先の国を定義する必要があります。`shipping_address_collection.allowed_countries` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection-allowed_countries)で 2 文字の ISO 国コードを指定します。 必要に応じて、`shipping_options` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_options)を使用して配送料を追加できます。 Afterpay または Clearpay を使用している場合は配送先住所を収集する必要がありますが、これらの支払い方法で配送料金を指定する必要はありません。 > Checkout の支払い方法として Afterpay または Clearpay を使用するために、配送先住所を収集する必要がありますが、配送料金は不要です。 ## 通知遅延型の支払い方法を処理する (該当する場合) [推奨] [通知遅延型の決済手段を処理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)方法については、[ダッシュボードで決済手段を管理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)ステップに従ってください。 ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 > Stripe ダッシュボードにアクセスできる連結アカウントについては、支払いと送金を別々にする方式ではなく、ダイレクト支払いを使用することが推奨されます。詳細については、[支払いタイプ](https://docs.stripe.com/connect/charges.md#types)をご覧ください。 ## 連結アカウントの支払い方法を有効にする [推奨] 必要な場合は、支払い方法の情報に関する次のリソースをご覧ください。 - 自社のプラットフォームに適した支払い方法を選択するには、[支払い方法ガイド](https://stripe.com/payments/payment-methods-guide#choosing-the-right-payment-methods-for-your-business)をご覧ください。 - [アカウントのケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md) を使用して、選択した決済手段が連結アカウントで機能することを確認します。 - [決済手段と製品サポート](https://docs.stripe.com/payments/payment-methods/payment-method-support.md#product-support)の表を参照して、選択した決済手段が使用中の Stripe プロダクトと決済フローで機能することを確認します。 Stripe は連結アカウントに対して特定の決済手段をデフォルトで有効にします。ダッシュボードの[連結アカウントの決済手段を管理する](https://dashboard.stripe.com/settings/payment_methods/connected_accounts)ページに移動して、連結アカウントで受け付ける決済手段を設定します。デフォルト設定への変更は、新規および既存のすべての連結アカウントに適用されます。 支払い方法ごとに、次のいずれかのドロップダウンオプションを選択できます。 | | | | | **デフォルトで有効にする** | 連結アカウントは、決済フローでこの支払い方法に対応します。一部の支払い方法は、プラットフォームの連結アカウントの所有者がダッシュボードの設定ページで有効化する必要があるため、無効またはブロックになっている可能性があります。 | | **デフォルトで無効にする** | 連結アカウントは、決済フローでこの支払い方法に対応しません。プラットフォームの連結アカウントの所有者がダッシュボードで独自の支払い方法を管理することを許可されていても、連結アカウントはこれを有効にできません。 | | **ブロック済み** | 連結アカウントは、決済フローでこの支払い方法に対応しません。プラットフォームの連結アカウントの所有者がダッシュボードで独自の支払い方法を管理することを許可していても、連結アカウントはこれを有効にできません。 | ![支払い方法のドロップダウンオプション。支払い方法ごとに選択可能なオプション (ブロック済み、デフォルトで有効にする、デフォルトで無効にする) を示します。](https://b.stripecdn.com/docs-statics-srv/assets/dropdowns.ef651d721d5939d81521dd34dde4577f.png) 支払い方法のオプション 支払い方法を変更した場合は、画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、連結アカウントを更新する必要があります。 ![保存ボタンをクリックした後に表示される、ユーザーが変更した内容のリストを含むダイアログ](https://b.stripecdn.com/docs-statics-srv/assets/dialog.a56ea7716f60db9778706790320d13be.png) ダイアログを保存する ## 連結アカウントによる支払い方法の管理を許可する [推奨] Stripe では、プラットフォームの連結アカウントの所有者がダッシュボードから独自の支払い方法をカスタマイズできるようにすることをお勧めしています。このオプションを有効にすると、Stripe ダッシュボードにアクセスできる各連結アカウントが各自のダッシュボードにログインして[支払い方法](https://dashboard.stripe.com/settings/payment_methods)ページを表示できるようになります。ダッシュボードには、新規および既存のすべての連結アカウントに対して適用される支払い方法のデフォルトのセットが表示されます。プラットフォームの連結アカウントの所有者は、お客様がブロックした支払い方法を除き、これらのデフォルトを上書きできます。 このオプションを有効にするには、**アカウントのカスタマイズ**チェックボックスを選択します。画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、この設定を更新する必要があります。 ![連結アカウントの所有者に支払い方法のカスタマイズを許可する際に選択するチェックボックスのスクリーンショット](https://b.stripecdn.com/docs-statics-srv/assets/checkbox.275bd35d2a025272f03af029a144e577.png) アカウントのカスタマイズのチェックボックス ## 動的な支払い方法を使用して Checkout を実装する [必須] これまでは、Checkout セッションを定義するときに、`payment_method_types` パラメーターを使用して、さまざまな支払い方法に対応していたかもしれません。ダッシュボードで支払い方法の管理を開始するには、組み込みからこのパラメーターを削除します。 実装から `payment_method_types` パラメーターを削除すると、カードやウォレットなどの一部の支払い方法は自動的に有効になります。`currency` パラメーターにより、購入セッションの際に顧客に提示される支払い方法が制限されます。 #### Ruby ```ruby # Don't put any keys in code. See https://docs.stripe.com/keys-best-practices. # Find your keys at https://dashboard.stripe.com/apikeys. client = Stripe::StripeClient.new('<>') client.v1.checkout.sessions.create({ mode: 'payment', line_items: [{ price_data: { # The currency parameter determines which # payment methods are used in the Checkout Session. currency: 'eur', product_data: { name: 'T-shirt', }, unit_amount: 2000, }, quantity: 1, }], success_url: 'https://example.com/success', }) ``` ## Checkout で配送先住所の収集を有効にする [推奨] [配送先住所](https://docs.stripe.com/payments/collect-addresses.md?payment-ui=checkout)を収集する場合は、チェックアウトセッションの作成時に配送先の国を定義する必要があります。`shipping_address_collection.allowed_countries` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection-allowed_countries)で 2 文字の ISO 国コードを指定します。 必要に応じて、`shipping_options` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_options)を使用して配送料を追加できます。 Afterpay または Clearpay を使用している場合は配送先住所を収集する必要がありますが、これらの支払い方法で配送料金を指定する必要はありません。 > Checkout の支払い方法として Afterpay または Clearpay を使用するために、配送先住所を収集する必要がありますが、配送料金は不要です。 ## 通知遅延型の支払い方法を処理する (該当する場合) [推奨] [通知遅延型の決済手段を処理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)方法については、[ダッシュボードで決済手段を管理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)ステップに従ってください。 ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。いずれかのテストアカウントにログインして **決済手段** の設定に移動し、連結アカウントの設定を表示します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## Stripe ダッシュボードにアクセスできる連結アカウントが、設定ステップを必要とする支払い方法を有効化できるようにする [オプション] [決済手段の機能](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)の表には、使用前に手動で有効化する必要がある決済手段と、カードに加えて必要な確認要件が記載されています。プラットフォームの連結アカウントの所有者に、[手動設定ページ](https://dashboard.stripe.com/settings/payment_methods)にアクセスして、Stripe ダッシュボードにアクセスできる連結アカウントでデフォルトでは利用できない決済手段を有効にするよう案内します。 ![支払い方法が一覧表示された手動設定ページのスクリーンショット。アクセスのリクエスト、招待のリクエスト、設定を行うためのオプションを含みます。](https://b.stripecdn.com/docs-statics-srv/assets/manual-settings.db0a0c2abebb94e197e1bef683ea7db9.png) 支払い方法の手動設定 > **埋め込み支払い方法設定コンポーネント**を使用すると、接続アカウントは Stripe ダッシュボードにアクセスすることなく、Checkout で提供する支払い方法を設定できます。[埋め込み支払い方法設定コンポーネント](https://docs.stripe.com/connect/supported-embedded-components/payment-method-settings.md)の詳細を確認し、利用可能になった際に通知を受け取ってください。 > Stripe ダッシュボードにアクセスできる連結アカウントについては、支払いと送金を別々にする方式ではなく、ダイレクト支払いを使用することが推奨されます。詳細については、[支払いタイプ](https://docs.stripe.com/connect/charges.md#types)をご覧ください。 ## 購入時に利用できる支払い方法を選択する [推奨] ダッシュボードの[支払い方法](https://dashboard.stripe.com/settings/payment_methods)ページから、アカウントの支払い方法を設定します。連結アカウントは支払い方法をカスタマイズできません。 ## 動的な支払い方法を使用して Checkout を実装する [必須] 前セクションのオプションのステップを実装した後に、自動パラメーターを組み込む準備が整います。[Checkout の実装を更新する](https://docs.stripe.com/payments/dashboard-payment-methods.md)ステップに従ってください。`payment_method_types` パラメーターを削除して、動的な決済手段の設定を適用します。 ## Checkout で配送先住所の収集を有効にする [推奨] [配送先住所](https://docs.stripe.com/payments/collect-addresses.md?payment-ui=checkout)を収集する場合は、チェックアウトセッションの作成時に配送先の国を定義する必要があります。`shipping_address_collection.allowed_countries` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection-allowed_countries)で 2 文字の ISO 国コードを指定します。 必要に応じて、`shipping_options` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_options)を使用して配送料を追加できます。 Afterpay または Clearpay を使用している場合は配送先住所を収集する必要がありますが、これらの支払い方法で配送料金を指定する必要はありません。 > Checkout の支払い方法として Afterpay または Clearpay を使用するために、配送先住所を収集する必要がありますが、配送料金は不要です。 ## 通知遅延型の支払い方法を処理する (該当する場合) [推奨] [通知遅延型の決済手段を処理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)方法については、[ダッシュボードで決済手段を管理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)ステップに従ってください。 ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。いずれかのテストアカウントにログインして **決済手段** の設定に移動し、連結アカウントの設定を表示します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## 連結アカウントが支払い方法を受け付けるための条件を満たしていることを確認する [必須] で `on_behalf_of` パラメーターが使用されている場合、プラットフォームで連結アカウントを所有する売り手またはサービスプロバイダーは、[売上処理加盟店](https://docs.stripe.com/connect/destination-charges.md#settlement-merchant)です。そのため、プラットフォームの連結アカウントの所有者が追加の決済手段を受け付けられるようにするには、連結アカウントで受け付ける[各決済手段のケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)が有効になっていることを確認する必要があります。 ノーコードのソリューションの場合、新しいアカウントの[連結アカウントの決済の設定ページ](https://docs.stripe.com/connect/payment-methods.md)でオプションを設定して、決済手段と国の組み合わせごとに新規と既存の連結アカウントのケイパビリティをリクエストします。 API システムでは、[ケイパビリティエンドポイント](https://docs.stripe.com/api/capabilities/update.md)を使用して、受け付ける決済手段ごとに新規と既存の連結アカウントの決済手段ケイパビリティをリクエストします。新規アカウントでケイパビリティのリクエストを開始すると、既存のアカウントより前に、自動設定によって決済手段を受け付けることができます。 ほとんどの決済手段にはカードと同じ確認要件がありますが、いくつかの制限と例外があります。[決済手段ケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)の表には、カードの追加確認が必要な決済手段がリストされています。 [Capabilities endpoints](https://docs.stripe.com/api/capabilities/list.md) を使用して、各アカウントがデフォルトで使用できる [payment method capabilities](https://docs.stripe.com/connect/account-capabilities.md#payment-methods) ケイパビリティに関するクエリを実行できます。使用できるケイパビリティは、アカウントの国やその他の要因によって異なる場合があります。 ```curl curl -X POST https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" ``` レスポンスには、`capabilities` ハッシュと、連結アカウントの現在のケイパビリティのステータスが含まれています。 ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", ..."capabilities": { "card_payments": "active", "ideal_payments": "active", "sepa_debit_payments": "pending", "transfers": "active" }, ... } ``` ## 連結アカウントの支払い方法を有効にする [推奨] 必要な場合は、支払い方法の情報に関する次のリソースをご覧ください。 - 自社のプラットフォームに適した支払い方法を選択するには、[支払い方法ガイド](https://stripe.com/payments/payment-methods-guide#choosing-the-right-payment-methods-for-your-business)をご覧ください。 - [アカウントのケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md) を使用して、選択した決済手段が連結アカウントで機能することを確認します。 - [決済手段と製品サポート](https://docs.stripe.com/payments/payment-methods/payment-method-support.md#product-support)の表を参照して、選択した決済手段が使用中の Stripe プロダクトと決済フローで機能することを確認します。 Stripe は連結アカウントに対して特定の決済手段をデフォルトで有効にします。ダッシュボードの[連結アカウントの決済手段を管理する](https://dashboard.stripe.com/settings/payment_methods/connected_accounts)ページに移動して、連結アカウントで受け付ける決済手段を設定します。デフォルト設定への変更は、新規および既存のすべての連結アカウントに適用されます。 支払い方法ごとに、次のいずれかのドロップダウンオプションを選択できます。 | | | | | **デフォルトで有効にする** | 連結アカウントは、決済フローでこの支払い方法に対応します。一部の支払い方法は、無効またはブロックになっている可能性があります。 | | **デフォルトで無効にする** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | | **ブロック済み** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | ![支払い方法のドロップダウンオプション。支払い方法ごとに選択可能なオプション (ブロック済み、デフォルトで有効にする、デフォルトで無効にする) を示します。](https://b.stripecdn.com/docs-statics-srv/assets/dropdowns.ef651d721d5939d81521dd34dde4577f.png) 支払い方法のオプション 支払い方法を変更した場合は、画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、連結アカウントを更新する必要があります。 ![保存ボタンをクリックした後に表示される、ユーザーが変更した内容のリストを含むダイアログ](https://b.stripecdn.com/docs-statics-srv/assets/dialog.a56ea7716f60db9778706790320d13be.png) ダイアログを保存する ## 動的な支払い方法を使用して Checkout を実装する [必須] これまでは、Checkout セッションを定義するときに、`payment_method_types` パラメーターを使用して、さまざまな支払い方法に対応していたかもしれません。ダッシュボードで支払い方法の管理を開始するには、組み込みからこのパラメーターを削除します。 実装から `payment_method_types` パラメーターを削除すると、カードやウォレットなどの一部の支払い方法は自動的に有効になります。`currency` パラメーターにより、購入セッションの際に顧客に提示される支払い方法が制限されます。 #### Ruby ```ruby # Don't put any keys in code. See https://docs.stripe.com/keys-best-practices. # Find your keys at https://dashboard.stripe.com/apikeys. client = Stripe::StripeClient.new('<>') client.v1.checkout.sessions.create({ mode: 'payment', line_items: [{ price_data: { # The currency parameter determines which # payment methods are used in the Checkout Session. currency: 'eur', product_data: { name: 'T-shirt', }, unit_amount: 2000, }, quantity: 1, }], success_url: 'https://example.com/success', }) ``` ## Checkout で配送先住所の収集を有効にする [推奨] [配送先住所](https://docs.stripe.com/payments/collect-addresses.md?payment-ui=checkout)を収集する場合は、チェックアウトセッションの作成時に配送先の国を定義する必要があります。`shipping_address_collection.allowed_countries` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection-allowed_countries)で 2 文字の ISO 国コードを指定します。 必要に応じて、`shipping_options` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_options)を使用して配送料を追加できます。 Afterpay または Clearpay を使用している場合は配送先住所を収集する必要がありますが、これらの支払い方法で配送料金を指定する必要はありません。 > Checkout の支払い方法として Afterpay または Clearpay を使用するために、配送先住所を収集する必要がありますが、配送料金は不要です。 ## 通知遅延型の支払い方法を処理する (該当する場合) [推奨] [通知遅延型の決済手段を処理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)方法については、[ダッシュボードで決済手段を管理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)ステップに従ってください。 ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## 購入時に利用できる支払い方法を選択する [推奨] ダッシュボードの[支払い方法](https://dashboard.stripe.com/settings/payment_methods)ページから、アカウントの支払い方法を設定します。連結アカウントは支払い方法をカスタマイズできません。 ## 動的な支払い方法を使用して Checkout を実装する [必須] 前セクションのオプションのステップを実装した後に、自動パラメーターを組み込む準備が整います。[Checkout の実装を更新する](https://docs.stripe.com/payments/dashboard-payment-methods.md)ステップに従ってください。`payment_method_types` パラメーターを削除して、動的な決済手段の設定を適用します。 ## Checkout で配送先住所の収集を有効にする [推奨] [配送先住所](https://docs.stripe.com/payments/collect-addresses.md?payment-ui=checkout)を収集する場合は、チェックアウトセッションの作成時に配送先の国を定義する必要があります。`shipping_address_collection.allowed_countries` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection-allowed_countries)で 2 文字の ISO 国コードを指定します。 必要に応じて、`shipping_options` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_options)を使用して配送料を追加できます。 Afterpay または Clearpay を使用している場合は配送先住所を収集する必要がありますが、これらの支払い方法で配送料金を指定する必要はありません。 > Checkout の支払い方法として Afterpay または Clearpay を使用するために、配送先住所を収集する必要がありますが、配送料金は不要です。 ## 通知遅延型の支払い方法を処理する (該当する場合) [推奨] [通知遅延型の決済手段を処理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)方法については、[ダッシュボードで決済手段を管理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)ステップに従ってください。 ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## 連結アカウントが支払い方法を受け付けるための条件を満たしていることを確認する [必須] で `on_behalf_of` パラメーターが使用されている場合、プラットフォームで連結アカウントを所有する売り手またはサービスプロバイダーは、[売上処理加盟店](https://docs.stripe.com/connect/destination-charges.md#settlement-merchant)です。そのため、プラットフォームの連結アカウントの所有者が追加の決済手段を受け付けられるようにするには、連結アカウントで受け付ける[各決済手段のケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)が有効になっていることを確認する必要があります。 ノーコードのソリューションの場合、新しいアカウントの [Express 設定](https://dashboard.stripe.com/settings/connect/express)または[連結アカウントの決済の設定ページ](https://docs.stripe.com/connect/payment-methods.md)でオプションを設定して、決済手段と国の組み合わせごとに新規と既存の連結アカウントのケイパビリティをリクエストします。 API システムでは、[ケイパビリティエンドポイント](https://docs.stripe.com/api/capabilities/update.md)を使用して、受け付ける決済手段ごとに新規と既存の連結アカウントの決済手段ケイパビリティをリクエストします。新規アカウントでケイパビリティのリクエストを開始すると、既存のアカウントより前に、自動設定によって決済手段を受け付けることができます。 ほとんどの決済手段にはカードと同じ確認要件がありますが、いくつかの制限と例外があります。[決済手段ケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)の表には、カードの追加確認が必要な決済手段がリストされています。 [Capabilities endpoints](https://docs.stripe.com/api/capabilities/list.md) を使用して、各アカウントがデフォルトで使用できる [payment method capabilities](https://docs.stripe.com/connect/account-capabilities.md#payment-methods) ケイパビリティに関するクエリを実行できます。使用できるケイパビリティは、アカウントの国やその他の要因によって異なる場合があります。 ```curl curl -X POST https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" ``` レスポンスには、`capabilities` ハッシュと、連結アカウントの現在のケイパビリティのステータスが含まれています。 ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", ..."capabilities": { "card_payments": "active", "ideal_payments": "active", "sepa_debit_payments": "pending", "transfers": "active" }, ... } ``` ## 連結アカウントの支払い方法を有効にする [推奨] 必要な場合は、支払い方法の情報に関する次のリソースをご覧ください。 - 自社のプラットフォームに適した支払い方法を選択するには、[支払い方法ガイド](https://stripe.com/payments/payment-methods-guide#choosing-the-right-payment-methods-for-your-business)をご覧ください。 - [アカウントのケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md) を使用して、選択した決済手段が連結アカウントで機能することを確認します。 - [決済手段と製品サポート](https://docs.stripe.com/payments/payment-methods/payment-method-support.md#product-support)の表を参照して、選択した決済手段が使用中の Stripe プロダクトと決済フローで機能することを確認します。 Stripe は連結アカウントに対して特定の決済手段をデフォルトで有効にします。ダッシュボードの[連結アカウントの決済手段を管理する](https://dashboard.stripe.com/settings/payment_methods/connected_accounts)ページに移動して、連結アカウントで受け付ける決済手段を設定します。デフォルト設定への変更は、新規および既存のすべての連結アカウントに適用されます。 支払い方法ごとに、次のいずれかのドロップダウンオプションを選択できます。 | | | | | **デフォルトで有効にする** | 連結アカウントは、決済フローでこの支払い方法に対応します。一部の支払い方法は、無効またはブロックになっている可能性があります。 | | **デフォルトで無効にする** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | | **ブロック済み** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | ![支払い方法のドロップダウンオプション。支払い方法ごとに選択可能なオプション (ブロック済み、デフォルトで有効にする、デフォルトで無効にする) を示します。](https://b.stripecdn.com/docs-statics-srv/assets/dropdowns.ef651d721d5939d81521dd34dde4577f.png) 支払い方法のオプション 支払い方法を変更した場合は、画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、連結アカウントを更新する必要があります。 ![保存ボタンをクリックした後に表示される、ユーザーが変更した内容のリストを含むダイアログ](https://b.stripecdn.com/docs-statics-srv/assets/dialog.a56ea7716f60db9778706790320d13be.png) ダイアログを保存する ## 動的な支払い方法を使用して Checkout を実装する [必須] これまでは、Checkout セッションを定義するときに、`payment_method_types` パラメーターを使用して、さまざまな支払い方法に対応していたかもしれません。ダッシュボードで支払い方法の管理を開始するには、組み込みからこのパラメーターを削除します。 実装から `payment_method_types` パラメーターを削除すると、カードやウォレットなどの一部の支払い方法は自動的に有効になります。`currency` パラメーターにより、購入セッションの際に顧客に提示される支払い方法が制限されます。 #### Ruby ```ruby # Don't put any keys in code. See https://docs.stripe.com/keys-best-practices. # Find your keys at https://dashboard.stripe.com/apikeys. client = Stripe::StripeClient.new('<>') client.v1.checkout.sessions.create({ mode: 'payment', line_items: [{ price_data: { # The currency parameter determines which # payment methods are used in the Checkout Session. currency: 'eur', product_data: { name: 'T-shirt', }, unit_amount: 2000, }, quantity: 1, }], success_url: 'https://example.com/success', }) ``` ## Checkout で配送先住所の収集を有効にする [推奨] [配送先住所](https://docs.stripe.com/payments/collect-addresses.md?payment-ui=checkout)を収集する場合は、チェックアウトセッションの作成時に配送先の国を定義する必要があります。`shipping_address_collection.allowed_countries` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection-allowed_countries)で 2 文字の ISO 国コードを指定します。 必要に応じて、`shipping_options` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_options)を使用して配送料を追加できます。 Afterpay または Clearpay を使用している場合は配送先住所を収集する必要がありますが、これらの支払い方法で配送料金を指定する必要はありません。 > Checkout の支払い方法として Afterpay または Clearpay を使用するために、配送先住所を収集する必要がありますが、配送料金は不要です。 ## 通知遅延型の支払い方法を処理する (該当する場合) [推奨] [通知遅延型の決済手段を処理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)方法については、[ダッシュボードで決済手段を管理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)ステップに従ってください。 ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## 購入時に利用できる支払い方法を選択する [推奨] ダッシュボードの[支払い方法](https://dashboard.stripe.com/settings/payment_methods)ページから、アカウントの支払い方法を設定します。連結アカウントは支払い方法をカスタマイズできません。 ## 動的な支払い方法を使用して Checkout を実装する [必須] 前セクションのオプションのステップを実装した後に、自動パラメーターを組み込む準備が整います。[Checkout の実装を更新する](https://docs.stripe.com/payments/dashboard-payment-methods.md)ステップに従ってください。`payment_method_types` パラメーターを削除して、動的な決済手段の設定を適用します。 ## Checkout で配送先住所の収集を有効にする [推奨] [配送先住所](https://docs.stripe.com/payments/collect-addresses.md?payment-ui=checkout)を収集する場合は、チェックアウトセッションの作成時に配送先の国を定義する必要があります。`shipping_address_collection.allowed_countries` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection-allowed_countries)で 2 文字の ISO 国コードを指定します。 必要に応じて、`shipping_options` [パラメーター](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_options)を使用して配送料を追加できます。 Afterpay または Clearpay を使用している場合は配送先住所を収集する必要がありますが、これらの支払い方法で配送料金を指定する必要はありません。 > Checkout の支払い方法として Afterpay または Clearpay を使用するために、配送先住所を収集する必要がありますが、配送料金は不要です。 ## 通知遅延型の支払い方法を処理する (該当する場合) [推奨] [通知遅延型の決済手段を処理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)方法については、[ダッシュボードで決済手段を管理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)ステップに従ってください。 ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## 連結アカウントの支払い方法を有効にする [推奨] 必要な場合は、支払い方法の情報に関する次のリソースをご覧ください。 - 自社のプラットフォームに適した支払い方法を選択するには、[支払い方法ガイド](https://stripe.com/payments/payment-methods-guide#choosing-the-right-payment-methods-for-your-business)をご覧ください。 - [アカウントのケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md) を使用して、選択した決済手段が連結アカウントで機能することを確認します。 - [決済手段と製品サポート](https://docs.stripe.com/payments/payment-methods/payment-method-support.md#product-support)の表を参照して、選択した決済手段が使用中の Stripe プロダクトと決済フローで機能することを確認します。 Stripe は連結アカウントに対して特定の決済手段をデフォルトで有効にします。ダッシュボードの[連結アカウントの決済手段を管理する](https://dashboard.stripe.com/settings/payment_methods/connected_accounts)ページに移動して、連結アカウントで受け付ける決済手段を設定します。デフォルト設定への変更は、新規および既存のすべての連結アカウントに適用されます。 支払い方法ごとに、次のいずれかのドロップダウンオプションを選択できます。 | | | | | **デフォルトで有効にする** | 連結アカウントは、決済フローでこの支払い方法に対応します。一部の支払い方法は、プラットフォームの連結アカウントの所有者がダッシュボードの設定ページで有効化する必要があるため、無効またはブロックになっている可能性があります。 | | **デフォルトで無効にする** | 連結アカウントは、決済フローでこの支払い方法に対応しません。プラットフォームの連結アカウントの所有者がダッシュボードで独自の支払い方法を管理することを許可されていても、連結アカウントはこれを有効にできません。 | | **ブロック済み** | 連結アカウントは、決済フローでこの支払い方法に対応しません。プラットフォームの連結アカウントの所有者がダッシュボードで独自の支払い方法を管理することを許可していても、連結アカウントはこれを有効にできません。 | ![支払い方法のドロップダウンオプション。支払い方法ごとに選択可能なオプション (ブロック済み、デフォルトで有効にする、デフォルトで無効にする) を示します。](https://b.stripecdn.com/docs-statics-srv/assets/dropdowns.ef651d721d5939d81521dd34dde4577f.png) 支払い方法のオプション 支払い方法を変更した場合は、画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、連結アカウントを更新する必要があります。 ![保存ボタンをクリックした後に表示される、ユーザーが変更した内容のリストを含むダイアログ](https://b.stripecdn.com/docs-statics-srv/assets/dialog.a56ea7716f60db9778706790320d13be.png) ダイアログを保存する ## 連結アカウントによる支払い方法の管理を許可する [推奨] Stripe では、プラットフォームの連結アカウントの所有者がダッシュボードから独自の支払い方法をカスタマイズできるようにすることをお勧めしています。このオプションを有効にすると、Stripe ダッシュボードにアクセスできる各連結アカウントが各自のダッシュボードにログインして[支払い方法](https://dashboard.stripe.com/settings/payment_methods)ページを表示できるようになります。ダッシュボードには、新規および既存のすべての連結アカウントに対して適用される支払い方法のデフォルトのセットが表示されます。プラットフォームの連結アカウントの所有者は、お客様がブロックした支払い方法を除き、これらのデフォルトを上書きできます。 このオプションを有効にするには、**アカウントのカスタマイズ**チェックボックスを選択します。画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、この設定を更新する必要があります。 ![連結アカウントの所有者に支払い方法のカスタマイズを許可する際に選択するチェックボックスのスクリーンショット](https://b.stripecdn.com/docs-statics-srv/assets/checkbox.275bd35d2a025272f03af029a144e577.png) アカウントのカスタマイズのチェックボックス ## Payment Element を組み込む [必須] [ダイレクト支払いの作成](https://docs.stripe.com/connect/direct-charges.md?platform=web&ui=elements)手順に従って、Payment Element を実装します。 `PaymentIntent` の作成時には次のようにしてください。 - `Stripe-Account` ヘッダーと連結アカウント ID を指定し、購入で[ダイレクト支払い](https://docs.stripe.com/connect/direct-charges.md)が使用されていることを確認します。 - 該当する場合は、`application_fee_amount` パラメーターの値を指定して、プラットフォームに送られる購入の金額を設定します。 次のコードは、ヘッダーで指定された連結アカウントの 10 EUR の `PaymentIntent` を作成します。プラットフォームは 1 EUR のプラットフォーム手数料を請求します。 ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d amount=1000 \ -d currency=eur \ -d application_fee_amount=100 \ -d "automatic_payment_methods[enabled]=true" ``` ## 通知遅延型の支払い方法を処理する (該当する場合) [推奨] [通知遅延型の決済手段を処理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)方法については、[ダッシュボードで決済手段を管理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)ステップに従ってください。 ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。いずれかのテストアカウントにログインして **決済手段** の設定に移動し、連結アカウントの設定を表示します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## Stripe ダッシュボードにアクセスできる連結アカウントが、設定ステップを必要とする支払い方法を有効化できるようにする [オプション] Stripe ダッシュボードにアクセスできる連結アカウントは、ほぼすべての決済手段をデフォルトで使用できます。ただし、一部の決済手段 (Alipay や WeChat Pay など) は、ユーザーがダッシュボードから手動で有効化にする必要があります。[決済手段ケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)の表を使用して、どの決済手段手動で有効化する必要があるかを確認します。**デフォルトで利用可能** 列に **いいえ** と表示されている場合、その決済手段を手動で有効化する必要があります。 プラットフォームの連結アカウントの所有者に対して支払い方法の管理を許可する場合は、これらの支払い方法を[ダッシュボード](https://dashboard.stripe.com/settings/payment_methods)から有効にするように指示します。 ![ダッシュボードを介した、連結アカウントの支払い方法のカスタマイズのスクリーンショット。利用可能な支払い方法が有効であり、利用可能であることを示します。](https://b.stripecdn.com/docs-statics-srv/assets/turn-on-payments.afef26196ebae8f5564d328d6ba73b92.png) 支払い方法のカスタマイズ プラットフォームの連結アカウントの所有者に対して支払い方法のカスタマイズを許可しない場合は、[手動の設定ページ](https://dashboard.stripe.com/settings/payment_methods)にアクセスするように指示します。 ![支払い方法が一覧表示された手動設定ページのスクリーンショット。アクセスのリクエスト、招待のリクエスト、設定を行うためのオプションを含みます。](https://b.stripecdn.com/docs-statics-srv/assets/manual-settings.db0a0c2abebb94e197e1bef683ea7db9.png) 支払い方法の手動設定 > **埋め込み支払い方法設定コンポーネント**を使用すると、接続アカウントは Stripe ダッシュボードにアクセスすることなく、Checkout で提供する支払い方法を設定できます。[埋め込み支払い方法設定コンポーネント](https://docs.stripe.com/connect/supported-embedded-components/payment-method-settings.md)の詳細を確認し、利用可能になった際に通知を受け取ってください。 ## 連結アカウントが支払い方法を受け付けるための条件を満たしていることを確認する [必須] で `on_behalf_of` パラメーターが使用されている場合、プラットフォームで連結アカウントを所有する売り手またはサービスプロバイダーは、ダイレクト支払いによる ノーコードのソリューションの場合、新しいアカウントの[連結アカウントの決済の設定ページ](https://docs.stripe.com/connect/payment-methods.md)でオプションを設定して、決済手段と国の組み合わせごとに新規と既存の連結アカウントのケイパビリティをリクエストします。 API システムでは、[ケイパビリティエンドポイント](https://docs.stripe.com/api/capabilities/update.md)を使用して、受け付ける決済手段ごとに新規と既存の連結アカウントの決済手段ケイパビリティをリクエストします。新規アカウントでケイパビリティのリクエストを開始すると、既存のアカウントより前に、自動設定によって決済手段を受け付けることができます。 ほとんどの決済手段にはカードと同じ確認要件がありますが、いくつかの制限と例外があります。[決済手段ケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)の表には、カードの追加確認が必要な決済手段がリストされています。 [Capabilities endpoints](https://docs.stripe.com/api/capabilities/list.md) を使用して、各アカウントがデフォルトで使用できる [payment method capabilities](https://docs.stripe.com/connect/account-capabilities.md#payment-methods) ケイパビリティに関するクエリを実行できます。使用できるケイパビリティは、アカウントの国やその他の要因によって異なる場合があります。 ```curl curl -X POST https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" ``` レスポンスには、`capabilities` ハッシュと、連結アカウントの現在のケイパビリティのステータスが含まれています。 ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", ..."capabilities": { "card_payments": "active", "ideal_payments": "active", "sepa_debit_payments": "pending", "transfers": "active" }, ... } ``` ## 連結アカウントの支払い方法を有効にする [推奨] 必要な場合は、支払い方法の情報に関する次のリソースをご覧ください。 - 自社のプラットフォームに適した支払い方法を選択するには、[支払い方法ガイド](https://stripe.com/payments/payment-methods-guide#choosing-the-right-payment-methods-for-your-business)をご覧ください。 - [アカウントのケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md) を使用して、選択した決済手段が連結アカウントで機能することを確認します。 - [決済手段と製品サポート](https://docs.stripe.com/payments/payment-methods/payment-method-support.md#product-support)の表を参照して、選択した決済手段が使用中の Stripe プロダクトと決済フローで機能することを確認します。 Stripe は連結アカウントに対して特定の決済手段をデフォルトで有効にします。ダッシュボードの[連結アカウントの決済手段を管理する](https://dashboard.stripe.com/settings/payment_methods/connected_accounts)ページに移動して、連結アカウントで受け付ける決済手段を設定します。デフォルト設定への変更は、新規および既存のすべての連結アカウントに適用されます。 支払い方法ごとに、次のいずれかのドロップダウンオプションを選択できます。 | | | | | **デフォルトで有効にする** | 連結アカウントは、決済フローでこの支払い方法に対応します。一部の支払い方法は、無効またはブロックになっている可能性があります。 | | **デフォルトで無効にする** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | | **ブロック済み** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | ![支払い方法のドロップダウンオプション。支払い方法ごとに選択可能なオプション (ブロック済み、デフォルトで有効にする、デフォルトで無効にする) を示します。](https://b.stripecdn.com/docs-statics-srv/assets/dropdowns.ef651d721d5939d81521dd34dde4577f.png) 支払い方法のオプション 支払い方法を変更した場合は、画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、連結アカウントを更新する必要があります。 ![保存ボタンをクリックした後に表示される、ユーザーが変更した内容のリストを含むダイアログ](https://b.stripecdn.com/docs-statics-srv/assets/dialog.a56ea7716f60db9778706790320d13be.png) ダイアログを保存する ## Payment Element を組み込む [必須] [ダイレクト支払いの作成](https://docs.stripe.com/connect/direct-charges.md?platform=web&ui=elements)手順に従って、Payment Element を実装します。 `PaymentIntent` の作成時には次のようにしてください。 - `Stripe-Account` ヘッダーと連結アカウント ID を指定し、購入で[ダイレクト支払い](https://docs.stripe.com/connect/direct-charges.md)が使用されていることを確認します。 - 該当する場合は、`application_fee_amount` パラメーターの値を指定して、プラットフォームに送られる購入の金額を設定します。 次のコードは、ヘッダーで指定された連結アカウントの 10 EUR の `PaymentIntent` を作成します。プラットフォームは 1 EUR のプラットフォーム手数料を請求します。 ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d amount=1000 \ -d currency=eur \ -d application_fee_amount=100 \ -d "automatic_payment_methods[enabled]=true" ``` ## 通知遅延型の支払い方法を処理する (該当する場合) [推奨] [通知遅延型の決済手段を処理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)方法については、[ダッシュボードで決済手段を管理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)ステップに従ってください。 ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## 連結アカウントが支払い方法を受け付けるための条件を満たしていることを確認する [必須] で `on_behalf_of` パラメーターが使用されている場合、プラットフォームで連結アカウントを所有する売り手またはサービスプロバイダーは、ダイレクト支払いによる ノーコードのソリューションの場合、新しいアカウントの [Express 設定](https://dashboard.stripe.com/settings/connect/express)または[連結アカウントの決済の設定ページ](https://docs.stripe.com/connect/payment-methods.md)でオプションを設定して、決済手段と国の組み合わせごとに新規と既存の連結アカウントのケイパビリティをリクエストします。 API システムでは、[ケイパビリティエンドポイント](https://docs.stripe.com/api/capabilities/update.md)を使用して、受け付ける決済手段ごとに新規と既存の連結アカウントの決済手段ケイパビリティをリクエストします。新規アカウントでケイパビリティのリクエストを開始すると、既存のアカウントより前に、自動設定によって決済手段を受け付けることができます。 ほとんどの決済手段にはカードと同じ確認要件がありますが、いくつかの制限と例外があります。[決済手段ケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)の表には、カードの追加確認が必要な決済手段がリストされています。 [Capabilities endpoints](https://docs.stripe.com/api/capabilities/list.md) を使用して、各アカウントがデフォルトで使用できる [payment method capabilities](https://docs.stripe.com/connect/account-capabilities.md#payment-methods) ケイパビリティに関するクエリを実行できます。使用できるケイパビリティは、アカウントの国やその他の要因によって異なる場合があります。 ```curl curl -X POST https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" ``` レスポンスには、`capabilities` ハッシュと、連結アカウントの現在のケイパビリティのステータスが含まれています。 ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", ..."capabilities": { "card_payments": "active", "ideal_payments": "active", "sepa_debit_payments": "pending", "transfers": "active" }, ... } ``` ## 連結アカウントの支払い方法を有効にする [推奨] 必要な場合は、支払い方法の情報に関する次のリソースをご覧ください。 - 自社のプラットフォームに適した支払い方法を選択するには、[支払い方法ガイド](https://stripe.com/payments/payment-methods-guide#choosing-the-right-payment-methods-for-your-business)をご覧ください。 - [アカウントのケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md) を使用して、選択した決済手段が連結アカウントで機能することを確認します。 - [決済手段と製品サポート](https://docs.stripe.com/payments/payment-methods/payment-method-support.md#product-support)の表を参照して、選択した決済手段が使用中の Stripe プロダクトと決済フローで機能することを確認します。 Stripe は連結アカウントに対して特定の決済手段をデフォルトで有効にします。ダッシュボードの[連結アカウントの決済手段を管理する](https://dashboard.stripe.com/settings/payment_methods/connected_accounts)ページに移動して、連結アカウントで受け付ける決済手段を設定します。デフォルト設定への変更は、新規および既存のすべての連結アカウントに適用されます。 支払い方法ごとに、次のいずれかのドロップダウンオプションを選択できます。 | | | | | **デフォルトで有効にする** | 連結アカウントは、決済フローでこの支払い方法に対応します。一部の支払い方法は、無効またはブロックになっている可能性があります。 | | **デフォルトで無効にする** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | | **ブロック済み** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | ![支払い方法のドロップダウンオプション。支払い方法ごとに選択可能なオプション (ブロック済み、デフォルトで有効にする、デフォルトで無効にする) を示します。](https://b.stripecdn.com/docs-statics-srv/assets/dropdowns.ef651d721d5939d81521dd34dde4577f.png) 支払い方法のオプション 支払い方法を変更した場合は、画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、連結アカウントを更新する必要があります。 ![保存ボタンをクリックした後に表示される、ユーザーが変更した内容のリストを含むダイアログ](https://b.stripecdn.com/docs-statics-srv/assets/dialog.a56ea7716f60db9778706790320d13be.png) ダイアログを保存する ## Payment Element を組み込む [必須] [ダイレクト支払いの作成](https://docs.stripe.com/connect/direct-charges.md?platform=web&ui=elements)手順に従って、Payment Element を実装します。 `PaymentIntent` の作成時には次のようにしてください。 - `Stripe-Account` ヘッダーと連結アカウント ID を指定し、購入で[ダイレクト支払い](https://docs.stripe.com/connect/direct-charges.md)が使用されていることを確認します。 - 該当する場合は、`application_fee_amount` パラメーターの値を指定して、プラットフォームに送られる購入の金額を設定します。 次のコードは、ヘッダーで指定された連結アカウントの 10 EUR の `PaymentIntent` を作成します。プラットフォームは 1 EUR のプラットフォーム手数料を請求します。 ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d amount=1000 \ -d currency=eur \ -d application_fee_amount=100 \ -d "automatic_payment_methods[enabled]=true" ``` ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 > Stripe では、Stripe ダッシュボードにアクセスできる連結アカウントに対して、デスティネーション支払いではなくダイレクト支払いを使用することを推奨しています。詳細については、[支払いタイプ](https://docs.stripe.com/connect/charges.md#types)をご覧ください。 ## 連結アカウントの支払い方法を有効にする [推奨] 必要な場合は、支払い方法の情報に関する次のリソースをご覧ください。 - 自社のプラットフォームに適した支払い方法を選択するには、[支払い方法ガイド](https://stripe.com/payments/payment-methods-guide#choosing-the-right-payment-methods-for-your-business)をご覧ください。 - [アカウントのケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md) を使用して、選択した決済手段が連結アカウントで機能することを確認します。 - [決済手段と製品サポート](https://docs.stripe.com/payments/payment-methods/payment-method-support.md#product-support)の表を参照して、選択した決済手段が使用中の Stripe プロダクトと決済フローで機能することを確認します。 Stripe は連結アカウントに対して特定の決済手段をデフォルトで有効にします。ダッシュボードの[連結アカウントの決済手段を管理する](https://dashboard.stripe.com/settings/payment_methods/connected_accounts)ページに移動して、連結アカウントで受け付ける決済手段を設定します。デフォルト設定への変更は、新規および既存のすべての連結アカウントに適用されます。 支払い方法ごとに、次のいずれかのドロップダウンオプションを選択できます。 | | | | | **デフォルトで有効にする** | 連結アカウントは、決済フローでこの支払い方法に対応します。一部の支払い方法は、プラットフォームの連結アカウントの所有者がダッシュボードの設定ページで有効化する必要があるため、無効またはブロックになっている可能性があります。 | | **デフォルトで無効にする** | 連結アカウントは、決済フローでこの支払い方法に対応しません。プラットフォームの連結アカウントの所有者がダッシュボードで独自の支払い方法を管理することを許可されていても、連結アカウントはこれを有効にできません。 | | **ブロック済み** | 連結アカウントは、決済フローでこの支払い方法に対応しません。プラットフォームの連結アカウントの所有者がダッシュボードで独自の支払い方法を管理することを許可していても、連結アカウントはこれを有効にできません。 | ![支払い方法のドロップダウンオプション。支払い方法ごとに選択可能なオプション (ブロック済み、デフォルトで有効にする、デフォルトで無効にする) を示します。](https://b.stripecdn.com/docs-statics-srv/assets/dropdowns.ef651d721d5939d81521dd34dde4577f.png) 支払い方法のオプション 支払い方法を変更した場合は、画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、連結アカウントを更新する必要があります。 ![保存ボタンをクリックした後に表示される、ユーザーが変更した内容のリストを含むダイアログ](https://b.stripecdn.com/docs-statics-srv/assets/dialog.a56ea7716f60db9778706790320d13be.png) ダイアログを保存する ## 連結アカウントによる支払い方法の管理を許可する [推奨] Stripe では、プラットフォームの連結アカウントの所有者がダッシュボードから独自の支払い方法をカスタマイズできるようにすることをお勧めしています。このオプションを有効にすると、Stripe ダッシュボードにアクセスできる各連結アカウントが各自のダッシュボードにログインして[支払い方法](https://dashboard.stripe.com/settings/payment_methods)ページを表示できるようになります。ダッシュボードには、新規および既存のすべての連結アカウントに対して適用される支払い方法のデフォルトのセットが表示されます。プラットフォームの連結アカウントの所有者は、お客様がブロックした支払い方法を除き、これらのデフォルトを上書きできます。 このオプションを有効にするには、**アカウントのカスタマイズ**チェックボックスを選択します。画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、この設定を更新する必要があります。 ![連結アカウントの所有者に支払い方法のカスタマイズを許可する際に選択するチェックボックスのスクリーンショット](https://b.stripecdn.com/docs-statics-srv/assets/checkbox.275bd35d2a025272f03af029a144e577.png) アカウントのカスタマイズのチェックボックス ## Payment Element を組み込む [必須] [デスティネーション支払いの作成](https://docs.stripe.com/connect/destination-charges.md?platform=web&ui=elements)手順に従って、Payment Element を実装します。 `PaymentIntent` を作成する際に、`application_fee_amount` パラメーターの値を指定してプラットフォーム手数料を徴収します。連結アカウントに送金される売上からその金額分が差し引かれます。 次のコードは、送金先として指定された連結アカウントの 10 EUR の `PaymentIntent` を作成します。プラットフォームは 1 EUR のプラットフォーム手数料を請求します。 ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1000 \ -d currency=eur \ -d application_fee_amount=100 \ -d "automatic_payment_methods[enabled]=true" \ -d "transfer_data[destination]={{CONNECTEDACCOUNT_ID}}" ``` ## 通知遅延型の支払い方法を処理する (該当する場合) [推奨] [通知遅延型の決済手段を処理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)方法については、[ダッシュボードで決済手段を管理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)ステップに従ってください。 ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。いずれかのテストアカウントにログインして **決済手段** の設定に移動し、連結アカウントの設定を表示します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## Stripe ダッシュボードにアクセスできる連結アカウントが、設定ステップを必要とする支払い方法を有効化できるようにする [オプション] [決済手段の機能](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)の表には、使用前に手動で有効化する必要がある決済手段と、カードに加えて必要な確認要件が記載されています。プラットフォームの連結アカウントの所有者に、[手動設定ページ](https://dashboard.stripe.com/settings/payment_methods)にアクセスして、Stripe ダッシュボードにアクセスできる連結アカウントでデフォルトでは利用できない決済手段を有効にするよう案内します。 ![支払い方法が一覧表示された手動設定ページのスクリーンショット。アクセスのリクエスト、招待のリクエスト、設定を行うためのオプションを含みます。](https://b.stripecdn.com/docs-statics-srv/assets/manual-settings.db0a0c2abebb94e197e1bef683ea7db9.png) 支払い方法の手動設定 > **埋め込み支払い方法設定コンポーネント**を使用すると、接続アカウントは Stripe ダッシュボードにアクセスすることなく、Checkout で提供する支払い方法を設定できます。[埋め込み支払い方法設定コンポーネント](https://docs.stripe.com/connect/supported-embedded-components/payment-method-settings.md)の詳細を確認し、利用可能になった際に通知を受け取ってください。 > Stripe では、Stripe ダッシュボードにアクセスできる連結アカウントに対して、デスティネーション支払いではなくダイレクト支払いを使用することを推奨しています。詳細については、[支払いタイプ](https://docs.stripe.com/connect/charges.md#types)をご覧ください。 ## 購入時に利用できる支払い方法を選択する [推奨] ダッシュボードの[支払い方法](https://dashboard.stripe.com/settings/payment_methods)ページから、アカウントの支払い方法を設定します。連結アカウントは支払い方法をカスタマイズできません。 ## Payment Element を組み込む [必須] [デスティネーション支払いの作成](https://docs.stripe.com/connect/destination-charges.md?platform=web&ui=elements)手順に従って、Payment Element を実装します。 `PaymentIntent` を作成する際に、`application_fee_amount` パラメーターの値を指定してプラットフォーム手数料を徴収します。連結アカウントに送金される売上からその金額分が差し引かれます。 次のコードは、送金先として指定された連結アカウントの 10 EUR の `PaymentIntent` を作成します。プラットフォームは 1 EUR のプラットフォーム手数料を請求します。 ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1000 \ -d currency=eur \ -d application_fee_amount=100 \ -d "automatic_payment_methods[enabled]=true" \ -d "transfer_data[destination]={{CONNECTEDACCOUNT_ID}}" ``` ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。いずれかのテストアカウントにログインして **決済手段** の設定に移動し、連結アカウントの設定を表示します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 > Stripe ダッシュボードにアクセスできる連結アカウントについては、支払いと送金を別々にする方式ではなく、ダイレクト支払いを使用することが推奨されます。詳細については、[支払いタイプ](https://docs.stripe.com/connect/charges.md#types)をご覧ください。 ## 連結アカウントの支払い方法を有効にする [推奨] 必要な場合は、支払い方法の情報に関する次のリソースをご覧ください。 - 自社のプラットフォームに適した支払い方法を選択するには、[支払い方法ガイド](https://stripe.com/payments/payment-methods-guide#choosing-the-right-payment-methods-for-your-business)をご覧ください。 - [アカウントのケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md) を使用して、選択した決済手段が連結アカウントで機能することを確認します。 - [決済手段と製品サポート](https://docs.stripe.com/payments/payment-methods/payment-method-support.md#product-support)の表を参照して、選択した決済手段が使用中の Stripe プロダクトと決済フローで機能することを確認します。 Stripe は連結アカウントに対して特定の決済手段をデフォルトで有効にします。ダッシュボードの[連結アカウントの決済手段を管理する](https://dashboard.stripe.com/settings/payment_methods/connected_accounts)ページに移動して、連結アカウントで受け付ける決済手段を設定します。デフォルト設定への変更は、新規および既存のすべての連結アカウントに適用されます。 支払い方法ごとに、次のいずれかのドロップダウンオプションを選択できます。 | | | | | **デフォルトで有効にする** | 連結アカウントは、決済フローでこの支払い方法に対応します。一部の支払い方法は、プラットフォームの連結アカウントの所有者がダッシュボードの設定ページで有効化する必要があるため、無効またはブロックになっている可能性があります。 | | **デフォルトで無効にする** | 連結アカウントは、決済フローでこの支払い方法に対応しません。プラットフォームの連結アカウントの所有者がダッシュボードで独自の支払い方法を管理することを許可されていても、連結アカウントはこれを有効にできません。 | | **ブロック済み** | 連結アカウントは、決済フローでこの支払い方法に対応しません。プラットフォームの連結アカウントの所有者がダッシュボードで独自の支払い方法を管理することを許可していても、連結アカウントはこれを有効にできません。 | ![支払い方法のドロップダウンオプション。支払い方法ごとに選択可能なオプション (ブロック済み、デフォルトで有効にする、デフォルトで無効にする) を示します。](https://b.stripecdn.com/docs-statics-srv/assets/dropdowns.ef651d721d5939d81521dd34dde4577f.png) 支払い方法のオプション 支払い方法を変更した場合は、画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、連結アカウントを更新する必要があります。 ![保存ボタンをクリックした後に表示される、ユーザーが変更した内容のリストを含むダイアログ](https://b.stripecdn.com/docs-statics-srv/assets/dialog.a56ea7716f60db9778706790320d13be.png) ダイアログを保存する ## 連結アカウントによる支払い方法の管理を許可する [推奨] Stripe では、プラットフォームの連結アカウントの所有者がダッシュボードから独自の支払い方法をカスタマイズできるようにすることをお勧めしています。このオプションを有効にすると、Stripe ダッシュボードにアクセスできる各連結アカウントが各自のダッシュボードにログインして[支払い方法](https://dashboard.stripe.com/settings/payment_methods)ページを表示できるようになります。ダッシュボードには、新規および既存のすべての連結アカウントに対して適用される支払い方法のデフォルトのセットが表示されます。プラットフォームの連結アカウントの所有者は、お客様がブロックした支払い方法を除き、これらのデフォルトを上書きできます。 このオプションを有効にするには、**アカウントのカスタマイズ**チェックボックスを選択します。画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、この設定を更新する必要があります。 ![連結アカウントの所有者に支払い方法のカスタマイズを許可する際に選択するチェックボックスのスクリーンショット](https://b.stripecdn.com/docs-statics-srv/assets/checkbox.275bd35d2a025272f03af029a144e577.png) アカウントのカスタマイズのチェックボックス ## Payment Element を組み込む [必須] [支払いと送金別方式の作成](https://docs.stripe.com/connect/separate-charges-and-transfers.md?platform=web&ui=elements)手順に従って、Payment Element を実装します。 次のコードは、10 EUR の `PaymentIntent` を作成します。連結アカウントに売上を送金する際に、`transfer_group` を使用して支払いを識別します。プラットフォーム手数料を徴収するには、連結アカウントに送金する金額から手数料を差し引きます。 ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1000 \ -d currency=eur \ -d "automatic_payment_methods[enabled]=true" \ -d transfer_group=ORDER100 ``` ## 通知遅延型の支払い方法を処理する (該当する場合) [推奨] [通知遅延型の決済手段を処理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)方法については、[ダッシュボードで決済手段を管理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)ステップに従ってください。 ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。いずれかのテストアカウントにログインして **決済手段** の設定に移動し、連結アカウントの設定を表示します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## Stripe ダッシュボードにアクセスできる連結アカウントが、設定ステップを必要とする支払い方法を有効化できるようにする [オプション] [決済手段の機能](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)の表には、使用前に手動で有効化する必要がある決済手段と、カードに加えて必要な確認要件が記載されています。プラットフォームの連結アカウントの所有者に、[手動設定ページ](https://dashboard.stripe.com/settings/payment_methods)にアクセスして、Stripe ダッシュボードにアクセスできる連結アカウントでデフォルトでは利用できない決済手段を有効にするよう案内します。 ![支払い方法が一覧表示された手動設定ページのスクリーンショット。アクセスのリクエスト、招待のリクエスト、設定を行うためのオプションを含みます。](https://b.stripecdn.com/docs-statics-srv/assets/manual-settings.db0a0c2abebb94e197e1bef683ea7db9.png) 支払い方法の手動設定 > **埋め込み支払い方法設定コンポーネント**を使用すると、接続アカウントは Stripe ダッシュボードにアクセスすることなく、Checkout で提供する支払い方法を設定できます。[埋め込み支払い方法設定コンポーネント](https://docs.stripe.com/connect/supported-embedded-components/payment-method-settings.md)の詳細を確認し、利用可能になった際に通知を受け取ってください。 > Stripe ダッシュボードにアクセスできる連結アカウントについては、支払いと送金を別々にする方式ではなく、ダイレクト支払いを使用することが推奨されます。詳細については、[支払いタイプ](https://docs.stripe.com/connect/charges.md#types)をご覧ください。 ## 購入時に利用できる支払い方法を選択する [推奨] ダッシュボードの[支払い方法](https://dashboard.stripe.com/settings/payment_methods)ページから、アカウントの支払い方法を設定します。連結アカウントは支払い方法をカスタマイズできません。 ## Payment Element を組み込む [必須] [支払いと送金別方式の作成](https://docs.stripe.com/connect/separate-charges-and-transfers.md?platform=web&ui=elements)手順に従って、Payment Element を実装します。 次のコードは、10 EUR の `PaymentIntent` を作成します。連結アカウントに売上を送金する際に、`transfer_group` を使用して支払いを識別します。プラットフォーム手数料を徴収するには、連結アカウントに送金する金額から手数料を差し引きます。 ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1000 \ -d currency=eur \ -d "automatic_payment_methods[enabled]=true" \ -d transfer_group=ORDER100 ``` ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。いずれかのテストアカウントにログインして **決済手段** の設定に移動し、連結アカウントの設定を表示します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## 連結アカウントが支払い方法を受け付けるための条件を満たしていることを確認する [必須] デスティネーション支払いで `on_behalf_of` パラメーターが使用されている場合、プラットフォームで連結アカウントを所有する売り手またはサービスプロバイダーは、[売上処理加盟店](https://docs.stripe.com/connect/destination-charges.md#settlement-merchant)です。そのため、プラットフォームの連結アカウントの所有者が追加の決済手段を受け付けられるようにするには、連結アカウントで受け付ける[各決済手段のケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)が有効になっていることを確認する必要があります。 ノーコードのソリューションの場合、新しいアカウントの [Express 設定](https://dashboard.stripe.com/settings/connect/express)または[連結アカウントの決済の設定ページ](https://docs.stripe.com/connect/payment-methods.md)でオプションを設定して、決済手段と国の組み合わせごとに新規と既存の連結アカウントのケイパビリティをリクエストします。 API システムでは、[ケイパビリティエンドポイント](https://docs.stripe.com/api/capabilities/update.md)を使用して、受け付ける決済手段ごとに新規と既存の連結アカウントの決済手段ケイパビリティをリクエストします。新規アカウントでケイパビリティのリクエストを開始すると、既存のアカウントより前に、自動設定によって決済手段を受け付けることができます。 ほとんどの決済手段にはカードと同じ確認要件がありますが、いくつかの制限と例外があります。[決済手段ケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)の表には、カードの追加確認が必要な決済手段がリストされています。 [Capabilities endpoints](https://docs.stripe.com/api/capabilities/list.md) を使用して、各アカウントがデフォルトで使用できる [payment method capabilities](https://docs.stripe.com/connect/account-capabilities.md#payment-methods) ケイパビリティに関するクエリを実行できます。使用できるケイパビリティは、アカウントの国やその他の要因によって異なる場合があります。 ```curl curl -X POST https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" ``` レスポンスには、`capabilities` ハッシュと、連結アカウントの現在のケイパビリティのステータスが含まれています。 ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", ..."capabilities": { "card_payments": "active", "ideal_payments": "active", "sepa_debit_payments": "pending", "transfers": "active" }, ... } ``` ## 連結アカウントの支払い方法を有効にする [推奨] 必要な場合は、支払い方法の情報に関する次のリソースをご覧ください。 - 自社のプラットフォームに適した支払い方法を選択するには、[支払い方法ガイド](https://stripe.com/payments/payment-methods-guide#choosing-the-right-payment-methods-for-your-business)をご覧ください。 - [アカウントのケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md) を使用して、選択した決済手段が連結アカウントで機能することを確認します。 - [決済手段と製品サポート](https://docs.stripe.com/payments/payment-methods/payment-method-support.md#product-support)の表を参照して、選択した決済手段が使用中の Stripe プロダクトと決済フローで機能することを確認します。 Stripe は連結アカウントに対して特定の決済手段をデフォルトで有効にします。ダッシュボードの[連結アカウントの決済手段を管理する](https://dashboard.stripe.com/settings/payment_methods/connected_accounts)ページに移動して、連結アカウントで受け付ける決済手段を設定します。デフォルト設定への変更は、新規および既存のすべての連結アカウントに適用されます。 支払い方法ごとに、次のいずれかのドロップダウンオプションを選択できます。 | | | | | **デフォルトで有効にする** | 連結アカウントは、決済フローでこの支払い方法に対応します。一部の支払い方法は、無効またはブロックになっている可能性があります。 | | **デフォルトで無効にする** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | | **ブロック済み** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | ![支払い方法のドロップダウンオプション。支払い方法ごとに選択可能なオプション (ブロック済み、デフォルトで有効にする、デフォルトで無効にする) を示します。](https://b.stripecdn.com/docs-statics-srv/assets/dropdowns.ef651d721d5939d81521dd34dde4577f.png) 支払い方法のオプション 支払い方法を変更した場合は、画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、連結アカウントを更新する必要があります。 ![保存ボタンをクリックした後に表示される、ユーザーが変更した内容のリストを含むダイアログ](https://b.stripecdn.com/docs-statics-srv/assets/dialog.a56ea7716f60db9778706790320d13be.png) ダイアログを保存する ## Payment Element を組み込む [必須] [デスティネーション支払いの作成](https://docs.stripe.com/connect/destination-charges.md?platform=web&ui=elements)手順に従って、Payment Element を実装します。 `PaymentIntent` を作成する際に、`application_fee_amount` パラメーターの値を指定してプラットフォーム手数料を徴収します。連結アカウントに送金される売上からその金額分が差し引かれます。 次のコードは、送金先として指定された連結アカウントの 10 EUR の `PaymentIntent` を作成します。プラットフォームは 1 EUR のプラットフォーム手数料を請求します。 ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1000 \ -d currency=eur \ -d application_fee_amount=100 \ -d "automatic_payment_methods[enabled]=true" \ -d "transfer_data[destination]={{CONNECTEDACCOUNT_ID}}" ``` ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 > Stripe では、Stripe ダッシュボードにアクセスできる連結アカウントに対して、デスティネーション支払いではなくダイレクト支払いを使用することを推奨しています。詳細については、[支払いタイプ](https://docs.stripe.com/connect/charges.md#types)をご覧ください。 ## 購入時に利用できる支払い方法を選択する [推奨] ダッシュボードの[支払い方法](https://dashboard.stripe.com/settings/payment_methods)ページから、アカウントの支払い方法を設定します。連結アカウントは支払い方法をカスタマイズできません。 ## Payment Element を組み込む [必須] [デスティネーション支払いの作成](https://docs.stripe.com/connect/destination-charges.md?platform=web&ui=elements)手順に従って、Payment Element を実装します。 `PaymentIntent` を作成する際に、`application_fee_amount` パラメーターの値を指定してプラットフォーム手数料を徴収します。連結アカウントに送金される売上からその金額分が差し引かれます。 次のコードは、送金先として指定された連結アカウントの 10 EUR の `PaymentIntent` を作成します。プラットフォームは 1 EUR のプラットフォーム手数料を請求します。 ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1000 \ -d currency=eur \ -d application_fee_amount=100 \ -d "automatic_payment_methods[enabled]=true" \ -d "transfer_data[destination]={{CONNECTEDACCOUNT_ID}}" ``` ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。いずれかのテストアカウントにログインして **決済手段** の設定に移動し、連結アカウントの設定を表示します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## 連結アカウントが支払い方法を受け付けるための条件を満たしていることを確認する [必須] で `on_behalf_of` パラメーターが使用されている場合、プラットフォームで連結アカウントを所有する売り手またはサービスプロバイダーは、[売上処理加盟店](https://docs.stripe.com/connect/destination-charges.md#settlement-merchant)です。そのため、プラットフォームの連結アカウントの所有者が追加の決済手段を受け付けられるようにするには、連結アカウントで受け付ける[各決済手段のケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)が有効になっていることを確認する必要があります。 ノーコードのソリューションの場合、新しいアカウントの [Express 設定](https://dashboard.stripe.com/settings/connect/express)または[連結アカウントの決済の設定ページ](https://docs.stripe.com/connect/payment-methods.md)でオプションを設定して、決済手段と国の組み合わせごとに新規と既存の連結アカウントのケイパビリティをリクエストします。 API システムでは、[ケイパビリティエンドポイント](https://docs.stripe.com/api/capabilities/update.md)を使用して、受け付ける決済手段ごとに新規と既存の連結アカウントの決済手段ケイパビリティをリクエストします。新規アカウントでケイパビリティのリクエストを開始すると、既存のアカウントより前に、自動設定によって決済手段を受け付けることができます。 ほとんどの決済手段にはカードと同じ確認要件がありますが、いくつかの制限と例外があります。[決済手段ケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)の表には、カードの追加確認が必要な決済手段がリストされています。 [Capabilities endpoints](https://docs.stripe.com/api/capabilities/list.md) を使用して、各アカウントがデフォルトで使用できる [payment method capabilities](https://docs.stripe.com/connect/account-capabilities.md#payment-methods) ケイパビリティに関するクエリを実行できます。使用できるケイパビリティは、アカウントの国やその他の要因によって異なる場合があります。 ```curl curl -X POST https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" ``` レスポンスには、`capabilities` ハッシュと、連結アカウントの現在のケイパビリティのステータスが含まれています。 ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", ..."capabilities": { "card_payments": "active", "ideal_payments": "active", "sepa_debit_payments": "pending", "transfers": "active" }, ... } ``` ## 連結アカウントの支払い方法を有効にする [推奨] 必要な場合は、支払い方法の情報に関する次のリソースをご覧ください。 - 自社のプラットフォームに適した支払い方法を選択するには、[支払い方法ガイド](https://stripe.com/payments/payment-methods-guide#choosing-the-right-payment-methods-for-your-business)をご覧ください。 - [アカウントのケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md) を使用して、選択した決済手段が連結アカウントで機能することを確認します。 - [決済手段と製品サポート](https://docs.stripe.com/payments/payment-methods/payment-method-support.md#product-support)の表を参照して、選択した決済手段が使用中の Stripe プロダクトと決済フローで機能することを確認します。 Stripe は連結アカウントに対して特定の決済手段をデフォルトで有効にします。ダッシュボードの[連結アカウントの決済手段を管理する](https://dashboard.stripe.com/settings/payment_methods/connected_accounts)ページに移動して、連結アカウントで受け付ける決済手段を設定します。デフォルト設定への変更は、新規および既存のすべての連結アカウントに適用されます。 支払い方法ごとに、次のいずれかのドロップダウンオプションを選択できます。 | | | | | **デフォルトで有効にする** | 連結アカウントは、決済フローでこの支払い方法に対応します。一部の支払い方法は、無効またはブロックになっている可能性があります。 | | **デフォルトで無効にする** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | | **ブロック済み** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | ![支払い方法のドロップダウンオプション。支払い方法ごとに選択可能なオプション (ブロック済み、デフォルトで有効にする、デフォルトで無効にする) を示します。](https://b.stripecdn.com/docs-statics-srv/assets/dropdowns.ef651d721d5939d81521dd34dde4577f.png) 支払い方法のオプション 支払い方法を変更した場合は、画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、連結アカウントを更新する必要があります。 ![保存ボタンをクリックした後に表示される、ユーザーが変更した内容のリストを含むダイアログ](https://b.stripecdn.com/docs-statics-srv/assets/dialog.a56ea7716f60db9778706790320d13be.png) ダイアログを保存する ## Payment Element を組み込む [必須] [支払いと送金別方式の作成](https://docs.stripe.com/connect/separate-charges-and-transfers.md?platform=web&ui=elements)手順に従って、Payment Element を実装します。 次のコードは、10 EUR の `PaymentIntent` を作成します。連結アカウントに売上を送金する際に、`transfer_group` を使用して支払いを識別します。プラットフォーム手数料を徴収するには、連結アカウントに送金する金額から手数料を差し引きます。 ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1000 \ -d currency=eur \ -d "automatic_payment_methods[enabled]=true" \ -d transfer_group=ORDER100 ``` ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## 購入時に利用できる支払い方法を選択する [推奨] ダッシュボードの[支払い方法](https://dashboard.stripe.com/settings/payment_methods)ページから、アカウントの支払い方法を設定します。連結アカウントは支払い方法をカスタマイズできません。 ## Payment Element を組み込む [必須] [支払いと送金別方式の作成](https://docs.stripe.com/connect/separate-charges-and-transfers.md?platform=web&ui=elements)手順に従って、Payment Element を実装します。 次のコードは、10 EUR の `PaymentIntent` を作成します。連結アカウントに売上を送金する際に、`transfer_group` を使用して支払いを識別します。プラットフォーム手数料を徴収するには、連結アカウントに送金する金額から手数料を差し引きます。 ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1000 \ -d currency=eur \ -d "automatic_payment_methods[enabled]=true" \ -d transfer_group=ORDER100 ``` ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## 連結アカウントが支払い方法を受け付けるための条件を満たしていることを確認する [必須] デスティネーション支払いで `on_behalf_of` パラメーターが使用されている場合、プラットフォームで連結アカウントを所有する売り手またはサービスプロバイダーは、[売上処理加盟店](https://docs.stripe.com/connect/destination-charges.md#settlement-merchant)です。そのため、プラットフォームの連結アカウントの所有者が追加の決済手段を受け付けられるようにするには、連結アカウントで受け付ける[各決済手段のケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)が有効になっていることを確認する必要があります。 ノーコードのソリューションの場合、新しいアカウントの[連結アカウントの決済の設定ページ](https://docs.stripe.com/connect/payment-methods.md)でオプションを設定して、決済手段と国の組み合わせごとに新規と既存の連結アカウントのケイパビリティをリクエストします。 API システムでは、[ケイパビリティエンドポイント](https://docs.stripe.com/api/capabilities/update.md)を使用して、受け付ける決済手段ごとに新規と既存の連結アカウントの決済手段ケイパビリティをリクエストします。新規アカウントでケイパビリティのリクエストを開始すると、既存のアカウントより前に、自動設定によって決済手段を受け付けることができます。 ほとんどの決済手段にはカードと同じ確認要件がありますが、いくつかの制限と例外があります。[決済手段ケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)の表には、カードの追加確認が必要な決済手段がリストされています。 [Capabilities endpoints](https://docs.stripe.com/api/capabilities/list.md) を使用して、各アカウントがデフォルトで使用できる [payment method capabilities](https://docs.stripe.com/connect/account-capabilities.md#payment-methods) ケイパビリティに関するクエリを実行できます。使用できるケイパビリティは、アカウントの国やその他の要因によって異なる場合があります。 ```curl curl -X POST https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" ``` レスポンスには、`capabilities` ハッシュと、連結アカウントの現在のケイパビリティのステータスが含まれています。 ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", ..."capabilities": { "card_payments": "active", "ideal_payments": "active", "sepa_debit_payments": "pending", "transfers": "active" }, ... } ``` ## 連結アカウントの支払い方法を有効にする [推奨] 必要な場合は、支払い方法の情報に関する次のリソースをご覧ください。 - 自社のプラットフォームに適した支払い方法を選択するには、[支払い方法ガイド](https://stripe.com/payments/payment-methods-guide#choosing-the-right-payment-methods-for-your-business)をご覧ください。 - [アカウントのケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md) を使用して、選択した決済手段が連結アカウントで機能することを確認します。 - [決済手段と製品サポート](https://docs.stripe.com/payments/payment-methods/payment-method-support.md#product-support)の表を参照して、選択した決済手段が使用中の Stripe プロダクトと決済フローで機能することを確認します。 Stripe は連結アカウントに対して特定の決済手段をデフォルトで有効にします。ダッシュボードの[連結アカウントの決済手段を管理する](https://dashboard.stripe.com/settings/payment_methods/connected_accounts)ページに移動して、連結アカウントで受け付ける決済手段を設定します。デフォルト設定への変更は、新規および既存のすべての連結アカウントに適用されます。 支払い方法ごとに、次のいずれかのドロップダウンオプションを選択できます。 | | | | | **デフォルトで有効にする** | 連結アカウントは、決済フローでこの支払い方法に対応します。一部の支払い方法は、無効またはブロックになっている可能性があります。 | | **デフォルトで無効にする** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | | **ブロック済み** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | ![支払い方法のドロップダウンオプション。支払い方法ごとに選択可能なオプション (ブロック済み、デフォルトで有効にする、デフォルトで無効にする) を示します。](https://b.stripecdn.com/docs-statics-srv/assets/dropdowns.ef651d721d5939d81521dd34dde4577f.png) 支払い方法のオプション 支払い方法を変更した場合は、画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、連結アカウントを更新する必要があります。 ![保存ボタンをクリックした後に表示される、ユーザーが変更した内容のリストを含むダイアログ](https://b.stripecdn.com/docs-statics-srv/assets/dialog.a56ea7716f60db9778706790320d13be.png) ダイアログを保存する ## Payment Element を組み込む [必須] [デスティネーション支払いの作成](https://docs.stripe.com/connect/destination-charges.md?platform=web&ui=elements)手順に従って、Payment Element を実装します。 `PaymentIntent` を作成する際に、`application_fee_amount` パラメーターの値を指定してプラットフォーム手数料を徴収します。連結アカウントに送金される売上からその金額分が差し引かれます。 次のコードは、送金先として指定された連結アカウントの 10 EUR の `PaymentIntent` を作成します。プラットフォームは 1 EUR のプラットフォーム手数料を請求します。 ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1000 \ -d currency=eur \ -d application_fee_amount=100 \ -d "automatic_payment_methods[enabled]=true" \ -d "transfer_data[destination]={{CONNECTEDACCOUNT_ID}}" ``` ## 通知遅延型の支払い方法を処理する (該当する場合) [推奨] [通知遅延型の決済手段を処理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)方法については、[ダッシュボードで決済手段を管理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)ステップに従ってください。 ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## 購入時に利用できる支払い方法を選択する [推奨] ダッシュボードの[支払い方法](https://dashboard.stripe.com/settings/payment_methods)ページから、アカウントの支払い方法を設定します。連結アカウントは支払い方法をカスタマイズできません。 ## Payment Element を組み込む [必須] [デスティネーション支払いの作成](https://docs.stripe.com/connect/destination-charges.md?platform=web&ui=elements)手順に従って、Payment Element を実装します。 `PaymentIntent` を作成する際に、`application_fee_amount` パラメーターの値を指定してプラットフォーム手数料を徴収します。連結アカウントに送金される売上からその金額分が差し引かれます。 次のコードは、送金先として指定された連結アカウントの 10 EUR の `PaymentIntent` を作成します。プラットフォームは 1 EUR のプラットフォーム手数料を請求します。 ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1000 \ -d currency=eur \ -d application_fee_amount=100 \ -d "automatic_payment_methods[enabled]=true" \ -d "transfer_data[destination]={{CONNECTEDACCOUNT_ID}}" ``` ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## 連結アカウントが支払い方法を受け付けるための条件を満たしていることを確認する [必須] で `on_behalf_of` パラメーターが使用されている場合、プラットフォームで連結アカウントを所有する売り手またはサービスプロバイダーは、[売上処理加盟店](https://docs.stripe.com/connect/destination-charges.md#settlement-merchant)です。そのため、プラットフォームの連結アカウントの所有者が追加の決済手段を受け付けられるようにするには、連結アカウントで受け付ける[各決済手段のケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)が有効になっていることを確認する必要があります。 ノーコードのソリューションの場合、新しいアカウントの[連結アカウントの決済の設定ページ](https://docs.stripe.com/connect/payment-methods.md)でオプションを設定して、決済手段と国の組み合わせごとに新規と既存の連結アカウントのケイパビリティをリクエストします。 API システムでは、[ケイパビリティエンドポイント](https://docs.stripe.com/api/capabilities/update.md)を使用して、受け付ける決済手段ごとに新規と既存の連結アカウントの決済手段ケイパビリティをリクエストします。新規アカウントでケイパビリティのリクエストを開始すると、既存のアカウントより前に、自動設定によって決済手段を受け付けることができます。 ほとんどの決済手段にはカードと同じ確認要件がありますが、いくつかの制限と例外があります。[決済手段ケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)の表には、カードの追加確認が必要な決済手段がリストされています。 [Capabilities endpoints](https://docs.stripe.com/api/capabilities/list.md) を使用して、各アカウントがデフォルトで使用できる [payment method capabilities](https://docs.stripe.com/connect/account-capabilities.md#payment-methods) ケイパビリティに関するクエリを実行できます。使用できるケイパビリティは、アカウントの国やその他の要因によって異なる場合があります。 ```curl curl -X POST https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" ``` レスポンスには、`capabilities` ハッシュと、連結アカウントの現在のケイパビリティのステータスが含まれています。 ```json { "id": ""{{CONNECTED_ACCOUNT_ID}}"", "object": "account", ..."capabilities": { "card_payments": "active", "ideal_payments": "active", "sepa_debit_payments": "pending", "transfers": "active" }, ... } ``` ## 連結アカウントの支払い方法を有効にする [推奨] 必要な場合は、支払い方法の情報に関する次のリソースをご覧ください。 - 自社のプラットフォームに適した支払い方法を選択するには、[支払い方法ガイド](https://stripe.com/payments/payment-methods-guide#choosing-the-right-payment-methods-for-your-business)をご覧ください。 - [アカウントのケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md) を使用して、選択した決済手段が連結アカウントで機能することを確認します。 - [決済手段と製品サポート](https://docs.stripe.com/payments/payment-methods/payment-method-support.md#product-support)の表を参照して、選択した決済手段が使用中の Stripe プロダクトと決済フローで機能することを確認します。 Stripe は連結アカウントに対して特定の決済手段をデフォルトで有効にします。ダッシュボードの[連結アカウントの決済手段を管理する](https://dashboard.stripe.com/settings/payment_methods/connected_accounts)ページに移動して、連結アカウントで受け付ける決済手段を設定します。デフォルト設定への変更は、新規および既存のすべての連結アカウントに適用されます。 支払い方法ごとに、次のいずれかのドロップダウンオプションを選択できます。 | | | | | **デフォルトで有効にする** | 連結アカウントは、決済フローでこの支払い方法に対応します。一部の支払い方法は、無効またはブロックになっている可能性があります。 | | **デフォルトで無効にする** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | | **ブロック済み** | 連結アカウントは、決済フローでこの支払い方法に対応しません。 | ![支払い方法のドロップダウンオプション。支払い方法ごとに選択可能なオプション (ブロック済み、デフォルトで有効にする、デフォルトで無効にする) を示します。](https://b.stripecdn.com/docs-statics-srv/assets/dropdowns.ef651d721d5939d81521dd34dde4577f.png) 支払い方法のオプション 支払い方法を変更した場合は、画面下部のバーにある**変更を確認**をクリックし、**保存して適用**をクリックして、連結アカウントを更新する必要があります。 ![保存ボタンをクリックした後に表示される、ユーザーが変更した内容のリストを含むダイアログ](https://b.stripecdn.com/docs-statics-srv/assets/dialog.a56ea7716f60db9778706790320d13be.png) ダイアログを保存する ## Payment Element を組み込む [必須] [支払いと送金別方式の作成](https://docs.stripe.com/connect/separate-charges-and-transfers.md?platform=web&ui=elements)手順に従って、Payment Element を実装します。 次のコードは、10 EUR の `PaymentIntent` を作成します。連結アカウントに売上を送金する際に、`transfer_group` を使用して支払いを識別します。プラットフォーム手数料を徴収するには、連結アカウントに送金する金額から手数料を差し引きます。 ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1000 \ -d currency=eur \ -d "automatic_payment_methods[enabled]=true" \ -d transfer_group=ORDER100 ``` ## 通知遅延型の支払い方法を処理する (該当する場合) [推奨] [通知遅延型の決済手段を処理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)方法については、[ダッシュボードで決済手段を管理する](https://docs.stripe.com/payments/dashboard-payment-methods.md#delayed-notifications)ステップに従ってください。 ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## 購入時に利用できる支払い方法を選択する [推奨] ダッシュボードの[支払い方法](https://dashboard.stripe.com/settings/payment_methods)ページから、アカウントの支払い方法を設定します。連結アカウントは支払い方法をカスタマイズできません。 ## Payment Element を組み込む [必須] [支払いと送金別方式の作成](https://docs.stripe.com/connect/separate-charges-and-transfers.md?platform=web&ui=elements)手順に従って、Payment Element を実装します。 次のコードは、10 EUR の `PaymentIntent` を作成します。連結アカウントに売上を送金する際に、`transfer_group` を使用して支払いを識別します。プラットフォーム手数料を徴収するには、連結アカウントに送金する金額から手数料を差し引きます。 ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1000 \ -d currency=eur \ -d "automatic_payment_methods[enabled]=true" \ -d transfer_group=ORDER100 ``` ## 組み込みをテストする [推奨] [連携機能をテスト](https://docs.stripe.com/payments/dashboard-payment-methods.md#testing)して、想定通りに動作することを確認します。テスト API キーとテストアカウントを使用して決済フローをテストします。想定している決済手段が利用できない場合には、[決済手段製品サポート表](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)を参照して、商品と事業者が通貨と国において互換性があることを確認します。 ## See also - [Connect の導入ガイド](https://docs.stripe.com/connect/charges.md) - [Payment Method Configurations API](https://docs.stripe.com/connect/payment-method-configurations.md) - [複数の支払い方法の設定](https://docs.stripe.com/connect/multiple-payment-method-configurations.md) - [支払い方法ケイパビリティを追加する](https://docs.stripe.com/connect/payment-methods.md)