Cancel Infraction Report

If an Infraction Report request was generated erroneously and the Indirect Participant wishes to cancel it, this can be done using the endpoint mentioned below.

IMPORTANT

It is emphasized that only the Participant who CREATED the Infraction Report can cancel it, and the cancellation can be made even if the infraction status is closed.

IMPORTANT

Canceled infraction reports can be listed using the endpoint List Infraction Reports.

Request

ENDPOINT

/pix/infraction_report/INFRACTION_REPORT_KEY

METHOD

PATCH

Request Body

{
    "infraction_report_status": "cancelled",
    "request_control_key": "750cbfa0-f628-4944-a76c-9053bf1ebc87",
}

Path Params

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

Body Params

Field	Type	Description	Characters
infraction_report_status *	string	Status to which the Infraction Report should be updated	36
request_control_key *	string	Unique identification key for the request used by the client in uuid v4 format	36

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",
   "infraction_report_direction": "outgoing",
   "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 | | 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_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_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.	-