> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-api/caf-api-pt-br/api-core/transaction-details/background-check/kyc/gdc2x2.md).

# Dupla verificação global de identidade

A função de 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 действительно pertencem a essa pessoa.

O Global Identity Verification 2x2 tem uma camada extra de validações porque, ao consultar uma pessoa por meio deste serviço, ela será verificada em relação a duas fontes de dados diferentes em uma única consulta. Em outras palavras, os dados básicos serão enviados a dois provedores diferentes e deverão ser aprovados por ambos para que os dados sejam considerados confiáveis, suficientes ou insuficientes.

Para indicar a confiabilidade de um indivíduo, existem algumas combinações possíveis de dados que levam em conta os resultados de ambas as fontes para definir a pontuação final de confiabilidade.

![](https://262277803-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbVxCOSyBojfSIE5fcpfH%2Fuploads%2Fgit-blob-1ec6d8115a95cfd1b6b59b9c37ecbe20029c0fcf%2Ftable2x2.png?alt=media)

**Seção**: `globalIdentityVerifications2x2`

**Países suportados:** Argentina, Austrália\*, Áustria, Bélgica, Brasil, Canadá\*, China, Dinamarca, Finlândia, França, Alemanha, Hong Kong\*, Índia\*, Itália, México, Países Baixos, Noruega, Portugal, África do Sul, Espanha, Suécia, Suíça, Reino Unido e Estados Unidos.

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

{% tabs %}
{% tab title="Parâmetros" %}

| Atributo     | Tipo                 | Descrição                                                     | Obrigatório               |
| ------------ | -------------------- | ------------------------------------------------------------- | ------------------------- |
| nome         | cadeia de caracteres | Nome completo do indivíduo.                                   | Sim                       |
| birthDate    | cadeia de caracteres | Data de nascimento do indivíduo.                              | Sim                       |
| address      | cadeia de caracteres | Endereço do indivíduo.                                        | Sim                       |
| phoneNumber  | cadeia de caracteres | Número de telefone do indivíduo.                              | Sim                       |
| nationalId   | cadeia de caracteres | Um número ou documento de identificação emitido pelo governo. | Sim/Não (depende do país) |
| zipCode      | cadeia de caracteres | Código postal do endereço do indivíduo.                       | Sim                       |
| countryCode  | cadeia de caracteres | Código do país do indivíduo.                                  | Sim                       |
| dateFormat   | cadeia de caracteres | Formato da data de nascimento.                                | Não                       |
| {% endtab %} |                      |                                                               |                           |

{% tab title="Exemplo de corpo" %}

```javascript
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",
  },
});
```

{% endtab %}
{% endtabs %}

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

{% tabs %}
{% tab title="Esquema" %}

| Atributo               | Tipo                 | Descrição                                                                                                                                                                    |
| ---------------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| dados                  | objeto               | Objeto contendo os dados principais.                                                                                                                                         |
| data.detailList        | cadeia de caracteres | Detalhes relacionados à consulta.                                                                                                                                            |
| data.adaptation        | cadeia de caracteres | 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 | cadeia de caracteres | Indica o nível de correspondência dos dados (correspondência completa, sem correspondência, correspondência parcial etc.).                                                   |
| data.messages\[].code  | cadeia de caracteres | Código que indica o tipo de dado analisado (FIRSTNAME, COMPLETENAME, PHONENUMBER etc.).                                                                                      |
| data.detailCode        | cadeia de caracteres | Código detalhado específico para o processo ou solicitação.                                                                                                                  |
| data.query             | objeto               | Informações sobre a consulta realizada.                                                                                                                                      |
| data.query.options     | cadeia de caracteres | Valor interno que indica o tipo de busca da consulta.                                                                                                                        |
| data.reliability       | cadeia de caracteres | Indicador de confiabilidade (10, 20, 30).                                                                                                                                    |
| data.statusCode        | cadeia de caracteres | Status da transação. Consulte nosso guia de status.                                                                                                                          |
| statusCode             | cadeia de caracteres | Refere-se apenas ao status desta consulta, não à transação inteira. [Consulte nosso guia de status](/caf-api/caf-api-pt-br/api-core/transaction-details/background-check.md) |
| {% endtab %}           |                      |                                                                                                                                                                              |

{% tab title="Exemplo" %}

```json
{
  "data": {
    "detailList": "",
    "adaptation": "0",
    "messages": [
      {
        "value": "0;0;0;3;3;0;3;0;3;3;0;3;3;0;3;3;3;3;0;0;0;0;0;4;3",
        "code": "TEL7"
      },
      {
        "value": "1;1;1;3;3;1;3;2;3;0;0;4;3;0;3;0;0;3;0;1;1;1;1;4;3",
        "code": "GVT2"
      },
      {
        "value": "Correspondência completa encontrada para Nome Completo",
        "code": "1MT-BR-GVT2-COMPLETENAME"
      },
      {
        "value": "Correspondência completa encontrada para a inicial do nome",
        "code": "1MT-BR-GVT2-FIRSTINITIAL"
      },
      {
        "value": "Correspondência completa encontrada para o primeiro nome/nome próprio",
        "code": "1MT-BR-GVT2-FIRSTNAME"
      },
      {
        "value": "Correspondência completa encontrada para o sobrenome",
        "code": "1MT-BR-GVT2-LASTNAME"
      },
      {
        "value": "Correspondência completa encontrada para o código postal/CEP",
        "code": "1MT-BR-GVT2-POSTALCODE"
      },
      {
        "value": "Correspondência completa encontrada para estado/província",
        "code": "1MT-BR-GVT2-PROVINCE"
      },
      {
        "value": "A fonte de dados não contém o elemento Descritores de subpremissa fornecido nas linhas de endereço",
        "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 encontrada no elemento Linhas de endereço",
        "code": "3MT-BR-GVT2-ADDRESS"
      },
      {
        "value": "Correspondência completa encontrada para a data de nascimento",
        "code": "1MT-BR-GVT2-DATEOFBIRTH"
      },
      {
        "value": "Correspondência completa encontrada para o dia de nascimento",
        "code": "1MT-BR-GVT2-DAYOFBIRTH"
      },
      {
        "value": "Correspondência completa encontrada para o mês de nascimento",
        "code": "1MT-BR-GVT2-MONTHOFBIRTH"
      },
      {
        "value": "Correspondência completa encontrada para o ano de nascimento",
        "code": "1MT-BR-GVT2-YEAROFBIRTH"
      },
      {
        "value": "Correspondência completa encontrada para Nome Completo",
        "code": "1AU-425-COMPLETENAME"
      },
      {
        "value": "Correspondência completa encontrada para a inicial do nome",
        "code": "1AU-375-FIRSTINITIAL"
      },
      {
        "value": "Correspondência completa encontrada para o primeiro nome/nome próprio",
        "code": "1AU-350-FIRSTNAME"
      },
      {
        "value": "Correspondência completa encontrada para o sobrenome",
        "code": "1AU-400-LASTNAME"
      },
      {
        "value": "Correspondência completa encontrada para o código postal/CEP",
        "code": "1AU-275-POSTALCODE"
      },
      {
        "value": "Correspondência completa encontrada para estado/província",
        "code": "1AU-325-PROVINCE"
      },
      {
        "value": "Correspondência completa encontrada para a data de nascimento",
        "code": "1AU-550-DATEOFBIRTH"
      },
      {
        "value": "Correspondência completa encontrada para o dia de nascimento",
        "code": "1AU-575-DAYOFBIRTH"
      },
      {
        "value": "Correspondência completa encontrada para o mês de nascimento",
        "code": "1AU-600-MONTHOFBIRTH"
      },
      {
        "value": "Correspondência completa encontrada para o ano de nascimento",
        "code": "1AU-625-YEAROFBIRTH"
      },
      {
        "value": "Correspondência parcial encontrada no elemento Linhas de endereço",
        "code": "3AU-200-ADDRESS"
      },
      {
        "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;3AU-200-ADDRESS;3MT-BR-GVT2-ADDRESS;4MT-BR-GVT2-PHONENUMBER;4MT-BR-GVT2-SUBPREMISE;GVT2;TEL7;",
        "code": "Códigos"
      },
      {
        "value": "GVT2-ND",
        "code": "MatchCodes"
      },
      {
        "value": "Correspondência completa para verificação 1+1",
        "code": "1MT-BR-MATCHED-1+1"
      }
    ],
    "detailCode": "WS-9055217.2024.4.28.16.42.15.908",
    "query": {
      "options": "identityverify;messageverbose"
    },
    "reliability": "20"
  }
}
```

{% endtab %}

{% tab title="Regras de Validação" %}

| Regra                                                                  | Descrição                                                                                                                                               |
| ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Informações básicas com correspondência confiável - dupla verificação  | 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ções básicas com correspondência suficiente - dupla verificação | 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. |
| {% endtab %}                                                           |                                                                                                                                                         |
| {% endtabs %}                                                          |                                                                                                                                                         |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.caf.io/caf-api/caf-api-pt-br/api-core/transaction-details/background-check/kyc/gdc2x2.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
