...
Um desenvolvedor integrando a API de verificação de identidade

API de verificação de identidade: sessões KYC em uma chamada REST

Crie uma sessão de verificação com um único POST, envie o cliente ao nosso widget do Web SDK e leia o resultado na mesma sessão. As checagens de documento, a comparação facial e o liveness rodam dentro dela, e cada checagem volta nomeada, com o seu próprio resultado.

Ver a documentação da APIDocs da API
  • REST API e Web SDK REST + SDK
  • JWT e tokens de acesso permanentes JWT · Tokens
  • Checagens nomeadas na resposta Checagens nomeadas
  • Referência pública de erros Referência de erros

12.000 checagens gratuitas ao se conectar pela primeira vez

Toda empresa que se conecta à NeuroVision pela primeira vez recebe 12.000 checagens gratuitas por 12 meses. Disponível a partir de 1 de dezembro de 2026.

Saiba mais

Testado e certificado de forma independente

Selo de certificação ISO Register GlobalSelo de certificação ASIBSelo de certificação QA Compliance Assessment
  • ISO/IEC 27001:2022
  • GDPR
  • iBeta ready
Cobertura global

16.000+ tipos de documentos
de 195+ países e territórios

Os clientes se verificam com o documento que realmente carregam — em 90+ idiomas, incluindo campos manuscritos e MRZ.

16.000+

tipos de documentos


Passaporte Identidade Carteira de motorista Autorização de residência Visto Autorização de trabalho Título de eleitor Identificação fiscal eID Passaporte biométrico Identidade militar Cartão de saúde Identidade nacional Documento de viagem Documento de refugiado Cartão de previdência social
195+

países e territórios


Cazaquistão EAU Alemanha Reino Unido Singapura Índia Brasil Nigéria Filipinas Vietnã Turquia México Uzbequistão Egito Indonésia França Espanha Itália Polônia Quênia Arábia Saudita Japão Coreia do Sul Austrália Estados Unidos Canadá Tailândia Malásia África do Sul
Início rápido

Sua primeira verificação em cinco etapas

  1. 01Obtenha um tokenPOST /user/login retorna um JWT temporário para a sua conta.
  2. 02Crie uma sessãoPOST /kyc/session/create com o cenário que você configurou.
  3. 03Abra o widgetEnvie o usuário ao widget do Web SDK por link ou QR code.
  4. 04Leia o resultadoConsulte o status da sessão ou receba o callback que você definiu.
  5. 05Entre em produçãoTeste o fluxo no sandbox e depois conecte usuários reais.
Tudo está documentado aquiCada etapa corresponde a um método da referência pública da API, com o mesmo nome.
Como funciona
Endpoints

O que a API de verificação de identidade cobre

Cinco grupos de métodos e um widget que os usa.

Os nomes abaixo são os da nossa referência pública, para que você encontre cada método sem adivinhar como o chamamos em uma landing page.

Sessões KYC

Crie uma sessão, consulte o status, liste sessões, filtre-as e baixe o arquivo de logs.

8 métodos

Tokens de acesso

Crie um token permanente, liste os tokens de um usuário, atualize um ou exclua.

4 métodos

Usuários e saldo

Autorize um usuário e obtenha um JWT temporário, leia o saldo do grupo ou atualize-o.

3 métodos

Pessoas

Crie listas de pessoas e registros de pessoas, atualize, exclua e adicione imagens a um rosto armazenado.

8 métodos

Fontes de dados

Crie fontes e grupos de fontes, liste, atualize e exclua.

8 métodos

Web SDK

Instale o widget, passe parâmetros e trabalhe com a chave do cliente que o vincula a uma sessão.

4 páginas
Desenvolvedores

Chame a API em uma requisição

Uma sessão é criada com um POST. O widget assume a partir daí, e o seu backend lê o resultado quando ele fica pronto.

terminalREST API
curl -X POST $NV_API_URL/kyc/session/create \  -H "Content-Type: application/json" \  -H "Authorization: Bearer $JWT" \  -d '{"token":"$JWT","schemaId":"schema-001"}'Apenas exemplo — corpo completo da requisição na documentação.
erros{ "status": …, "message": "…", "details": … }
Confiança e dados

Onde seus dados ficam e permanecem

Rode as checagens na nossa nuvem ou dentro do seu próprio perímetro.

