Sign in

v1

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

Create infraction report (outdated)

This endpoint is outdated and no longer works. It is recommended you call Create funds recovery instead.

Creates an infraction report. Both the debited participant and the credited participant can create an infraction report.

For refund requests, the original transaction payer's payment service provider (PSP) must create the report.

Only the PSP or the original transaction's recipient can cancel a refund.

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

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.

Idempotency-Keystring required

A unique ID to ensure the operation remains idempotent, allowing for operation repitition without causing unintended effects or duplication. An idempotent operation is one that can be applied multiple times, yet the outcome remains the same. it ensures that network errors, retries, or failures can occur without introducing inconsistencies.

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

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