pixReversalIn

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


FieldTypeDescription
typestringName of the event type
dataObjectEvent-specific payload.
data.descriptionstringDescription of the charge
data.debtorObjectInformation about the payer
data.debtor.documentstringPayer's document (CPF/CNPJ)
data.debtor.namestringPayer's name
data.debtor.accountTypestringPayer's account type
data.debtor.ispbstringPayer's bank code identification
data.debtor.branchstringPayer's branch number
data.debtor.accountstringPayer's account number
data.creditorObjectInformation about the payee
data.creditor.documentstringPayee's document (CPF/CNPJ)
data.creditor.namestringPayee's name
data.creditor.accountTypestringPayee's account type
data.creditor.ispbstringPayee's bank code identification
data.creditor.branchstringPayee's branch number
data.creditor.accountstringPayee's account number
data.flowstringFixed value = 'IN'
data.amountnumberAmount received (R$)
data.statusstringFixed value = 'success'
data.endToEndidstringCentral Bank's unique transaction id
data.txIdstringReconciliation id linked to this payment
data.finishedAtstringSettlement date
data.externalIdstringUrl safe string that must be unique among all your Pix Reversals.
data.transactionTypestringFixed value = 'PIX_REVERSAL'
data.metadataObjectExtrafields information
data.metadata.reasonstringReason why the Pix is being reversed. Options: "bankError", "fraud", "cashierError" and "customerRequest"
data.metadata.triggerTransactionIdstringCentral Bank's unique transaction id of the Pix being reversed.