ISO/IEC 27001:2022Sistema de segurança certificado
  • JWT em cada chamada
  • Tokens de acesso permanentes
  • Implantação on-premises
  • Retenção de imagens: você define
Web SDK

O widget do Web SDK que seus usuários veem de fato

O widget roda sobre a sua página e conduz o cliente pela foto do documento, pela selfie e pelas checagens, depois envia o resultado para você.

Funciona no navegador que eles têm

Todos os navegadores modernos no desktop e no celular, incluindo iOS e Android. A única permissão que o widget pede é o acesso à câmera.

Sem baixar nenhum app

Vinculado a uma sessão por chave

A chave do cliente conecta o widget da sua página à sessão que você criou, e é assim que o resultado volta para você.

Comece por link ou QR code

O usuário abre uma tela inicial e escaneia um QR code ou segue um link, e pode trocar o idioma da interface antes de começar.

Você decide quais etapas rodam

As etapas de documento, selfie com documento, liveness e antifraude são ativadas e desativadas no seu cenário, não no código do widget.

O widget do Web SDK: tela inicial, captura do documento e resultado

O widget está documentado em quatro páginas, da instalação à chave do cliente.

Resultados

Lendo o resultado de uma sessão

Duas formas de obtê-lo e um só formato para lê-lo.

Cada checagem volta como um item nomeado, com o seu próprio status e um valor de confiança, para que as suas regras leiam as partes que importam em vez de um único veredito.

Consulte o status da sessão

Peça a sessão pelo id ou pela chave do cliente e leia o estado atual e os resultados.

Pull

Receba o callback

Um callback entrega o resultado final quando a sessão termina, então você não precisa consultá-la.

Push

Checagens nomeadas com confiança

As checagens de documento e rosto voltam como itens nomeados, cada um com um status e um valor de confiança.

JSON

Todo erro tem um código

Uma checagem reprovada retorna um código e uma descrição da nossa referência pública, para que o suporte possa dizer ao cliente o que fazer.

40 códigos
Acesso

Tokens, acessos e erros

Tokens temporários e permanentes

Um login retorna um JWT temporário com a validade que você escolher. Para integração servidor a servidor, você cria tokens de acesso permanentes e os revoga quando não precisar mais deles.

Erros que você pode tratar

Quarenta códigos documentados, cada um com uma descrição, que cobrem qualidade de imagem, problemas de documento, sinais de fraude e checagens de rosto, para que uma rejeição possa ser explicada ao cliente.

Veja a referência de erros

Logs de sessão que você pode baixar

Uma sessão pode ser exportada como arquivo de logs pela API, de modo que uma auditoria ou uma disputa seja respondida com a sua própria cópia e não com uma captura de tela.

Veja a documentação da API

Todo método aqui está na referência

Cada endpoint, campo e código de erro desta página aparece na nossa documentação pública com o mesmo nome, para que você vá do exemplo direto à página de referência que o descreve.

Por que nós

Por que as equipes escolhem a NeuroVision Global Systems

Precisão que você pode auditar

Comparação facial testada de forma independente, com um índice de confiança em cada resultado.

Precisão que você pode auditar

O algoritmo facial foi testado pelo NIST e ficou em TOP-24, NIST FRVT 1:1 Verification. Cada resultado de documento e de rosto vem com um índice de confiança.

TOP-24NIST FRVT 1:1 Verification
0,1 spor comparação facial

No ar em menos de uma hora

REST API, Web SDK, SDK para iOS e Android, WebView; primeiro o sandbox.

No ar em menos de uma hora

Menos de uma hora para a REST API ou o Web SDK com chaves de sandbox; produção em um dia útil. O teste de 14 dias no seu tráfego real vem com suporte completo.

< 1 hpara integrar com chaves de sandbox
14 diasde teste com acesso total à API

Cobertura global

195+ países e territórios, mais de 16.000 tipos de documentos, mais de 90 idiomas.

Cobertura global

Os clientes se verificam com o documento que realmente carregam: 16.000+ tipos de documentos de 195+ países e territórios, incluindo campos manuscritos e MRZ.

16.000+tipos de documentos
90+idiomas

Antifraude construído sobre ataques reais

40+ checagens de documento, busca facial 1:N, triagem de lista de bloqueio e mais 30 camadas.

Antifraude construído sobre ataques reais

Liveness resistente a deepfake, deduplicação 1:N e triagem de lista de bloqueio além das checagens de documento: uma pessoa, uma conta.

