# Criar e preencher previamente a conta conectada Crie contas conectadas para seu marketplace. Uma conta conectada é uma conta Stripe que pertence a um de seus usuários (como um vendedor, provedor de serviços ou fornecedor). As contas conectadas permitem que seu marketplace aceite pagamentos e gerencie fundos em nome de seus usuários, mantendo registros financeiros separados para cada vendedor. Sendo um marketplace, você deve criar contas conectadas para cada vendedor ou provedor de serviços em seu marketplace para facilitar os pagamentos, tratar os repasses do pagamento e garantir a conformidade e os relatórios adequados. Essa separação permite que cada conta conectada tenha seu próprio histórico de transações, dados comerciais e cronograma de repasses, ao mesmo tempo em que dá ao seu marketplace a capacidade de cobrar tarifas da plataforma e gerenciar o fluxo de pagamento geral. Os clientes finais veem o nome do seu marketplace nos recibos após fazer uma compra, em vez do nome do vendedor ou do provedor de serviços. Este guia mostra como criar uma conta conectada e preencher previamente os campos pertinentes. ## Before you begin Siga o guia interativo da plataforma para configurar a sua [conta do Stripe marketplace](https://docs.stripe.com/connect/interactive-platform-guide.md). ## Criar uma conta conectada Use a API Accounts v2 para [criar](https://docs.stripe.com/api/v2/core/accounts/create.md) uma conta conectada especificando o [Dashboard e as responsabilidades da conta conectada](https://docs.stripe.com/connect/accounts-v2/connected-account-configuration.md). Como um marketplace, sua plataforma: - Geralmente é o *comerciante do registro* (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) - Usa *cobranças indiretas* - Gerencia contestações e reembolsos - Obtém receitas ao receber uma parte de cada transação por meio de tarifas da plataforma Esses recursos afetam os parâmetros que você define ao criar as contas conectadas. ### Atribuir configurações de conta As contas conectadas interagem com sua plataforma e a Stripe dependendo de quais configurações você atribui. A maioria dos marketplaces atribui às contas conectadas a configuração [destinatário](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-recipient). Alguns marketplaces também atribuem a configuração [comerciante](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-merchant). A configuração `recipient` inclui a funcionalidade `stripe_balance.stripe_transfers`, que permite ao saldo da Stripe da `Account` receber [transferências](https://docs.stripe.com/api/transfers/object.md?api-version=preview) do saldo da plataforma. Atribua a funcionalidade `stripe_balance.stripe_transfers` para usar cobranças indiretas. Você também precisa atribuir a configuração `merchant` das suas contas conectadas nos seguintes casos: - Use [encargos diretos](https://docs.stripe.com/connect/direct-charges.md). É raro que os marketplaces usem esse tipo de cobrança. - Use [cobranças indiretas com o parâmetro on_behalf_of](https://docs.stripe.com/connect/charges.md#on_behalf_of) para definir um conta conectada como o *comerciante do registro* (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). ### Exemplo de código ```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" ] }' ``` | Parâmetro | Valor | Descrição | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [defaults.responsibilities.fees_collector](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-defaults-responsibilities-fees_collector) | `application` | Seu marketplace paga todas as tarifas da Stripe, inclusive as tarifas do processo de pagamento. | | [defaults.responsibilities.losses_collector](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-defaults-responsibilities-losses_collector) | `application` | seu marketplace é *responsible for negative balances* (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) e gerencia o risco de crédito e fraude na conta conectada. Para isso, você deve revisar e reconhecer suas responsabilidades no Dashboard. | | [dashboard](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-dashboard) | `express` | A conta conectada pode acessar o Dashboard Express. | | [configuration.recipient.capabilities](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-recipient-capabilities) | ‘stripe_balance.stripe_transfers’ | A conta conectada pode receber fundos do marketplace. | A resposta inclui o ID, que você usa para fazer referência a `Account` em toda a integração. Após a solicitação ser feita, a conta ficará em um estado pendente. Depois, use as informações que você já tem para pré-preencher o formulário de onboarding da conta conectada. ## Preencher previamente as informações da conta Se você já coletou dados de suas contas conectadas, pode usá-los para preencher o objeto `Account`. Você pode preencher quaisquer dados de conta, inclusive dados pessoais e comerciais, dados de contas externas e muito mais. Depois de criar uma `Account`, crie uma [Pessoa](https://docs.stripe.com/api/persons/create.md) para representar a pessoa responsável por abrir a conta, com `relationship.representative` definido como verdadeiro e informações da conta que você queira preencher previamente (por exemplo, o nome e sobrenome). ```curl curl https://api.stripe.com/v1/accounts/{{ACCOUNT_ID}}/persons \ -u "<>:" \ -d first_name=Jenny \ -d last_name=Rosen \ -d "relationship[representative]=true" ``` O Connect Onboarding não solicita as informações pré-preenchidas. No entanto, ele solicita que o titular da conta confirme as informações pré-preenchidas antes de aceitar o [contrato de serviços do Connect](https://docs.stripe.com/connect/service-agreement-types.md). Ao testar sua integração, preencha antecipadamente os dados da conta usando [dados de teste](https://docs.stripe.com/connect/testing.md). ## Próximas etapas Depois de preencher os dados comerciais, configure o [Acesso ao Dashboard](https://docs.stripe.com/connect/marketplace/tasks/dashboard.md) para a conta conectada.