Verificação global de identidade

A consulta serve para verificar se os dados básicos de uma pessoa são consistentes. Em outras palavras, ela avalia se o nome, a data de nascimento, o endereço, o número de telefone e o número do documento realmente pertencem a essa pessoa. Por meio dessa verificação, a consulta valida o conjunto de dados fornecido e classifica a confiabilidade das informações como confiável, suficiente ou não confiável.

Para indicar a confiabilidade de um indivíduo, existem várias combinações possíveis de dados para avaliar a pontuação de confiabilidade, que pode variar entre 10, 20 ou 30.

Seção: globalIdentityVerifications

Países suportados: Argentina, Austrália*, Áustria, Bélgica, Brasil, Canadá*, China, Chile, Colômbia, Tchéquia, Dinamarca, Finlândia, França, Alemanha, Gana, Gibraltar, Grécia, Hong Kong*, Índia*, Indonésia, Irlanda, Itália, Japão, Quênia, Luxemburgo, Malásia, México, Países Baixos, Nova Zelândia, Nigéria, Noruega, Filipinas, Polônia, Portugal, Singapura, Eslováquia, África do Sul, Espanha, Suécia, Suíça, Turquia, Reino Unido, Estados Unidos e Vietnã.

Observação: Austrália, Canadá, Hong Kong e Índia exigem autorização para consulta antes de poder acessar os dados (processo de onboarding).

Atributo

Tipo

Descrição

Obrigatório

name

string

Nome completo do indivíduo.

Sim

birthDate

string

Data de nascimento do indivíduo.

Sim

address

string

Endereço do indivíduo.

Sim

phoneNumber

string

Número de telefone do indivíduo.

Sim

nationalId

string

Um número de identificação ou documento emitido pelo governo.

Sim/Não (Depende do país)

zipCode

string

CEP do endereço do indivíduo.

Sim

countryCode

string

Código do país do indivíduo.

Sim

dateFormat

string

Formato da data de nascimento.

Não

body: JSON.stringify({
  workflowId: "6644843a90k8762k25929376",
  parameters: {
    name: "Mariana Oliveira",
    birthDate: "23/04/1995",
    phoneNumber: "+5551998765432",
    address: "Rua das Flores, 123",
    zipCode: "12345678",
    nationalId: "9876543210",
    countryCode: "BR",
    dateFormat: "dd/MM/yyyy",
  },
});

Observação: Alguns campos retornados por esta API são opcionais e sua presença não pode ser garantida.

Atributo

Tipo

Descrição

dados

objeto

Objeto contendo os dados principais.

data.detailList

string

Detalhes relacionados à consulta.

data.adaptation

string

Indicador de adaptação.

data.messages

array

Lista de mensagens que fornecem detalhes sobre o nível de correspondência de cada dado.

data.messages[].value

string

Indica o nível de correspondência dos dados (correspondência completa, sem correspondência, correspondência parcial etc.).

data.messages[].code

string

Código indicando o tipo de dado analisado (FIRSTNAME, COMPLETENAME, PHONENUMBER etc.).

data.detailCode

string

Código detalhado específico do processo ou da solicitação.

data.query

objeto

Informações sobre a consulta realizada.

data.query.options

string

Valor interno que indica o tipo de busca da consulta.

data.reliability

string

Indicador de confiabilidade (10, 20, 30).

data.statusCode

string

Status da transação. Consulte nosso guia de status.

código de status

string

Refere-se apenas ao status desta consulta, não à transação inteira. Consulte nosso guia de status

