Status de contas e pessoas
A listagem e a consulta de uma conta filha devolvem status da conta e person.status do titular como inteiros. Não há webhook de alteração desses status nem do status do onboarding. A listagem das contas está em Contas filhas. A abertura está em Onboarding.
Status da conta
| Valor | Nome | Significado |
|---|---|---|
0 | INACTIVE | Conta inativa |
1 | ACTIVE | Conta ativa |
7 | WAITING_AUTHORIZATION | Aguardando autorização |
8 | BLOCKED | Conta bloqueada |
9 | REMOVED | Conta removida ou encerrada |
Status da pessoa
| Valor | Nome | Significado |
|---|---|---|
0 | INACTIVE | Pessoa inativa |
1 | ACTIVE | Pessoa ativa |
2 | INCOMPLETE_P1 | Cadastro incompleto P1 |
3 | INCOMPLETE_P2 | Cadastro incompleto P2 |
4 | INCOMPLETE_P3 | Cadastro incompleto P3 |
7 | WAITING_AUTHORIZATION | Aguardando autorização |
8 | BLOCKED | Pessoa bloqueada |
9 | REMOVED | Pessoa removida ou encerrada |
10 | CREDIT_COUNTERPARTY | Contraparte de crédito |
2, 3 e 4 desta tabela são do titular. No onboarding, 2 é Aprovado, 3 é Rejeitado e 4 é Aguardando revisão.
Conta habilitada para operar
A combinação operacional é:
account.status = 1(ACTIVE)person.status = 1(ACTIVE)- vínculo da pessoa com a conta ativo, quando essa pessoa acessa a conta
- a operação específica liberada pela feature, pelo limite e pelo produto (Pix, TED, cash-out e demais)
Depois do onboarding aprovado
O status do onboarding é outro campo, em GET /onboardings e GET /onboardings/{id}:
| Valor | Significado |
|---|---|
0 | Pendente |
1 | Aguardando aprovação |
2 | Aprovado |
3 | Rejeitado |
4 | Aguardando revisão |
2 (Aprovado) encerra a análise. Se a aprovação criou a conta, o mesmo fluxo já grava a conta com account.status = 1, o saldo, o vínculo do titular e as features padrão do BaaS. Não há etapa assíncrona nem prazo adicional depois do aprovado.
Se a aprovação foi só da pessoa, sem criar conta, 2 não significa que existe conta operacional. Confirme em GET /accounts.
Consulta sem webhook
Não existe webhook de status de conta, de titular ou de onboarding. Os webhooks financeiros são da conta operada: com credencial BaaS, envie x-account-id. Os tipos são transfer, receive, refund, cashout, infraction, invoice e CRYPTO. Veja Configurando Webhook.
Consulte GET /onboardings/{id} enquanto o onboarding não chegar a um estado terminal (2 Aprovado ou 3 Rejeitado). Onboardings removidos deixam de ser retornados.
- enquanto estiver pendente, a cada 30–60 segundos
- depois de alguns minutos, a cada 2–5 minutos
- pare ao chegar em
2ou3 - para conciliar status de contas já abertas, a cada 5–15 minutos