# 連結アカウントを作成して事前入力する マーケットプレイスの連結アカウントを作成します。 連結アカウントは、ユーザー (売り手、代行業者、ベンダーなど) に属する Stripe アカウントです。連結アカウントを使用すると、マーケットプレイスはユーザーに代わって決済を受け付け、資金を管理すると同時に、売り手ごとに個別の財務記録を保持できます。マーケットプレイスは、マーケットプレイス内の売り手または代行業者ごとに連結アカウントを作成して、決済の円滑化、入金の処理、法令遵守と報告の徹底を図る必要があります。このように分離することで、各連結アカウントは独自の取引履歴、事業情報、入金スケジュールを持つことができます。マーケットプレイスはプラットフォーム手数料の請求や決済フロー全体の管理を行えるようになり、最終顧客は購入後に領収書で売り手または代行業者の名前ではなく、マーケットプレイスの名前を見ることができます。 このガイドでは、連結アカウントを作成し、関連フィールドに事前入力する方法を説明します。 ## Before you begin インタラクティブなプラットフォームガイドに従って、[Stripe マーケットプレイスアカウント](https://docs.stripe.com/connect/interactive-platform-guide.md) を設定します。 ## 連結アカウントを作成する Accounts v2 API を使用して、[連結アカウントのダッシュボードと責任](https://docs.stripe.com/connect/accounts-v2/connected-account-configuration.md)を指定して、連結アカウントを[作成](https://docs.stripe.com/api/v2/core/accounts/create.md)します。マーケットプレイスとして、プラットフォームは次のことを実行します。 - 通常、*マーチャントオブレコード* (The legal entity responsible for facilitating the sale of products to a customer that handles any applicable regulations and liabilities, including sales taxes. In a Connect integration, it can be the platform or a connected account) - *間接決済* (A charge type where customers transact directly with your platform instead of with a connected account. Indirect charges include destination charges and separate charges and transfers) を使用 - 不審請求の申し立てと返金を管理 - プラットフォーム手数料を通じて各取引から利幅を得て収入を得る これらの機能は、連結アカウントの作成時に設定するパラメーターに影響します。 ### アカウント構成の割り当て 連結アカウントは、貴社から割り当てられた設定に基づいて貴社のプラットフォームおよび Stripe とやり取りします。ほとんどのマーケットプレイスは、連結アカウントに [recipient](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-recipient) の構成を割り当てていますが、一部のマーケットプレイスは [merchant](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-merchant) の構成も割り当てています。 `recipient` の設定には、`stripe_balance.stripe_transfers` の機能が含まれています。この機能により当該 `Account` の Stripe 残高が、プラットフォームの残高からの [Transfers](https://docs.stripe.com/api/transfers/object.md?api-version=preview) を受け取れるようになります。間接決済を使用する場合は、`stripe_balance.stripe_transfers` 機能を必ず割り当てる必要があります。 また下記のようなケースでは、`merchant` の構成を連結アカウントに割り当てる必要があります。 - [直接課金](https://docs.stripe.com/connect/direct-charges.md) を使用します。マーケットプレイスでこの課金タイプが使用されることはまれです。 - [indirect charges with the on_behalf_of parameter](https://docs.stripe.com/connect/charges.md#on_behalf_of) を使って、連結アカウントを *マーチャントオブレコード* (The legal entity responsible for facilitating the sale of products to a customer that handles any applicable regulations and liabilities, including sales taxes. In a Connect integration, it can be the platform or a connected account) に設定します。 ### コードサンプル ```curl curl -X POST https://api.stripe.com/v2/core/accounts \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-03-25.preview" \ --json '{ "contact_email": "testaccount@example.com", "display_name": "Test account", "defaults": { "responsibilities": { "fees_collector": "application", "losses_collector": "application" } }, "dashboard": "express", "identity": { "country": "us" }, "configuration": { "recipient": { "capabilities": { "stripe_balance": { "stripe_transfers": { "requested": true } } } } }, "include": [ "configuration.recipient", "identity", "requirements" ] }' ``` | パラメーター | 値 | 説明 | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [defaults.responsibilities.fees_collector](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-defaults-responsibilities-fees_collector) | `application` | マーケットプレイスは、決済処理手数料を含むすべての Stripe 手数料を支払います。 | | [defaults.responsibilities.losses_collector](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-defaults-responsibilities-losses_collector) | `application` | マーケットプレイスは *マイナス残高に対する責任を負い* (The responsibility for managing risk and recovering negative balances on connected accounts. Stripe or the Connect platform can be liable for negative balances on connected accounts)、連結アカウントのクレジットリスクと不正利用リスクを管理します。ダッシュボードで責任をレビューして承認する必要があります。 | | [dashboard](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-dashboard) | `express` | 連結アカウントは Express ダッシュボードにアクセスできます。 | | [configuration.recipient.capabilities](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-recipient-capabilities) | ‘stripe_balance.stripe_transfers’ | 連結アカウントは、貴社のマーケットプレイスから資金を受け取ることができます。 | レスポンスには ID が含まれ、インテグレーション全体で `Account` の参照に使用されます。リクエストが成功すると、アカウントは保留状態になります。次に、既存の加盟店情報を使用して、連結アカウントのユーザー登録フォームに事前入力します。 ## アカウント情報を事前に入力 連結アカウントの情報をすでに収集している場合は、`Account` オブジェクトにその情報を事前入力できます。個人情報や事業情報、外部のアカウント情報など、あらゆるアカウント情報を事前に入力できます。 `Account` を作成したら、`relationship.representative` を true に設定した [Person](https://docs.stripe.com/api/persons/create.md) を作成して、アカウント開設の責任者と、事前に入力したいアカウント情報 (氏名など) を表します。 ```curl curl https://api.stripe.com/v1/accounts/{{ACCOUNT_ID}}/persons \ -u "<>:" \ -d first_name=Jenny \ -d last_name=Rosen \ -d "relationship[representative]=true" ``` Connect アカウント登録で、事前入力された情報が要求されることはありません。ただし、アカウント所有者は [Connect 利用規約](https://docs.stripe.com/connect/service-agreement-types.md)に同意する前に、事前入力された情報を確認するよう求められます。 実装内容をテストする場合、[テストデータ](https://docs.stripe.com/connect/testing.md)を使用してアカウント情報を事前入力します。 ## 次のステップ 事業情報を事前に入力したら、連結アカウントが[ダッシュボードにアクセス](https://docs.stripe.com/connect/marketplace/tasks/dashboard.md)できるよう設定します。