Conta e onboarding

Um owner/admin da organização deve criar a conta conectada e concluir o onboarding antes da primeira operação financeira. Essas ações exigem sessão humana Better Auth; não podem ser realizadas com API key.

Sequência atualCopiar link da seção

1. Autentique o owner/admin no dashboard.
2. Envie POST /v2/organizations/{organizationId}/stripe/account com contact_email e Idempotency-Key.
3. Envie POST /v2/organizations/{organizationId}/stripe/account/onboarding, também com Idempotency-Key.
4. Redirecione o usuário para o link hospedado retornado pelo Stripe.
5. Consulte GET /v2/organizations/{organizationId}/stripe/account para conferir requirements e capabilities.

O retorno do usuário ao seu aplicativo, por si só, não prova a conclusão da verificação. Consulte o estado atual da conta. O backend usa Accounts v2, Dashboard completo e responsabilidades de taxas e perdas atribuídas ao Stripe. As telas próprias de cadastro e verificação ainda estão em desenvolvimento.

URLs e isolamentoCopiar link da seção

O servidor configura as URLs de retorno e refresh do onboarding. O cliente não envia destinos arbitrários nem associa um acct_... escolhido por ele. A conta é vinculada à organização pelo backend.

A criação reserva os parâmetros e uma chave durável antes da chamada ao Stripe. Repetições retomam essa reserva. Se o provisionamento ficar pendente por 23 horas, o backend bloqueia nova criação até revisão administrativa para evitar duplicidade. Uma conta desconectada também exige revisão; eventos atrasados não reativam o vínculo.

Após essa preparação, integrações com API key podem consultar a conta com payment-account:read e operar os recursos autorizados.