Cria uma conta adicional (2ª conta) para uma pessoa que já passou
pelo onboarding (proposta COMPLETED) — portanto já existe na Autra
People. Não há KYC neste fluxo: a identidade já foi verificada.
O productId vem no body — o chamador decide de qual produto é a nova
conta (pode ser o mesmo produto da 1ª conta ou outro).
Comportamento assíncrono
A criação na Autra é assíncrona: a conta nasce em status BLOCKED e
agência/número só ficam disponíveis depois. O backend faz um polling
curto (best-effort); se ainda não houver agência, a resposta vem com
agency/number vazios e status: BLOCKED — consulte
GET /v1/banking/accounts/{accountId} depois para os dados finais.
Deduplicação
Se a Autra deduplicar (pessoa já tem conta nesse produto) ela devolve a
conta existente. Não é erro: a resposta é 200 com created: false e
os dados da conta existente. Quando uma conta nova é de fato criada, a
resposta é 201 com created: true. Criar uma conta genuinamente nova
para uma pessoa que já tem conta no produto é um processo externo a
este endpoint.
Ownership
A pessoa precisa ter uma proposta de onboarding COMPLETED no tenant
autenticado — caso contrário a resposta é 404 PERSON_NOT_FOUND.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
200A Autra deduplicou e devolveu uma conta já existente (created: false). Mesmo shape do 201.
400productId ou personId ausente / body inválido.
404PERSON_NOT_FOUND — pessoa não pertence ao tenant ou onboarding não concluído.
422DOCK_ACCOUNT_REJECTED — a Autra rejeitou a criação (ex.: falta um Setup ID para o produto). O corpo traz a mensagem original da Autra.
