Primeiros passos
Integração / SDKs
Verificação de usuários
Verificação de empresas
Monitoramento de transações
Registro de alteraçõespartialMatchAction e noMatchAction nas regras do seu fluxo de verificação (workflow).
Correspondência 1×1
Este método consiste em comparar um dado de entrada (normalmente um documento nacional de identidade ou identificador semelhante) com o nosso banco de dados. Se uma correspondência direta for encontrada, confirmamos a identidade. No entanto, se a primeira tentativa falhar, podemos consultar outras fontes de dados confiáveis em uma sequência em cascata. Isso significa que continuamos a validação por meio de provedores sucessivos até obter uma correspondência ou esgotar todas as opções. É importante destacar que uma correspondência parcial não interrompe o processo: só paramos quando encontramos uma correspondência total e conclusiva ou determinamos que não existe correspondência. A lógica de correspondência 1x1 exige que os dados pessoais do usuário sejam comparados com uma fonte para que a identidade do usuário receba uma Correspondência total .*
*As fontes aplicáveis para o país são consultadas até que se obtenha uma Correspondência total da identidade. Se não for encontrada uma Correspondência total, o sistema consulta essas fontes novamente em busca de uma Correspondência parcial da identidade do usuário.
A tabela 1×1 acima e a tabela 2×2 abaixo descrevem o modelo geral, e não uma garantia válida para todos os serviços. Os campos decisivos variam conforme o serviço e conforme as entradas opcionais que você envia: um registro só pode comparar os campos que possui e os campos que você fornece, e o resultado de um serviço é determinado pelos campos que ele efetivamente compara. Nem todo serviço compara o número de identificação, e alguns só o comparam quando você o envia. Por exemplo, a Espanha - verificação de DNI/NIE (
esp_dni) exige nome, data de nascimento e endereço, e aceita national_id como entrada opcional. Ela sempre compara nome, data de nascimento e endereço, e também compara o número de identificação quando você envia national_id.Um campo obrigatório não é necessariamente decisivo, e um campo opcional pode ser. Um campo obrigatório precisa ser enviado para que a requisição seja aceita, e um campo listado em source_data é um dado que o registro retornou. Nenhum dos dois indica quais campos decidiram o resultado. Os exemplos de resposta na página de cada serviço ilustram uma resposta possível, portanto as chaves do objeto validation neles não são uma lista completa dos campos que o serviço compara. A página de referência da API de cada serviço, listada em Países e serviços suportados, indica as entradas obrigatórias e opcionais em Entradas.Correspondência 2×2
Este método exige a correspondência de dois dados de entrada (por exemplo, nome + data de nascimento, ou ID nacional + número de telefone) com dois campos correspondentes em nosso banco de dados. Assim como no 1x1, seguimos uma abordagem em cascata, consultando várias fontes de dados em sequência. Avançamos por cada etapa até encontrar uma correspondência completa nos dois campos de dados. Correspondências parciais ou de um único campo não são suficientes: o processo de validação continua até que se obtenha uma correspondência definitiva nos 2 campos ou até que todas as fontes tenham sido verificadas. A lógica de correspondência 2x2 exige comparar os dados pessoais de um usuário com duas fontes para obter uma Correspondência total da sua identidade.*
*As fontes aplicáveis do país são consultadas até que se obtenha uma Correspondência total da identidade. Se não for encontrada uma Correspondência total, o sistema consulta essas fontes repetidamente em busca de uma Correspondência parcial da identidade do usuário.
Correspondência por categoria e atributo de dados
A seguir estão os cenários que resultam em Correspondência total para as categorias de dados Nome, Data de nascimento e ID. Uma Correspondência parcial só é possível na categoria Nome.Correspondência na categoria Nome
Considera-se uma Correspondência total na categoria Nome quando qualquer um dos seguintes cenários de correspondência de atributos de dados é atendido:- Concatenação do nome completo com Correspondência total (Nome + Sobrenome combinados com limiar de similaridade de 85%)
- Nome com Correspondência total + Sobrenome com Correspondência total
- Nome com Correspondência total + Sobrenome materno com Correspondência total
- Nome com Correspondência total + Sobrenome paterno com Correspondência total
- Nome com Correspondência total
- Sobrenome com Correspondência total
- Sobrenome paterno com Correspondência total
- Sobrenome materno com Correspondência total
- Sobrenome materno com Correspondência total + Sobrenome paterno com Correspondência total
Correspondência na categoria Data de nascimento
Considera-se uma Correspondência total na categoria Data de nascimento somente quando o seguinte cenário de correspondência de atributos de dados é atendido:- Ano de nascimento com Correspondência total + Mês de nascimento com Correspondência total + Dia de nascimento com Correspondência total
Correspondência na categoria ID
Considera-se uma Correspondência total na categoria ID somente quando o seguinte cenário de correspondência de atributos de dados é atendido:- Número de identificação com Correspondência total
Correspondência aproximada para atributos de dados
Estes são os critérios de correspondência aproximada (fuzzy matching) para diferentes atributos de dados em relação às fontes de cada país.- Atributos de dados de nome Para que um atributo de dados da categoria Nome gere uma Correspondência total, ele deve atingir pelo menos 70% de similaridade de caracteres de Levenshtein em comparação com os registros das fontes de dados. Para a concatenação do nome completo (Nome + Sobrenome combinados), usa-se um limiar mais alto, de 85% de similaridade. Por exemplo, se o atributo Nome informado for ‘Christophel’ e o nome real for ‘Christopher’, a lógica de correspondência aproximada retorna uma Correspondência total. Esse sistema se aplica aos atributos de dados Nome, Sobrenome, Nome paterno e Nome materno.
- Atributos de dados de data de nascimento e de documento de identidade Não aplicamos nenhum tipo de correspondência aproximada a atributos de dados das categorias Data de nascimento ou Documento de identidade. Esses campos exigem correspondência exata.
Exemplos
Abaixo estão exemplos de atributos de dados informados que atendem aos critérios da lógica de correspondência aproximada e geram uma Correspondência total.Veja também
- Visão geral da Validação de banco de dados: como a API funciona de ponta a ponta, registros compatíveis e preços.
- Códigos de resultado: lista completa dos códigos de resposta dos provedores (falecido, menor de idade, documento não encontrado, divergência biométrica).
- Avisos: o que informamos quando um serviço não pode ser executado por falta de dados de entrada.
- Países e serviços compatíveis: todos os registros ativos, campos obrigatórios e preço por chamada.
- Relatórios: exportações mensais de faturamento por serviço.