> 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/core-api/transaction-details/background-check/kyc/gdc2x2.md). # Verificação global dupla de identidade A função de consulta verifica 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. 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 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 uma pessoa, há 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. ![](/files/aa1e03fcca4d2724e028c4cc5221e3156aeecf74) **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 onboarding). {% tabs %} {% tab title="Parâmetros" %} | 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 | | {% endtab %} | | | | {% tab title="Corpo de exemplo" %} ```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 | 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](/caf-api/caf-api-pt-br/core-api/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 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 nome completo", "code": "1AU-425-COMPLETENAME" }, { "value": "Correspondência completa na inicial do primeiro nome", "code": "1AU-375-FIRSTINITIAL" }, { "value": "Correspondência completa no primeiro nome/nome próprio", "code": "1AU-350-FIRSTNAME" }, { "value": "Correspondência completa no sobrenome ", "code": "1AU-400-LASTNAME" }, { "value": "Correspondência completa no código postal/CEP", "code": "1AU-275-POSTALCODE" }, { "value": "Correspondência completa no estado/província", "code": "1AU-325-PROVINCE" }, { "value": "Correspondência completa na data de nascimento", "code": "1AU-550-DATEOFBIRTH" }, { "value": "Correspondência completa no dia de nascimento", "code": "1AU-575-DAYOFBIRTH" }, { "value": "Correspondência completa no mês de nascimento", "code": "1AU-600-MONTHOFBIRTH" }, { "value": "Correspondência completa no ano de nascimento", "code": "1AU-625-YEAROFBIRTH" }, { "value": "Correspondência parcial no elemento Address Lines", "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 total 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.caf.io/caf-api/caf-api-pt-br/core-api/transaction-details/background-check/kyc/gdc2x2.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.