Aparência
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
- Abertura de Conta PJ — sequência completa, passo a passo, para Pessoa Jurídica.
- Abertura de Conta Pessoa Física — sequência completa, passo a passo, para Pessoa Física.
- Referência de Endpoints — contrato completo (payload, campos, resposta) de cada endpoint usado nos dois fluxos, num só lugar.
- Validação de Identidade — a etapa de selfie/documento, individual por sócio na PJ.
- Status da Solicitação — o que cada status significa e como ele muda sozinho.
- Revisão e Aprovação — o que acontece depois que a solicitação está completa.
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_idguardado 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): chamarPOST /access/register/userde novo com o mesmodocument+ a senha original devolve o usuário existente ("Cadastro retomado.") em vez de erro; ePOST /access/registerde novo devolve a solicitação já existente. Para saber o que já foi preenchido (e assim decidir em qual etapa retomar), usarPOST /access/register/resume— exige a senha porque devolve dados sensíveis (nome da mãe, endereço, telefone, faixa de renda).