Skip to content

Abertura de Conta — Pessoa Jurídica (PJ) ​

Prefixo base: https://developer-api.fastgivr.com.br/access

Sequência completa para abrir uma conta Pessoa Jurídica. As etapas 5–9 não têm ordem obrigatória entre si e são idempotentes (podem ser repetidas), mas a ordem abaixo é a recomendada. Para o contrato completo de cada endpoint (payload/campos/resposta), ver a Referência de Endpoints.

Visão geral da sequência ​

1. Criar usuário               → POST /access/register/user
2. Iniciar solicitação         → POST /access/register
3. Confirmar e-mail            → POST /access/register/email/verify
4. Dados da empresa            → PATCH /access/register/company-data
5. Sócios (um por chamada)     → POST /access/register/partners
6. Endereço                    → PATCH /access/register/address
7. Telefone                    → PATCH /access/register/phone
8. Documentos                  → POST /access/register/documents (uma vez por tipo)
9. Validação de identidade (uma por sócio) → POST /access/register/identity-validation
   → status muda para "pronto para análise" automaticamente quando tudo estiver completo,
     inclusive a validação de identidade de todos os sócios

Etapa 1 — Criar usuário ​

Objetivo: Criar as credenciais de login antes de iniciar a solicitação.

Endpoint: POST /access/register/user

Dados coletados: nome (razão social), e-mail, CNPJ, telefone, senha.

CampoObrigatórioObservação
nameSimRazão social da empresa
emailSimÚnico no sistema
documentSimCNPJ (14 dígitos) — define que o fluxo é PJ
phoneSim
passwordSimmín. 5 caracteres

Dependências: Nenhuma — é o primeiro passo.

Dados retornados a reutilizar: document (usado em todas as chamadas seguintes para identificar a solicitação).


Etapa 2 — Iniciar a solicitação ​

Objetivo: Criar a solicitação de abertura de conta (KYC) vinculada ao usuário da etapa 1.

Endpoint: POST /access/register

Dados coletados: só o document — nome e e-mail já vêm do usuário criado na etapa 1.

CampoObrigatórioObservação
documentSimO mesmo CNPJ da etapa 1

Dependências: Requer o usuário já criado (etapa 1).

Dados retornados a reutilizar: id — vira o register_id usado em todas as chamadas seguintes.

Nesse momento a API envia automaticamente um código de verificação por e-mail.


Etapa 3 — Confirmar o e-mail ​

Objetivo: Validar o e-mail antes de liberar o preenchimento dos dados da empresa.

Endpoint: POST /access/register/email/verify(se o código não chegar ou expirar, reenviar com POST /access/register/email antes de tentar de novo)

Dados coletados: o código de 4 números recebido por e-mail.

CampoObrigatórioObservação
register_idSimDa etapa 2
documentSim
validation_codeSimVálido por 10 minutos

Dependências: Requer a solicitação já iniciada (etapa 2).

Dados retornados a reutilizar: Nenhum novo — a solicitação passa a aceitar as próximas etapas.


Etapa 4 — Dados da empresa ​

Objetivo: Preencher os dados de KYC da empresa.

Endpoint: PATCH /access/register/company-data

Dados coletados: natureza jurídica, atividade econômica, data de fundação, faturamento, se tem fins lucrativos, nome fantasia.

CampoObrigatórioObservação
register_id / documentSim
legal_natureSimNatureza jurídica (MEI, LTDA, S.A. etc.)
cnaeSimAtividade econômica
founding_dateSimYYYY-MM-DD
invoicingSimFaixa de faturamento, texto livre
profitableSim"Y" ou "N"
trade_nameNãoNome fantasia

Dependências: Requer e-mail confirmado (etapa 3). Recusa a chamada se a solicitação não for Pessoa Jurídica.

Dados retornados a reutilizar: Nenhum novo.


Etapa 5 — Sócios ​

Objetivo: Registrar cada sócio da empresa — obrigatório ter pelo menos um para a solicitação ficar completa.