40+checagens de documento
0,01%de risco residual de fraude

Privacidade desde a concepção

ISO/IEC 27001:2022, pronto para o GDPR; on-premise, nuvem ou híbrido.

Privacidade desde a concepção

Rode na nossa nuvem, nos seus data centers ou de forma híbrida — templates e dados pessoais nunca saem da sua jurisdição.

27001:2022certificado ISO/IEC
GDPRpronto

Somente motores próprios

OCR, rosto, liveness e antifraude são nossos.

Somente motores próprios

Um único fornecedor cobre KYC, KYB, AML e KYT em uma só API — um SLA, sem licenças de terceiros.

20 anosde engenharia de visão computacional
1 SLApara cada checagem
Preços

Preços da API de verificação de identidade

A API não é um produto separado com licença própria. Você paga por checagem concluída.

Pacote de documentos

A partir de US$ 0,25 por checagem

Reconhecimento de documentos e checagens antifraude. Adicione selfie e liveness com o pacote Basic. Monte o seu próprio conjunto na calculadora.

Calcular seu preço

Pagamento por uso

Sem assinatura e sem taxa de licença pela API: você paga por checagem concluída.

Ver preços

Teste gratuito

Um teste de 14 dias no seu tráfego real, com acesso completo à API e ao sandbox desde o primeiro dia.

Volume e corporativo

Condições personalizadas para altos volumes, implantação on-premises e SLA.

Produtos

Nossas soluções de identidade com IA

Tudo o que você precisa para verificar, autenticar e proteger os seus clientes — em uma única plataforma poderosa.

Uma pessoa real com um documento real — verificada em segundos. Captura do documento, comparação facial, liveness, antifraude e AML.

Saiba mais

Faça a triagem de cada cliente contra sanções, PEP e listas de observação, inclusive listas de autoexclusão — dentro do mesmo fluxo de verificação.

Saiba mais

Verifique a empresa por trás da conta: dados do registro de empresas e beneficiários finais (UBO), conferidos antes do onboarding.

Saiba mais

Monitoramento de transações em tempo real: transferências suspeitas são sinalizadas para análise, na mesma API do KYC e do AML.

Saiba mais

Uma pessoa real e presente, resistente a deepfake. Autentique clientes recorrentes pelo rosto, em vez de senhas.

Saiba mais

Pagamentos confirmados com o rosto ou com um documento de identidade — a identidade que o seu cliente já verificou, no checkout.

Saiba mais
Contato

Obtenha suas chaves API

Conte o que você está construindo e de quais checagens precisa. Enviaremos as credenciais do sandbox e colocaremos você em contato com o engenheiro que ajudará você a entrar em produção.

Prefere falar direto?
Escreva para:
hello@nv.global
Nome *
Informe um nome válido
Empresa
E-mail *
Informe um e-mail válido
Telefone
Informe um telefone válido
Sua mensagem (opcional)
Aceite a política de privacidade
FAQ

FAQ da API de verificação

O que os desenvolvedores perguntam antes de começar. A referência completa está na documentação, e nós indicamos o link.

Não encontrou sua resposta?

Um login retorna um JWT temporário, e você também pode criar tokens de acesso permanentes para chamadas servidor a servidor. Ambos estão descritos na referência da API.

Sim, para o resultado final de uma sessão. Você também pode consultar o status da sessão pelo id ou pela chave do cliente.

As verificações de idade rodam na mesma sessão; veja a API de verificação de idade.

Não publicamos limites de requisições. Diga o volume que você planeja e confirmaremos para o seu caso.

Uma checagem nomeada com o seu status, mais um código de erro e uma descrição da nossa referência pública de erros, o suficiente para a sua equipe de suporte dizer ao cliente o que fazer em seguida.

A triagem AML volta do mesmo modo, como uma checagem nomeada; veja a API AML.

Sim. Você testa a integração no sandbox antes de conectar dados reais, e a nossa equipe de integração ajuda você na primeira sessão.

Não há licença de API separada. Você paga por checagem concluída, a partir de US$ 0,25 pelo reconhecimento de documentos com antifraude. Monte o seu próprio conjunto na página de preços.

Plataforma completa de reconhecimento facial
para verificação KYC instantânea

Acelere o onboarding, evite fraudes e garanta a conformidade KYC/AML