Skip to content

Abertura de Conta — Revisão e Aprovação ​

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

Última fase do fluxo: depois que o cliente termina o cadastro (status PENDING, ver Status da Solicitação), a equipe de análise revisa e decide aprovar ou reprovar. Estes endpoints exigem autenticação.


Revisão ​

GET /backoffice/registers — Listar solicitações ​

Lista paginada. Filtros disponíveis: search (nome/documento/e-mail), status, account_type, created_from/created_to; ordenação por order_by/order_dir.

GET /backoffice/registers/{id} — Detalhe completo ​

Retorna todos os dados coletados no cadastro (dados pessoais/empresa, endereço, telefone, documentos com motivo de reprovação quando houver, sócios em Pessoa Jurídica) mais os dados do usuário vinculado.

PATCH /backoffice/registers/{id}/reject — Reprovar a solicitação inteira ​

Body: { "reason": "..." } (obrigatório)

Move o status para REJECTED e grava o motivo.

PATCH /backoffice/registers/{id}/documents/{documentId}/reject — Reprovar um documento específico ​

Body: { "reason": "..." } (obrigatório)

Marca só aquele documento como reprovado — a solicitação como um todo volta automaticamente para "falta documento" (ver Status da Solicitação), sem reprovar tudo.

Ainda não existe endpoint de aprovação nesta seção

Aprovar uma solicitação é feito pelos endpoints abaixo, que também escolhem o banco.


Aprovação ​

Uma solicitação só pode ser aprovada quando o status é PENDING (cadastro completo) — qualquer uma destas chamadas recusa (422) fora desse estado, para evitar processar a mesma solicitação duas vezes.

POST /backoffice/registers/{id}/approve — Sinalizar pronto para aprovação ​

Sem corpo. Só confirma que o cadastro está completo — não altera nada na solicitação; sinaliza que a equipe pode prosseguir para a aprovação na Fidúcia.

POST /backoffice/registers/{id}/fiducia — Aprovar via Fidúcia ​

Sem corpo — os dados vêm todos da solicitação já preenchida. A abertura usa a integração real com a Fidúcia:

  • A chamada responde imediatamente, movendo o status para FIDUCIA_ANALYSIS (evita um segundo clique enquanto processa).
  • O processamento de verdade acontece em segundo plano — a criação da conta no banco parceiro é assíncrona, dividida em etapas (cliente → telefone → endereço → sócios, na PJ → documentos → análise).
  • Se der certo, o status fica em FIDUCIA_ANALYSIS até a confirmação manual (abaixo): a Fidúcia não informa o resultado da análise pela API. Se falhar em qualquer etapa, o status volta para PENDING, o erro fica registrado (log da aplicação + tabela logs, type = system + fiducia_response) e fica disponível na consulta abaixo.
  • Reenviar pelo mesmo endpoint retoma de onde parou — cada etapa concluída antes da falha (telefone já enviado, endereço já enviado, cada documento já enviado, etc.) não é refeita, evitando duplicar dados do lado da Fidúcia. Só a etapa que falhou (e as seguintes, ainda não alcançadas) é executada de novo.

GET /backoffice/registers/{id}/account/status — Consultar o resultado ​

Retorna account_status, o banco aprovado e, quando aplicável, a referência e a resposta do processamento com a Fidúcia — útil para acompanhar uma aprovação que está FIDUCIA_ANALYSIS até ela terminar.

POST /backoffice/registers/{id}/confirm-account — Confirmar a conta aberta ​

Quando a Fidúcia aprovar, o operador informa os dados da conta gerada. Só aceita solicitações em FIDUCIA_ANALYSIS.

json
{ "agency": "0001", "account": "123456-7", "fiducia_password": "opcional", "fiducia_operator_code": "opcional" }
  • Cria a conta no banco Fidúcia (nome, documento, e-mail, celular e endereço da solicitação), com o titular como Administrador (conta PJ) ou Titular (conta PF).
  • fiducia_password e fiducia_operator_code são o login da conta na API de Contas da Fidúcia; gravados criptografados e nunca devolvidos.
  • Marca a solicitação como ACTIVE e envia o e-mail de boas-vindas (falha no envio não desfaz a conta).
  • 422: status diferente de FIDUCIA_ANALYSIS, agência/conta já usadas na Fidúcia ou formato inválido (agency só números; account números com dígito opcional, ex.: 123456-7).
  • Response 201: data.register (detalhe da solicitação) e data.account (id, agency, account, status).