Sign in

v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
Infraction reports

Cancel infraction report

Cancel the infraction report.

Only the participant who created the report can cancel it and the report's status must be OPEN or ACKNOWLEDGED.

The operation is idempotent. If you try to cancel the report again with the same parameters, you will get the same response as the first time.

On PSP timeout, a 202 Accepted response is returned and the process continues asynchronously, eventually emitting a success or failure event.

This endpoint generates a <a href="https://developers.pismo.io/events/docs/pix-dict-infraction-status-change-1" >Pix infraction status changed</a> event.

post/v2/pix/infraction-reports/{id}/cancel

Path parameters

idstring uuid required

Infraction report ID

Headers

Authorizationstring required
Example:Bearer eyJhbGci...IUzUx

Account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in a <b>401 Unauthorized</b> message.

Response

OK

idstring uuid required

Infraction report ID (UUID)

transaction_idstring required

Original transaction's end to end ID.

reason'REFUND_REQUEST' | 'REFUND_CANCELLED' required

Reason for opening infraction report

situation_type'SCAM' | 'ACCOUNT_TAKEOVER' | 'COERCION' | 'FRAUDULENT_ACCESS' | 'OTHER' | 'UNKNOWN' required

What gave rise to the infraction notification

status'OPEN' | 'ACKNOWLEDGED' | 'CLOSED' | 'CANCELLED' required

Infraction report status

reporter_participantstring number required

Transaction payer participant's ISPB (Identifcador do Sistema de Pagamento Brazil) number - the Brazilian Payment System identifier, an 8-digit value.

counterparty_participantstring number required

Transaction recipient participant's ISPB (Identifcador do Sistema de Pagamento Brazil) number - the Brazilian Payment System identifier, an 8-digit value.

bacen_creation_datetimestring date-time required

Date of infraction report creation. RFC 3339 date-time value. For example - 2023-04-12T23:20:50.52Z.

bacen_last_modified_datetimestring date-time required

Date of infraction report modification. RFC 3339 date-time value. For example - 2023-04-12T23:20:50.52Z.

detailsstring

Details that can help the receiving participant to analyze the suspected violation

funds_recovery_idstring

Funds recovery identifier.

Returned from the Create funds recovery endpoint.

infraction_amountnumber

Infraction Amount.

Example response

{
  "id": "cfdff46e-5d58-45b8-b7aa-591a65f74444",
  "transaction_id": "E9999901012341234123412345678900",
  "reason": "REFUND_REQUEST",
  "situation_type": "SCAM",
  "status": "OPEN",
  "reporter_participant": "78265328",
  "counterparty_participant": "78265328",
  "bacen_creation_datetime": "2020-08-13T13:49:03Z",
  "bacen_last_modified_datetime": "2020-08-13T13:49:03Z",
  "details": "Details about infraction",
  "contact_information": {
    "phone": "551154874551",
    "email": "polly_ester@email.com"
  },
  "funds_recovery_id": "53D0F66A-BAB0-49D7-B7DC-807B82AABD8D",
  "infraction_amount": 1050.44
}