post http://{{auth_server_host}}/banking/originator/business/background-check
Esse endpoint permite uma consulta de forma anteciapada 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
- name (string, obrigatório): A razão social da empresa a ser consultada.
- taxpayer_id (string, obrigatório): O 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": "APPROVED"
}