Aparência
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_ANALYSISaté 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 paraPENDING, o erro fica registrado (log da aplicação + tabelalogs,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_passwordefiducia_operator_codesão o login da conta na API de Contas da Fidúcia; gravados criptografados e nunca devolvidos.- Marca a solicitação como
ACTIVEe envia o e-mail de boas-vindas (falha no envio não desfaz a conta). 422: status diferente deFIDUCIA_ANALYSIS, agência/conta já usadas na Fidúcia ou formato inválido (agencysó números;accountnúmeros com dígito opcional, ex.:123456-7).- Response 201:
data.register(detalhe da solicitação) edata.account(id,agency,account,status).