API de verificação de identidade · Acesso antecipado
Documento, selfie e prova de vida em um único link web. Cada resultado volta como aprovado, reprovado ou em revisão, com códigos de motivo que suas regras e sua auditoria conseguem ler.
Exemplo de verificação: a pessoa faz três movimentos de prova de vida, o documento é lido e conferido pelos dígitos verificadores e a API devolve a decisão aprovada com as verificações e os motivos.
Construído sobre regras que você pode conferir
O problema
A maioria das ferramentas de verificação devolve uma nota sem motivo, um preço que só aparece depois de uma reunião de vendas e uma leitura do documento que ninguém confere.
Fraude no Brasil
10,9 mi
tentativas de fraude no Brasil de janeiro a setembro de 2025, uma a cada 2,2 segundos
Fonte: Serasa Experian, Indicador de Tentativas de Fraude, dez. 2025
33%
dessas tentativas foram barradas pela checagem de documento e biometria
Fonte: Serasa Experian, Indicador de Tentativas de Fraude, dez. 2025
51%
dos adultos brasileiros foram vítimas de algum tipo de fraude em 2024
Fonte: Serasa Experian, Relatório de Identidade e Fraude 2025
O custo de verificar
US$ 2,45 a US$ 7,45
custo real de cada verificação para quem faz 20 por mês, contando o mínimo mensal
Fonte: Cálculo próprio sobre planos self-serve publicados de três fornecedores, out. 2026
~1,5x
a mais quando se cobra por tentativa e não por verificação concluída, com 35% de abandono
"0,71" não diz ao analista o que fazer, nem diz à auditoria por que a conta foi aprovada.
Modelos de visão completam um dígito ilegível com um número plausível. Se ninguém recalcula, um CPF errado fica igual a um certo.
Os líderes locais só passam preço depois da demo. Os globais cobram em dólar com mínimo mensal. Quem verifica pouco paga mais caro por verificação.
Como funciona
Você cria uma sessão, envia o link pelo seu canal e lê uma decisão que dá para usar. Para quem se verifica, leva cerca de dois minutos.
# Requisição
POST /v1/sessions
Authorization: Bearer idv_test_8f2a.••••••••
X-Request-Id: signup-48213
{ "external_reference": "customer-48213",
"expected": { "name": "Maria A. Souza", "cpf": "111.444.777-35" } }
# Resposta 201
{ "id": "7f3c1e9a-2b4d-4c8e-9a51-0d6b3f2e8c17",
"status": "pending",
"capture_url": "https://ipsis.tolky.to/c/#k3Xq…",
"expires_at": "2026-10-30T14:02:11Z" }AAcme
Olá! A Acme Crédito pediu para verificar sua identidade
Concordo com o uso dos meus dados biométricos para esta verificação
Continue no celular: aponte a câmera para o QR code
Continuar neste computadorEsses dados estão corretos?
{ "status": "awaiting_review",
"checks": [
{ "id": "cpf_valid", "status": "pass" },
{ "id": "cpf_matches_expected", "status": "pass" },
{ "id": "name_matches_expected", "status": "warn",
"reason": "name_mismatch_expected" },
{ "id": "liveness_challenges", "status": "pass" },
{ "id": "face_match", "status": "pass" }
],
"decision": { "status": "awaiting_review",
"reasons": ["manual_review_mode", "name_mismatch_expected"] } }A pessoa só vê o resultado, nunca os motivos. Os motivos são para você.
Verificações
Cada uma devolve aprovado, alerta ou reprovado, com um código de motivo estável. Uma reprovação reprova. Um alerta manda para revisão. Verificação que faltou nunca conta como aprovada.
Nada do que a leitura encontra é aceito antes de uma regra confirmar.
document_typeAs imagens correspondem ao documento escolhido.
required_fieldsNome e número do documento foram lidos.
cpf_validO CPF é recalculado pelos dígitos verificadores. Um dígito lido errado reprova aqui.
cpf_matches_expectedO CPF do documento é o mesmo que você informou.
name_matches_expectedComparação palavra por palavra, ignorando acentos e "de", "da". Gera alerta, nunca reprova.
birth_dateA data é lida, existe no calendário e o titular tem 18 anos ou mais.
birth_matches_expectedA mesma data que você já tem.
not_expiredValidade conferida na CNH, CIN e passaporte. CNH vencida há até 30 dias vai para revisão.
cnh_number_validO registro de 11 dígitos é recalculado.
mrz_validAs linhas de leitura mecânica do passaporte e da CIN são conferidas pelos dígitos e contra os dados impressos.
customer_confirmedSe a pessoa marcar que os dados lidos estão errados, a sessão vai para revisão.
Movimentos sorteados na hora e confirmados no servidor.
liveness_challengesTrês movimentos sorteados (virar à esquerda, à direita, sorrir, piscar), sempre com uma virada de cabeça, confirmados no servidor.
capture_integrityOs quadros chegam por movimento, dentro de uma janela de tempo do servidor, com continuidade entre eles.
face_matchA selfie é comparada com a foto do documento, pelos limiares que você define. Na faixa do meio: revisão.
Na dúvida, uma pessoa decide.
engine_unavailableSe o motor facial cair ou estiver ocupado, a sessão vai para revisão. Nunca é aprovada por falta de capacidade.
decision_mode: manualNada é aprovado sozinho até você ligar o modo automático. Reprovações claras continuam automáticas.
Desenvolvedores
Crie a sessão, envie o link, leia o resultado. Códigos de motivo e de erro fazem parte do contrato: mudar um deles é quebra de versão.
curl https://ipsis.tolky.to/v1/sessions \
-H "Authorization: Bearer idv_test_8f2a.••••••••" \
-H "X-Request-Id: signup-48213" \
-H "Content-Type: application/json" \
-d '{
"external_reference": "customer-48213",
"expected": {
"name": "Maria A. Souza",
"cpf": "111.444.777-35",
"birth_date": "1991-03-14"
},
"allowed_documents": ["cnh", "cin", "rg", "passport"],
"redirect_url": "https://acme.example/onboarding/done",
"locale": "pt-BR"
}'{
"id": "7f3c1e9a-2b4d-4c8e-9a51-0d6b3f2e8c17",
"status": "pending",
"capture_url": "https://ipsis.tolky.to/c/#k3Xq…",
"expires_at": "2026-10-30T14:02:11Z"
}curl https://ipsis.tolky.to/v1/sessions/7f3c1e9a-2b4d-4c8e-9a51-0d6b3f2e8c17 \
-H "Authorization: Bearer idv_test_8f2a.••••••••"{
"id": "7f3c1e9a-2b4d-4c8e-9a51-0d6b3f2e8c17",
"status": "awaiting_review",
"external_reference": "customer-48213",
"document_type": "cnh",
"checks": [
{ "id": "cpf_valid", "status": "pass", "reason": "ok" },
{ "id": "cpf_matches_expected", "status": "pass", "reason": "ok" },
{ "id": "name_matches_expected", "status": "warn", "reason": "name_mismatch_expected" },
{ "id": "liveness_challenges", "status": "pass", "reason": "ok" },
{ "id": "face_match", "status": "pass", "reason": "ok" }
],
"decision": {
"status": "awaiting_review",
"by": "system",
"reasons": ["manual_review_mode", "name_mismatch_expected"]
},
"attempt": 1
}curl https://ipsis.tolky.to/v1/match \
-H "Authorization: Bearer idv_test_8f2a.••••••••" \
-F selfie=@selfie.jpg \
-F reference=@reference.jpg// illustrative
{
"decision": "match", // match | no_match | inconclusive
"request_id": "9b2e41d0-…"
}Exemplo ilustrativo, recortado para leitura.
O prefixo diferencia. Chave de teste não funciona em produção. Só servidor a servidor.
Envie X-Request-Id. Repetir com o mesmo id nunca cobra duas vezes.
quota_exceeded, engine_busy com Retry-After, session_expired e outros. Programe em cima do code, não da mensagem.
POST /review para aprovar ou reprovar uma sessão em revisão. DELETE /data para apagar imagens e dados pessoais.
GET /v1/usage devolve o total cobrável, sua cota e o saldo do mês.
Aviso quando a sessão termina, com assinatura HMAC. Até lá, consulte GET /v1/sessions/:id.
Segurança e privacidade
Biometria é dado pessoal sensível na LGPD (art. 11) e categoria especial no GDPR (art. 9). Aqui está o que fazemos com ela e o que ainda não fazemos.
Você é o controlador. Nós tratamos os dados em seu nome.
Cada imagem é cifrada pela aplicação com AES-256-GCM antes de chegar ao armazenamento. No bucket só existe texto cifrado.
O armazenamento é privado. Imagens só saem por uma rota autenticada da API, nunca por URL pública ou pré-assinada.
A representação numérica do rosto só existe na memória durante a comparação. Guardamos notas, nunca templates.
Uma chamada apaga as imagens e os dados pessoais da sessão. É idempotente e deixa um evento de auditoria.
A retenção é configurável por cliente, a partir de zero dia (imagens apagadas assim que a sessão é decidida). Um processo diário garante o prazo.
Toda consulta é restrita à sua conta. Recurso de outro cliente responde "não encontrado".
Antes de qualquer captura, a pessoa aceita um consentimento específico para dado biométrico, com o nome da sua empresa como controladora. Registrado com IP e navegador.
O token do link fica depois do # da URL, parte que o navegador nunca envia ao servidor.
A leitura do documento usa um provedor de visão externo, nomeado no seu contrato como suboperador, com os países envolvidos.
Ainda não temos certificações. Esta é a lista do que falta e de onde cada item está. Atualizamos quando algo muda.
Para quem
Empresas que recebem desconhecidos em escala e precisam explicar cada decisão depois.
Crédito, pagamentos e contas digitais.
Usos comuns
Entrega, mobilidade, aluguel e serviços que cadastram vendedores e prestadores aos milhares.
Usos comuns
Operadores autorizados no Brasil.
Usos comuns
Apoia o cumprimento da regra; não substitui a sua avaliação. Não consultamos bases oficiais.
Fale com a genteTambém serve para
Preços
Preço público, sem taxa de implantação e com um plano sem mínimo mensal. A cobrança acontece uma vez, quando a sessão chega ao primeiro resultado.
Acesso antecipado: os preços estão publicados para planejamento e podem mudar até o lançamento.
Teste com casos reais
R$ 0
25 verificações por mês
Sem cartão
Inclui:
Pague pelo uso, sem mínimo mensal
R$ 2,90
por verificação
Créditos pré-pagos a partir de R$ 100
Tudo do Grátis, mais:
Recomendado
Para onboarding recorrente
R$ 1.100/mês
R$ 11.000/ano
500 verificações incluídas por mês
6.000 verificações incluídas por ano
Depois, R$ 2,20 por verificação
Tudo do Starter, mais:
Volume alto e setores regulados
R$ 4.750/mês
R$ 47.500/ano
2.500 verificações incluídas por mês
30.000 verificações incluídas por ano
Depois, R$ 1,90 por verificação
Tudo do Growth, mais:
Contrato, termos e volume sob medida. A partir de 10.000 verificações por mês.
Sob consulta
Fale com a genteValores em reais. Empresas com CNPJ pagam em BRL; as demais pagam em USD, qualquer que seja o idioma do site.Pague 10 mínimos mensais à vista e leve 12 meses. As verificações incluídas viram um saldo do ano. O excedente segue o preço do plano.
Uma sessão que chegou a um resultado: aprovada, reprovada ou em revisão.
Defina um teto mensal. Acima dele, sessões novas são recusadas com quota_exceeded, sem cobrança.
X-Request-IdIncluído em todos os planos
| Recurso | Grátis | Starter | Growth | Scale | Enterprise |
|---|---|---|---|---|---|
| Preço por verificação | R$ 0 | R$ 2,90 | R$ 2,20 | R$ 1,90 | Sob consulta |
| Mínimo mensal | Não incluído | Não incluído | R$ 1.100 | R$ 4.750 | Contrato |
| Verificações incluídas por mês | 25 | 25 | 500 | 2.500 | Contrato |
| Excedente | Não incluído | Por uso | R$ 2,20 | R$ 1,90 | Contrato |
| Comparação facial 1:1 | 100 por mês | R$ 0,25 | R$ 0,25 | R$ 0,25 | Contrato |
| Plano anual (2 meses grátis) | Não incluído | Não incluído | Incluído | Incluído | Contrato |
| Página de captura hospedada (pt-BR, en, es) | Incluído | Incluído | Incluído | Incluído | Incluído |
| RG, CIN, CNH e passaporte com conferência de dígitos | Incluído | Incluído | Incluído | Incluído | Incluído |
| Prova de vida com 3 movimentos sorteados | Incluído | Incluído | Incluído | Incluído | Incluído |
| Selfie x documento (1:1) | Incluído | Incluído | Incluído | Incluído | Incluído |
| Comparação com dados que você já tem | Incluído | Incluído | Incluído | Incluído | Incluído |
| Revisão humana por padrão, aprovação automática opcional | Incluído | Incluído | Incluído | Incluído | Incluído |
| Trilha de auditoria | Incluído | Incluído | Incluído | Incluído | Incluído |
| Imagens cifradas, sem guardar o vetor facial, exclusão por API | Incluído | Incluído | Incluído | Incluído | Incluído |
| Chaves de teste e produção separadas, requisição idempotente | Incluído | Incluído | Incluído | Incluído | Incluído |
| Retenção máxima das imagens | 7 dias | 30 dias | 90 dias | 365 dias | Até 5 anos |
| Limiares ajustados ao seu caso | Não incluído | Não incluído | Incluído | Incluído | Incluído |
| Webhook de resultado | Não incluído | Em breve | Em breve | Em breve | Em breve |
| Painel | Em breve | Em breve | Em breve | Em breve | Em breve |
| Leitura do documento com dados no Brasil | Não incluído | Não incluído | Não incluído | Em breve | Em breve |
| Consulta à base oficial (Brasil, adicional) | Não incluído | Não incluído | Em breve | Em breve | Em breve |
| Prova de vida certificada por fornecedor (adicional) | Não incluído | Não incluído | Em breve | Em breve | Em breve |
| Suporte | Documentação e e-mail | E-mail, 2 dias úteis | E-mail prioritário, 1 dia útil | Contato nomeado, 4 horas úteis | Contato nomeado, em contrato |
| SLA de disponibilidade | Não incluído | Não incluído | Não incluído | Não incluído | Em breve |
Deslize para o lado para ver todos os planos.
Condições do plano grátis
No acesso antecipado, configuramos sua conta junto com você: limiares, documentos e retenção.
Dúvidas
Não achou a sua dúvida?
Conte como é o seu fluxo e respondemos com o que a API faz hoje.
Fale com a genteUma sessão que chega ao primeiro resultado: aprovada, reprovada ou em revisão. Link não aberto, nova tentativa na mesma sessão e requisição repetida com o mesmo X-Request-Id não são cobrados.
Cerca de dois minutos para quem se verifica, do consentimento ao resultado. A leitura do documento pode levar até 30 segundos. Vamos publicar tempos de resposta quando os medirmos em produção.
RG, CIN e CNH física, frente e verso, e a página de dados do passaporte. Você escolhe quais cada sessão aceita.
Não. O link abre no navegador do celular, em português, inglês ou espanhol. No computador, um QR code leva ao celular, ou ela continua pela webcam.
Não guardamos template facial. As imagens ficam cifradas pelo prazo de retenção configurado para a sua conta, e você pode apagar os dados de qualquer sessão pela API.
Conformidade depende do uso, por isso não fazemos essa promessa. Entregamos os mecanismos: consentimento específico para dado biométrico, exclusão sob demanda e retenção configurável. Você é o controlador; nós tratamos os dados em seu nome, com acordo de tratamento.
A leitura do documento usa um provedor de visão externo, nomeado no seu contrato como suboperador, com os países envolvidos. A opção de leitura dentro do Brasil está no nosso roteiro.
Ainda não publicamos taxa, porque só faremos isso com método e amostra declarados. Até lá, você define os limiares de aprovação e a revisão humana é o padrão.
Três movimentos sorteados e cronometrados pelo servidor são feitos para rejeitar foto impressa, tela e vídeo gravado. Câmera virtual transmitindo deepfake ao vivo não é detectável com segurança pelo navegador; para fluxos de risco alto, mantenha a revisão humana.
Não. Recalculamos os dígitos verificadores do CPF e comparamos com o CPF que você já tem. Não confirmamos na Receita de quem ele é.
Ainda não. Hoje o resultado é consultado na API; webhooks assinados estão no roteiro. Não há SDK nativo: a captura é uma página web, então não há nada para embutir.
Ainda não. A seção de segurança lista o que já existe (cifragem, isolamento, trilha de auditoria) e um roteiro com o status de cada item que falta.
Estamos abrindo acesso para um grupo pequeno de empresas. Conte como é o seu fluxo e configuramos suas chaves de teste junto com você.