Fechar Relato de Infração

A QI Tech será responsável por realizar um pooling no Banco Central do Brasil a fim de se verificar se há Relato(s) de Infração criados por outros Participantes para o Participante Indireto, e enviará o webhook de recebimento já com o status acknowledged para o mesmo.

A fim de informar o Participante Indireto de que há um Relato de Infração a ser respondido pelo mesmo, a QI Tech irá fazer um webhook de recebimento no mesmo.

IMPORTANTE

Ressalta-se que apenas o Participante o qual RECEBEU o Relato de Infração pode fechá-lo.

IMPORTANTE

O Banco Central do Brasil define que, dentro de um período de 7 dias do recebimento do Relato de Infração pelo Participante Indireto, o Relato precisa ser fechado.

Caso haja atraso por parte do Participante Indireto, a QI Tech irá fechar o Relato de Infração, com o status de agreed, 6 dias corridos após o envio do webhook de recebimento da infração, a fim de que a instituição não seja penalizada pelo Banco Central do Brasil.

Para o fechamento do relato de infração, o status deve ser acknowledged.

Request

ENDPOINT

/pix/infraction_report/INFRACTION_REPORT_KEY

MÉTODO

PATCH

Request Body - Aceite

{
    "infraction_report_status": "closed",
    "request_control_key": "feb59932-be7a-4584-9830-02ed8bc0aa77",
    "analysis_result": "agreed",
    "fraud_type": "application_fraud",
    "analysis_details": "Valor bloqueado. Para mais informações ligue para (11) 98871-1385.",
}

Request Body - Recusa

{
    "infraction_report_status": "closed",
    "request_control_key": "feb59932-be7a-4584-9830-02ed8bc0aa77",
    "analysis_result": "disagreed",
    "analysis_details": "Valor bloqueado. Para mais informações ligue para (11) 98871-1385.",
}

Path Params

Campo	Tipo	Descrição	Caracteres
infraction_report_key	string	UUID4 do Relato de Infração criado o qual se deseja fechar.	36

Body Params

Campo	Tipo	Descrição	Caracteres
analysis_result *	enum	Resultado da análise.	Enumeradores analysis_result
request_control_key *	uuidv4	UUID4 para fins de consulta sobre a requisição feita.	36
infraction_report_status *	enum	Status o qual se deseja 'setar' o relato de infração.	Enumeradores infraction_report_status
fraud_type	enum	Tipo de fraude constatada. Não pertencente à entidade infraction report, porém necessário para o fechamento.	Enumeradores fraud_type
analysis_details	string	Descrição acerca do resultado da análise	250

Enumeradores analysis_result

Campo	Tipo	Descrição	Caracteres
agreed	string	O Participante Indireto concorda com o Relato de Infração criado pelo outro Participante.	-
disagreed	string	O Participante Indireto discorda com o Relato de Infração criado pelo outro Participante.	-

Enumeradores infraction_report_status

Campo	Tipo	Descrição	Caracteres
open	string	Relato de infração foi criado e está aberto no BACEN.	-
acknowledged	string	Relato de infração foi recebido pelo participante	-
cancelled	string	Relato de infração está cancelado no BACEN	-
closed	string	Relato de infração está fechado no BACEN	-

Enumeradores fraud_type

Campo	Tipo	Descrição	Caracteres
application_fraud	string	Fraude por falsidade ideológica, com documentos de outra pessoa.	-
mule_account	string	Fraude por conta laranja, aberta de forma legítma.	-
scammer_account	string	Fraude na qual a conta destino esta no nome do verdadeiro fraudador.	-
other	string	Fraude de outra naturaza, não enquadrada nos enumeradores acima.	-

Response

STATUS

200

Response Body

{
   "infraction_report_key":"d7820e2f-1c23-4610-83d6-d9aad1845075",
   "pix_transfer_key":"cdcf0d25-08a1-46e3-902a-6d7ca75e6c48",
   "end_to_end_id":"E99999011202406251332F8n7dMUwOLE",
   "infraction_report_status":"cancelled",
   "infraction_report_situation":"scam",
   "infraction_report_type":"refund_request",
   "infraction_report_details":"usuario caiu em golpe…",
   "debited_participant":"99999010",
   "credited_participant":"99999011",
   "analysis_result": "agreed",
   "analysis_details": "Valor bloqueado. Para mais informações ligue para (11) 98871-1385.",
   "infraction_report_direction": "incoming",
   "created_at": "2023-03-03T12:04:06.179Z",
   "updated_at": "2023-03-03T12:05:03.421Z",
}

Body Params

Campo	Tipo	Descrição	Caracteres
infraction_report_key *	string	Identificador único do relato de infração.	36
pix_transfer_key *	string	Identificador único da transação PIX.	36
end_to_end_id *	string	Identificador único da transação PIX no BACEN.	36
infraction_report_status *	enum	Status acerca do Relato de Infração	Enumeradores infraction_report_status
infraction_report_situation *	enum	Situação em que ocorreu a infração.	Enumeradores infraction_report_situation
infraction_report_type *	enum	Tipo de Relato de Infração.	Enumeradores infraction_report_type
infraction_report_details	string	Detalhes acerca do Relato de Infração criado.	<= 2000
credited_participant *	string	ISPB do Participante Creditado.	8
debited_participant *	string	ISPB do Participante Debitado.	8
analysis_result *	string	Resultado da análise.	Enumeradores analysis_result
analysis_details *	string	Descrição acerca do resultado da análise.	250
infraction_report_direction *	enum	Enumerador acerca se o relato foi aberto pelo Participante Indireto ou por outro Participante	Enumeradores infraction_report_direction
created_at *	string	Data de criação do Relato de Infração	24
updated_at *	string	Data de atualização do Relato de Infração	24

Enumeradores infraction_report_situation

Campo	Tipo	Descrição	Caracteres
scam	string	Causa de golpe ou estelionato.	-
account_takeover	string	Causa de transação não autorizada pela conta de origem.	-
coercion	string	Causa de crime de coerção.	-
fraudulent_access	string	Causa de acesso fraudulento à conta de origem.	-
other	string	Quaisquer causas não aplicáveis às listadas acima.	-

Enumeradores infraction_report_type

Campo	Tipo	Descrição	Caracteres
refund_request	string	Relato de infração será gerado a fim de se solicitar uma devolução.	-
refund_cancelled	string	Relato de infração será gerado pelo motivo de uma devolução cancelada.	-

Enumeradores infraction_report_direction

Campo	Tipo	Descrição	Caracteres
incoming	string	Relato de infração com participante indireto como alvo.	-
outgoing	string	Relato de infração com participante indireto como originador.	-