This event is triggered when a PIX reversal is received from the originating institution. The reversal removes previously credited funds from your business/customer’s account.
{
"type": "pixReversalIn",
"data": {
"debtor": {
"document": "123.456.789-10",
"name": "Ciclano teste",
"accountType": "checking",
"ispb": "00000001",
"branch": "8053",
"account": "351768"
},
"creditor": {
"document": "987.654.321-55",
"name": "Fulano de tal",
"accountType": "checking",
"ispb": "12345678",
"branch": "0001",
"account": "001022"
},
"flow": "IN",
"amount": 0.05,
"status": "success",
"endToEndId": "D0000000120251114132323720400868",
"txId": null,
"finishedAt": "2025-11-14T13:23:29.902Z",
"externalId": "13d8272f-1c97-42d4-acf6-64b450c31173",
"transactionType": "PIX_REVERSAL",
"metadata": {
"reason": "customerRequest",
"triggerTransactionId": "E17028875202511141322o0TbS3VoEiK"
}
}
}Fields
| Field | Type | Description |
|---|---|---|
| type | string | Name of the event type |
| data | Object | Event-specific payload. |
| data.description | string | Description of the charge |
| data.debtor | Object | Information about the payer |
| data.debtor.document | string | Payer's document (CPF/CNPJ) |
| data.debtor.name | string | Payer's name |
| data.debtor.accountType | string | Payer's account type |
| data.debtor.ispb | string | Payer's bank code identification |
| data.debtor.branch | string | Payer's branch number |
| data.debtor.account | string | Payer's account number |
| data.creditor | Object | Information about the payee |
| data.creditor.document | string | Payee's document (CPF/CNPJ) |
| data.creditor.name | string | Payee's name |
| data.creditor.accountType | string | Payee's account type |
| data.creditor.ispb | string | Payee's bank code identification |
| data.creditor.branch | string | Payee's branch number |
| data.creditor.account | string | Payee's account number |
| data.flow | string | Fixed value = 'IN' |
| data.amount | number | Amount received (R$) |
| data.status | string | Fixed value = 'success' |
| data.endToEndid | string | Central Bank's unique transaction id |
| data.txId | string | Reconciliation id linked to this payment |
| data.finishedAt | string | Settlement date |
| data.externalId | string | Url safe string that must be unique among all your Pix Reversals. |
| data.transactionType | string | Fixed value = 'PIX_REVERSAL' |
| data.metadata | Object | Extrafields information |
| data.metadata.reason | string | Reason why the Pix is being reversed. Options: "bankError", "fraud", "cashierError" and "customerRequest" |
| data.metadata.triggerTransactionId | string | Central Bank's unique transaction id of the Pix being reversed. |