{
  "data": {
    "detailList": "",
    "adaptation": "0",
    "messages": [
      {
        "value": "Correspondência completa no nome completo",
        "code": "1MT-BR-GVT2-COMPLETENAME"
      },
      {
        "value": "Correspondência completa na inicial do primeiro nome",
        "code": "1MT-BR-GVT2-FIRSTINITIAL"
      },
      {
        "value": "Correspondência completa no primeiro nome/nome próprio",
        "code": "1MT-BR-GVT2-FIRSTNAME"
      },
      {
        "value": "Correspondência completa no sobrenome ",
        "code": "1MT-BR-GVT2-LASTNAME"
      },
      {
        "value": "Correspondência completa no código postal/CEP",
        "code": "1MT-BR-GVT2-POSTALCODE"
      },
      {
        "value": "Correspondência completa no estado/província",
        "code": "1MT-BR-GVT2-PROVINCE"
      },
      {
        "value": "A fonte de dados não contém o elemento Descritores de subpremissa fornecido em Address Lines",
        "code": "4MT-BR-GVT2-SUBPREMISE"
      },
      {
        "value": "A fonte de dados não contém o elemento Número de telefone",
        "code": "4MT-BR-GVT2-PHONENUMBER"
      },
      {
        "value": "Correspondência parcial no elemento Address Lines",
        "code": "3MT-BR-GVT2-ADDRESS"
      },
      {
        "value": "Correspondência completa na data de nascimento",
        "code": "1MT-BR-GVT2-DATEOFBIRTH"
      },
      {
        "value": "Correspondência completa no dia de nascimento",
        "code": "1MT-BR-GVT2-DAYOFBIRTH"
      },
      {
        "value": "Correspondência completa no mês de nascimento",
        "code": "1MT-BR-GVT2-MONTHOFBIRTH"
      },
      {
        "value": "Correspondência completa no ano de nascimento",
        "code": "1MT-BR-GVT2-YEAROFBIRTH"
      },
      {
        "value": "Correspondência completa no sobrenome",
        "code": "1AU-400-LASTNAME"
      },
      {
        "value": "Correspondência completa no primeiro nome/nome próprio",
        "code": "1AU-350-FIRSTNAME"
      },
      {
        "value": "Correspondência completa na inicial do primeiro nome",
        "code": "1AU-375-FIRSTINITIAL"
      },
      {
        "value": "Correspondência completa no nome completo",
        "code": "1AU-425-COMPLETENAME"
      },
      {
        "value": "Correspondência completa no ano de nascimento",
        "code": "1AU-625-YEAROFBIRTH"
      },
      {
        "value": "Correspondência completa no mês de nascimento",
        "code": "1AU-600-MONTHOFBIRTH"
      },
      {
        "value": "Correspondência completa no dia de nascimento",
        "code": "1AU-575-DAYOFBIRTH"
      },
      {
        "value": "Correspondência completa na data de nascimento",
        "code": "1AU-550-DATEOFBIRTH"
      },
      {
        "value": "Correspondência parcial no elemento Address Lines",
        "code": "3AU-200-ADDRESS"
      },
      {
        "value": "Não houve correspondência no logradouro",
        "code": "2AU-075-THOROUGHFARE"
      },
      {
        "value": "Não houve correspondência no número da casa/número da rua",
        "code": "2AU-050-HOUSENUMBER"
      },
      {
        "value": "Não houve correspondência no distrito",
        "code": "2AU-225-DISTRICT"
      },
      {
        "value": "Correspondência completa no estado/província",
        "code": "1AU-325-PROVINCE"
      },
      {
        "value": "Correspondência completa no código postal/CEP",
        "code": "1AU-275-POSTALCODE"
      },
      {
        "value": "Correspondência total para verificação 1+1",
        "code": "1MT-BR-MATCHED-1+1"
      },
      {
        "value": "1AU-275-POSTALCODE;1AU-325-PROVINCE;1AU-350-FIRSTNAME;1AU-375-FIRSTINITIAL;1AU-400-LASTNAME;1AU-425-COMPLETENAME;1AU-550-DATEOFBIRTH;1AU-575-DAYOFBIRTH;1AU-600-MONTHOFBIRTH;1AU-625-YEAROFBIRTH;1MT-BR-GVT2-COMPLETENAME;1MT-BR-GVT2-DATEOFBIRTH;1MT-BR-GVT2-DAYOFBIRTH;1MT-BR-GVT2-FIRSTINITIAL;1MT-BR-GVT2-FIRSTNAME;1MT-BR-GVT2-LASTNAME;1MT-BR-GVT2-MONTHOFBIRTH;1MT-BR-GVT2-POSTALCODE;1MT-BR-GVT2-PROVINCE;1MT-BR-GVT2-YEAROFBIRTH;1MT-BR-MATCHED-1+1;2AU-050-HOUSENUMBER;2AU-075-THOROUGHFARE;2AU-225-DISTRICT;3AU-200-ADDRESS;3MT-BR-GVT2-ADDRESS;4MT-BR-GVT2-PHONENUMBER;4MT-BR-GVT2-SUBPREMISE;",
        "code": "Códigos"
      }
    ],
    "detailCode": "WS-2253205.2024.4.27.17.1.51.23",
    "query": {
      "options": "identityverify;messageverbose"
    },
    "reliability": "10"
  }
}

Regra

Descrição

Informação básica com correspondência confiável

Indica se as informações básicas do indivíduo (nome, endereço, data de nascimento, número do documento e número de telefone) correspondem.

Informação básica com correspondência suficiente

Indica se as informações básicas do indivíduo (nome, endereço, data de nascimento, número do documento e número de telefone) correspondem parcialmente.

Atualizado há 1 ano