Endpoint: POST /access/register/partners (repetir uma vez para cada sócio)

Dados coletados: nome, CPF, e-mail, telefone, percentual de participação, se é o responsável legal.

CampoObrigatórioObservação
register_id / documentSimDa empresa
partner_nameSim
partner_documentSimCPF do sócio
partner_emailNão
partner_phoneNão
ownership_percentageNão0–100
legal_representativeNãotrue para o sócio que assina pela empresa

Dependências: Recomendado depois da etapa 4, mas não é obrigatório nessa ordem. Reenviar o mesmo partner_document atualiza o sócio em vez de duplicar. Um sócio pode ser removido com DELETE /access/register/partners/{partnerId}.

Dados retornados a reutilizar: Nenhum novo. Sem nenhum sócio, a solicitação nunca fica pronta para análise — ver Status da Solicitação.


Etapa 6 — Endereço ​

Objetivo: Preencher o endereço da empresa.

Endpoint: PATCH /access/register/address

CampoObrigatórioObservação
register_id / documentSim
street, address_number, neighborhood, city, state, zip_codeSimstate com 2 letras
complementNão

Dependências: Nenhuma ordem obrigatória, mas normalmente vem depois dos dados da empresa e dos sócios.

Dados retornados a reutilizar: Nenhum novo.


Etapa 7 — Telefone ​

Objetivo: Registrar o telefone de contato da empresa.

Endpoint: PATCH /access/register/phone

CampoObrigatório
register_id / documentSim
phone_numberSim

Dependências: Nenhuma.

Dados retornados a reutilizar: Nenhum novo.


Etapa 8 — Documentos ​

Objetivo: Enviar os documentos obrigatórios da empresa — os documentos pessoais do responsável legal não entram mais aqui.

Endpoint: POST /access/register/documents (uma chamada por tipo de documento)

Documentos enviados nesta etapa (pelo computador):

TipoDe quem
cnpj_cardEmpresa (Cartão CNPJ)
social_contractEmpresa (Contrato Social / Estatuto)
proof_of_addressEmpresa (comprovante de endereço)

Dependências: Nenhuma ordem obrigatória. Reenviar o mesmo tipo substitui o arquivo anterior.

Dados retornados a reutilizar: Nenhum — a lista de documentos enviados pode ser conferida via POST /access/register/resume.

identity_front / identity_back / selfie do responsável legal

Esses 3 documentos não são mais enviados nesta etapa — eles são capturados na Etapa 9 (Validação de Identidade), pelo celular do responsável legal, junto com a prova de vida.


Etapa 9 — Validação de Identidade ​

Objetivo: Cada sócio precisa concluir sua própria validação de identidade (prova de vida + fotos do documento, frente e verso) pelo próprio celular — individualmente, não é uma validação única da empresa. As fotos enviadas pelo sócio marcado como responsável legal (legal_representative) são os RegisterDocument identity_front/identity_back/selfie da solicitação; as dos demais sócios ficam só como evidência da validação de cada um. Ver Validação de Identidade para o conceito completo.

Endpoint: POST /access/register/identity-validation (uma chamada por sócio, com partner_document)

Dependências: O sócio já precisa existir (etapa 5). Nenhuma ordem obrigatória com as demais etapas — mas a solicitação só fica "pronta para análise" depois que todos os sócios concluírem.

Dados retornados a reutilizar: token/link — enviar ao sócio para ele concluir a validação. Quem conclui a etapa é o provedor, via callback (POST /access/register/identity-validation/callback), não uma chamada do cliente.


Depois de completa ​

Assim que dados, sócios, endereço, telefone, todos os documentos obrigatórios e a validação de identidade de todos os sócios estiverem completos, o status da solicitação muda automaticamente para "pronto para análise" — não é preciso chamar nenhum endpoint adicional. A partir daí, a equipe de análise assume o processo (ver Revisão e Aprovação).