Close Infraction Report

QI Tech will be responsible for conducting a polling with the Central Bank of Brazil to check if there are any Infraction Reports created by other Participants for the Indirect Participant, and will send the receipt webhook with the status acknowledged. To inform the Indirect Participant that there is an Infraction Report to be responded to, QI Tech will send a receipt webhook.

IMPORTANT

It is emphasized that only the Participant who RECEIVED the Infraction Report can close it.

IMPORTANT

The Central Bank of Brazil defines that within a period of 7 days from receiving 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.

To close the infraction report, the status must be acknowledged.

Request

ENDPOINT

/pix/infraction_report/INFRACTION_REPORT_KEY

METHOD

PATCH

Request Body - Agreed

{
    "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 - Disagreed

{
    "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

Field	Type	Description	Characters
infraction_report_key	string	UUID4 of the created Infraction Report to be closed.	36

Body Params

Field	Type	Description	Characters
analysis_result *	enum	Result of the analysis.	Enumerators analysis_result
request_control_key *	uuidv4	UUID4 for querying about the made request.	36
infraction_report_status *	enum	Status to be set for the infraction report.	Enumerators infraction_report_status
fraud_type	enum	Type of fraud detected. Not part of the infraction report entity but necessary for closure.	Enumerators fraud_type
analysis_details	string	Description of the analysis result	250

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.	-

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 participant	-
cancelled	string	Infraction report is cancelled at BACEN	-
closed	string	Infraction report is closed at BACEN	-

Enumerators fraud_type

Field	Type	Description	Characters
application_fraud	string	Fraud by identity theft, with documents of another person.	-
mule_account	string	Fraud through mule account, opened legitimately.	-
scammer_account	string	Fraud in which the destination account is in the name of the real fraudster.	-
other	string	Fraud of a different nature, not fitting the above enumerators.	-

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

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 of the Infraction Report	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 date	24
updated_at	string	Infraction Report update date	24

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_type

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

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.	-

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.	-

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 participant	-
cancelled	string	Infraction report is cancelled at BACEN	-
closed	string	Infraction report is closed at BACEN	-