Consultar KYC do CNPJ da Empresa

Esse endpoint deve ser utilizado para a realização a consulta de KYC (Know Your Customer) do CNPJ da empresa nos bureaus que forem contratados para a esteira que está em implementação.

O KYC é um conjunto de ações que precisam ser cumpridas no mercado financeiro para verificar se um usuário, seja pessoa física ou jurídica, é realmente quem ele diz ser, ajudando a prevenir fraudes de identidade, lavagem de dinheiro, crime organizado e financiamento ao terrorismo.

Parâmetros da Requisição

Não é necessário o envio de nenhum dado no corpo da requisição.

Parâmetros da URL

• taxpayer_id (string) : CNPJ da Empresa a ser consultada.
  

Resposta

A resposta para a requisição é um JSON no seguinte formato:

• result (object): Objeto contendo os detalhes da consulta efetuada. O conteúdo desse JSON depende de qual fornecedor será utilizado para a consulta do KYC.
  
• created_at (Datetime): Campo no formato de data/hora da consulta realizada.
  
• status (string): Campo contendo o status da consulta realizada. Possíveis valores: REJECTED, NOT_REQUIRED, APPROVED
  

Exemplo de JSON de resposta:

[
    {
        "result": {},
        "created_at": "<dateTime>",
        "status": "REJECTED"
    }
]