Receive Infraction Report

Since another Participant may open an Infraction Report targeting the Indirect Participant, it is necessary for QI Tech to notify the Indirect Participant about the report opened by the other Participant.

QI Tech will periodically poll for new reports opened to the Indirect Participants it manages and will notify the corresponding participant via webhook, already with the status acknowledged.

IMPORTANT

The Central Bank of Brazil requires that, within a period of 7 days from the receipt of the Infraction Report by the Indirect Participant, the Report must be closed. If there is a delay on the part of the Indirect Participant, QI Tech will close the Infraction Report with the status of agreed, 6 calendar days after sending the receipt of infraction webhook, to ensure the institution is not penalized by the Central Bank of Brazil.

The status of the Infraction Report will always be acknowledged, meaning that QI Tech has received the Report and will forward it to the Indirect Participant.

Information

Everything described in this introduction section is also detailed in the sections related to Infraction Notifications on how the Indirect Participant should handle it via API.

Webhook for Receiving Infraction Report

Request Body

{
    "infraction_report_key":"d7820e2f-1c23-4610-83d6-d9aad1845075",
    "pix_transfer_key":"cdcf0d25-08a1-46e3-902a-6d7ca75e6c48",
    "end_to_end_id":"E99999010202406251332F8n7dMUwOLE",
    "infraction_report_status":"acknowledged",
    "infraction_report_situation":"scam",
    "infraction_report_type":"refund_request",
    "report_details":"usuario caiu em golpe…",
    "debited_participant":"99999011",
    "credited_participant":"99999010",
    "infraction_report_direction": "incoming",
    "created_at": "2023-03-03T12:04:06.179Z",
    "updated_at": "2023-03-03T12:04:06.179Z"
}

Body Params

Field	Type	Description	Characters
infraction_report_key *	string	Unique identifier of the infraction report.	36
pix_transfer_key *	string	Unique identifier of the PIX transaction.	36
end_to_end_id *	string	Unique identifier of the PIX transaction at BACEN.	36
infraction_report_status *	enum	Status.	Enumerators infraction_report_status
infraction_report_situation *	enum	Situation in which the infraction occurred.	Enumerators infraction_report_situation
infraction_report_type *	enum	Type of Infraction Report.	Enumerators infraction_report_type
infraction_report_details	string	Details about the created Infraction Report.	Less or equal 2000
credited_participant *	string	ISPB of the Credited Participant.	8
debited_participant *	string	ISPB of the Debited Participant.	8
infraction_report_direction *	enum	Enumerator on whether the report was opened by the Indirect Participant or another Participant	Enumerators infraction_report_direction
created_at *	string	Infraction Report creation time.	24
updated_at	string	Infraction Report update time.	24

Enumerators infraction_report_status

Field	Type	Description	Characters
open	string	Infraction report was created and is open at BACEN.	-
acknowledged	string	Infraction report was received by the contested participant.	-
cancelled	string	Infraction report is cancelled at BACEN.	-
closed	string	Infraction report is closed at BACEN.	-

Enumerators infraction_report_type

Field	Type	Description	Characters
refund_cancelled	string	Infraction report will be generated due to a cancelled refund	16
refund_request	string	Infraction report will be generated to request a refund	14

Enumerators infraction_report_situation

Field	Type	Description	Characters
scam	string	Cause of scam or fraud.	-
account_takeover	string	Cause of unauthorized transaction from the origin account.	-
coercion	string	Cause of coercion crime.	-
fraudulent_access	string	Cause of fraudulent access to the origin account.	-
other	string	Any causes not applicable to those listed above.	-

Enumerators infraction_report_direction

Field	Type	Description	Characters
incoming	string	Infraction report with the indirect participant as the target.	-
outgoing	string	Infraction report with the indirect participant as the originator.	-

Webhook recebimento de alteração de Relato de Infração

Request Body

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

Body Params

Field	Type	Description	Characters
infraction_report_key *	string	Unique identifier of the infraction report.	36
pix_transfer_key *	string	Unique identifier of the PIX transaction.	36
end_to_end_id *	string	Unique identifier of the PIX transaction at BACEN.	36
infraction_report_status *	enum	Status.	Enumerators infraction_report_status
infraction_report_situation *	enum	Situation in which the infraction occurred.	Enumerators infraction_report_situation
infraction_report_type *	enum	Type of Infraction Report.	Enumerators infraction_report_type
infraction_report_details	string	Details about the created Infraction Report.	Less or equal 2000
credited_participant *	string	ISPB of the Credited Participant.	8
debited_participant *	string	ISPB of the Debited Participant.	8
analysis_result *	string	Result of the analysis.	Enumerators analysis_result
analysis_details *	string	Description of the analysis result	250
infraction_report_direction *	enum	Enumerator on whether the report was opened by the Indirect Participant or another Participant	Enumerators infraction_report_direction
created_at *	string	Infraction Report creation time.	24
updated_at	string	Infraction Report update time.	24

Enumerators analysis_result

Field	Type	Description	Characters
agreed	string	The Indirect Participant agrees with the Infraction Report created by the other Participant.	-
disagreed	string	The Indirect Participant disagrees with the Infraction Report created by the other Participant.	-