Skip to content

Abertura de Conta (Onboarding / KYC) — Visão Geral do Fluxo ​

Fluxo de cadastro de um novo cliente (Pessoa Física ou Jurídica) até a solicitação ficar pronta para análise humana. É um fluxo self-service — cada etapa se autentica sozinha por document + register_id (ou senha, quando a operação é sensível), sem precisar de um token de sessão.

Prefixo base: https://developer-api.fastgivr.com.br/access (cadastro) e https://developer-api.fastgivr.com.br/backoffice (revisão).

Como navegar esta seção ​

Como o fluxo é decidido: PF ou PJ ​

O tipo de conta é decidido automaticamente pelo tamanho do document enviado logo na primeira etapa (11 dígitos = CPF → Pessoa Física, 14 = CNPJ → Pessoa Jurídica) — não existe um endpoint de cadastro separado para cada tipo. As duas primeiras etapas (criar usuário, iniciar solicitação) e a confirmação de e-mail são idênticas nos dois fluxos; a partir da etapa de dados cadastrais, cada tipo segue seu próprio endpoint (personal-data só aceita Pessoa Física, company-data só aceita Pessoa Jurídica — cada um recusa a chamada se for feito no tipo de conta errado).

As etapas de preenchimento de dados não têm ordem obrigatória entre si e são todas idempotentes — podem ser chamadas quantas vezes forem necessárias, em qualquer ordem, sempre identificando a solicitação por register_id + document. Não existe uma etapa "finalizar cadastro": o status já reflete sozinho o quanto falta (ver Status da Solicitação).

Retomar um cadastro parado no meio ​

  • Se o cliente ainda tem o register_id guardado localmente (mesma sessão/navegador): as etapas de preenchimento e o reenvio/confirmação de e-mail já são idempotentes, então basta continuar chamando-as normalmente.
  • Se o cliente perdeu o register_id (fechou o navegador, trocou de aparelho): chamar POST /access/register/user de novo com o mesmo document + a senha original devolve o usuário existente ("Cadastro retomado.") em vez de erro; e POST /access/register de novo devolve a solicitação já existente. Para saber o que já foi preenchido (e assim decidir em qual etapa retomar), usar POST /access/register/resume — exige a senha porque devolve dados sensíveis (nome da mãe, endereço, telefone, faixa de renda).