Respond to Infraction Reports

The Central Bank establishes a 7-day limit for analyzing infraction reports, with the objective of maintaining service quality and the return mechanism. QI Tech reserves up to 5 days for the client to respond to the received infraction justifying the legitimacy or not of the transaction, and 2 days for internal analysis and fact-finding. It's worth noting that the final word on accepting or not accepting a report belongs exclusively to QI Tech.

Warning

After 5 days have elapsed, the infraction will be automatically closed accepting it, if the client does not respond.

Request

ENDPOINT

/internal/pix/infraction_report/incoming/INFRACTION_REPORT_KEY

METHOD

PATCH

Request Body

{
    "client_awnser": "Transação legítma, conforme demonstrado na nota fiscal XXXXXXXXXX que confirma a venda do produto.",
}

Body params

Field	Type	Description	Characters
client_awnser *	string	Client's interpretation regarding the transaction flagged as fraudulent.	2000

Response

STATUS

200

Response Body

{
    "target_person_key": "4f6ea994-e53a-4ef8-b2b0-89d14c4667bc",
    "end_to_end_id": "E12345678202407171627342xlR8KpoD",
    "pix_transfer_key": "6cf241f8-328a-4813-90ab-2aef74d853ac",
    "target_account_key": "9d5b1a98-03ac-4202-91e8-29dbff3d1108",
    "infraction_report_status": "pending_approval",
    "infraction_report_situation": "fraudulent_access",
    "analysis_result": null,
    "analysis_details": null,
    "infraction_report_type": "refund_request",
    "debited_participant": "12345678",
    "credited_participant": "32402502",
    "blocked_balance_status": "completelly_blocked",
    "infraction_report_key": "90b4e1bc-89bc-4df8-98a2-f912447b178f",
    "infraction_report_details": "Transação acusada como fraudulenta pelo originador.",
    "client_details": "Transação legítma, conforme demonstrado na nota fiscal XXXXXXXXXX que confirma a venda do produto.",
    "created_at": "2024-07-22T13:31:09Z",
    "updated_at": "2024-07-22T13:31:09Z",
}

Field	Type	Description	Characters
target_person_key*	string	Person key of the infraction target.	32
end_to_end_id*	string	end_to_end_id of the original transaction.	32
pix_transfer_key*	string	Pix transfer key of the original transaction.	32
target_account_key*	string	Account key of the destination account of the original transaction.	32
infraction_report_status*	string	Status of the infraction.	Enumerators incoming_infraction_report_status
infraction_report_situation*	string	Situation of the infraction.	Enumerators infraction_report_situation
analysis_result	string	Result of the analysis. Decided by QI Tech.	Enumerators infraction_report_analysis_result
analysis_details	string	Justification for the analysis result.	200
infraction_report_type*	string	Type of infraction report.	Enumerators infraction_report_type
debited_participant*	string	Participant that originated the transaction.	8
credited_participant*	string	Participant that received the transaction.	8
blocked_balance_status*	string	Status of the balance blocking of the destination account.	Enumerators blocked_balance_status
infraction_report_key*	string	UUID4 identifier of the transaction at Bacen.	32
infraction_report_details	string	Infraction details sent by the other participant.	2000
client_details*	string	Details provided by the client about the original transaction.	2000
created_at*	string	Date and time of transaction modification.	20
updated_at*	string	Date and time of transaction creation.	20

Enumerators incoming_infraction_report_status

Enumerator	Description
pending_client_awnser	Infraction received, awaiting client justification.
pending_approval	Justification sent, awaiting internal approval.
automatically_closed	Automatically closed due to lack of client response.
manually_closed	Closed by QI Tech after analyzing the client's response.
cancelled	Cancelled by the originator.

Enumerators infraction_report_situation

Enumerator	Description
scam	Cause of scam or fraud.
account_takeover	Cause of unauthorized transaction by origin account.
coercion	Cause of coercion crime.
fraudulent_access	Cause of fraudulent access to origin account.
other	Any causes not applicable to those listed above.

Enumerators infraction_report_analysis_result

Enumerator	Description
agreed	The Indirect Participant agrees with the Infraction Report created by the other Participant.
disagreed	The Indirect Participant disagrees with the Infraction Report created by the other Participant.

Enumerators infraction_report_type

Enumerator	Description
refund_cancelled	Infraction report will be generated due to a cancelled refund.
refund_request	Infraction report will be generated to request a refund.

Enumerators blocked_balance_status

Enumerator	Description
no_balance	Client account with no balance. Monitoring pending balance.
completelly_blocked	Resources equivalent to the transaction completely blocked.
partially_blocked	Resources equivalent to the transaction partially blocked. Monitoring balance.
settled	Infraction accepted, and refund request payment made.
partially_settled	Infraction accepted, and refund request payment partially made.
released	Resources released, either by infraction cancellation or disagreement closure.