Captcha do titular
Quem consulta é a pessoa física. O hCaptcha da Receita é resolvido na página pública do App. Não há consulta automática sem essa etapa.
Consulta pública de CPF
Confirme o CPF do titular na Receita, no seu fluxo
O operador cria o App. O titular informa CPF e nascimento, resolve o captcha da Receita. Seu sistema recebe nome, situação cadastral e uma session.
Criar conta
10 créditos no cadastro.
Protocolo
Quatro passos, do App à session
- 01
Criar o App
No painel, cadastre nome, URL de callback e a cor da tela pública. O Vero gera o PublicId.
- 02
Enviar o titular
O titular abre /?appId=…, informa o próprio CPF e a data de nascimento, e resolve o captcha da Receita.
- 03
Receber a session
Com a consulta ok, o Vero redireciona para a callback do App com ?session=.
- 04
Ler o comprovante
GET /api/session/:id devolve nome, situação cadastral e os demais campos enquanto a session existir (cerca de 15 minutos).
Painel
Um saldo. Os Apps da Conta.
Cada consulta ok debita 1 crédito da Conta dona do App. No cadastro a Conta nasce com 10. Você configura nome, callback e cor de marca; o titular vê a tela pública com a identidade do App.
Integração
O que volta na session
Depois do redirect, leia GET /api/session/:id. O corpo é o mesmo da consulta: CPF, nome, nascimento, situação cadastral e o token da session.
Link do titular
https://seu-dominio/?appId=<publicId>
Exemplo de resposta
{
"status": true,
"cpf": "00000000000",
"nome": "NOME COMPLETO",
"dataNascimento": "1990-01-01",
"situacao": "REGULAR",
"timestamp": "2026-08-21T16:00:00.000Z",
"sessionToken": "…"
}Antes de integrar
O que o fluxo exige
Dados oficiais, session curta
Nome e situação saem do comprovante da Receita. A session vive cerca de 15 minutos. O titular consulta o próprio CPF.
Perguntas
O titular precisa criar conta?
Não. Só o operador entra no painel. O titular usa o link do App, sem login.
De onde vêm os dados?
Da consulta pública de CPF na Receita Federal. O titular resolve o hCaptcha no domínio do Vero; o backend encaminha a consulta e lê o comprovante.
Como funcionam os créditos?
O cadastro cria a Conta com 10 créditos. Cada consulta bem-sucedida consome 1. Sem crédito, novas consultas ficam bloqueadas até a recarga.
Por quanto tempo vale a session?
Cerca de 15 minutos. Depois disso, GET /api/session/:id deixa de devolver o resultado.
Posso consultar o CPF de outra pessoa?
Não. O titular deve ser quem resolve o captcha e consulta o próprio CPF.