v1

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

Get infraction report

Get an infraction report's details.

get/v2/pix/infraction-reports/{id}

Path parameters

idstring uuid required

Infraction report ID

Query parameters

fundsRecoveryIdstring

Funds recovery identifier.

Returned from the Create funds recovery endpoint.

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.

x-account-idstring

Pismo account ID. REQUIRED if this is an intra-PSP transaction, meaing a transaction within the same organization or participant.

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
}