Skip to content

Abertura de Conta — Status da Solicitação ​

O campo account_status, devolvido em toda resposta que traz dados da solicitação, indica em que ponto do fluxo ela está. Ele é recalculado automaticamente a cada etapa preenchida (dados pessoais/empresa, sócios, endereço, telefone, documentos, validação de identidade) — não é preciso chamar nenhum endpoint de "enviar para análise": assim que tudo estiver completo, o status já reflete isso sozinho.

Como o recálculo parte do zero a cada chamada, o status também pode regredir se algo que antes estava completo deixar de estar — por exemplo, remover o único sócio de uma empresa, ou a equipe de análise reprovar um documento obrigatório.

Valores possíveis ​

ValorNomeO que significa
0PENDINGDados, endereço, telefone, todos os documentos obrigatórios e a validação de identidade estão completos — pronto para análise
6EMAIL_NOT_VERIFIEDEstado inicial, logo após POST /access/register
7INVALID_ADDRESSE-mail confirmado, mas ainda falta dados pessoais/empresa (e sócios, se Pessoa Jurídica), endereço ou telefone
8INVALID_IMAGEDados, endereço e telefone completos, mas ainda falta algum documento obrigatório ou a validação de identidade
1APPROVEDAprovada pela equipe de análise
2REJECTEDReprovada pela equipe de análise
9FIDUCIA_ANALYSISAprovada e em processamento com o banco parceiro (Fidúcia) — ver Revisão e Aprovação
3ACTIVEConta ativa (etapa seguinte à aprovação)
4BLOCKEDConta bloqueada
5CANCELLEDSolicitação cancelada
-1DELETEDSolicitação removida

Prioridade da checagem (o que falta primeiro é o que decide o status): dados cadastrais → endereço → telefone → (documentos e validação de identidade, juntos). Ou seja, uma solicitação sem endereço mostra INVALID_ADDRESS mesmo que os documentos já tenham sido enviados fora de ordem — só quando dados, endereço e telefone estiverem completos é que documentos e validação de identidade passam a ser considerados.

Um documento obrigatório reprovado conta como "não enviado" para fins de status — reprovar um documento de uma solicitação que já estava PENDING a regride automaticamente para INVALID_IMAGE. O cliente percebe isso ao consultar GET /access/register/status ou POST /access/register/resume de novo. A validação de identidade segue a mesma lógica: sem ela completa (titular na PF, todos os sócios na PJ — ver Validação de Identidade), a solicitação não passa de INVALID_IMAGE.

current_step — em qual etapa a solicitação está ​

Além do account_status (amplo), a resposta de POST /access/register/resume também traz current_step: a primeira etapa da sequência canônica (criar usuário → confirmar e-mail → dados → sócios [PJ] → endereço → telefone → documentos → validação de identidade → pronta para análise) que ainda está em aberto, junto com completed_steps e pending_steps (listas, na mesma ordem). É só informativo — pensado para a tela de retomada saber em qual etapa reabrir o formulário — e não bloqueia nenhuma chamada fora de ordem; as etapas de preenchimento continuam podendo ser chamadas em qualquer sequência, exatamente como antes.

O que ainda não existe ​

  • Validação de telefone. Trocar o telefone reseta a validação, mas não há endpoint para efetivamente confirmá-lo (envio/conferência de código por SMS ou WhatsApp) — o preenchimento do número já é obrigatório para PENDING, mas a confirmação em si (phone_validated) ainda não entra no cálculo.
  • Reenvio após reprovação da solicitação inteira. Reprovar um documento específico já regride o status automaticamente (o cliente sabe que precisa reenviar algo), mas depois que a solicitação inteira é reprovada, ela fica travada nesse status — as etapas de preenchimento continuam aceitando chamadas normalmente, mas o status não sai sozinho de "reprovada" depois de uma correção. Hoje isso exige intervenção manual da equipe de análise.
  • Integração real da validação de identidade. A estrutura está pronta (ver Validação de Identidade), mas sem nenhum provedor de verificação facial conectado ainda.