get http://{{auth_server_host}}/banking/originator/persons/background-check
Esse endpoint deve ser utilizado para a realização a consulta de KYC (Know Your Customer) do CPF da Pessoa 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) : CPF da Pessoa 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"
}
]