Criar e preencher previamente a conta conectada

Use a API Accounts v2 para criar uma conta conectada especificando o Dashboard e as responsabilidades da conta conectada. Como um marketplace, sua plataforma:

• Geralmente é o comerciante do registro
• 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. Alguns marketplaces também atribuem a configuração comerciante.

A configuração recipient inclui a funcionalidade stripe_balance.stripe_transfers, que permite ao saldo da Stripe da Account receber transferências 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. É raro que os marketplaces usem esse tipo de cobrança.
• Use cobranças indiretas com o parâmetro on_behalf_of para definir um conta conectada como o comerciante do registro.

Exemplo de código

curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-09-30.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"
    ]
  }'

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.

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 conta, crie uma Pessoa com relationship.representative definido como true para representar a pessoa responsável por abrir o conta e quaisquer informações da conta que você deseja preencher antecipadamente (por exemplo, seu nome e sobrenome).

curl https://api.stripe.com/v1/accounts/
{{ACCOUNT_ID}}
/persons \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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.

Ao testar sua integração, preencha antecipadamente os dados da conta usando dados de teste.