pixReversalOut

This event is triggered when a PIX reversal initiated by your system is successfully completed and accepted by the destination bank.

{
  "type": "pixReversalOut",
  "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": "OUT",
    "description": "Estorno por motivo xyz",
    "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"
    }
  }
}
{
  "type": "pixReversalOut",
  "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": "OUT",
    "amount": 0.05,
    "status": "failed",
    "error": {
      "code": "UNKNOWN",
      "message": "Unknown error"
    },
    "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.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 = 'OUT'
data.descriptionstringReversal's description
data.amountnumberAmount received (R$)
data.statusstringPossible values : 'success', 'failed'
data.errorObjectInformation about the failure
data.error.codestringError code
data.error.messagestringError message
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.reasonstring | nullReason why the Pix is being reversed. Options: "bankError", "fraud", "cashierError" and "customerRequest"
data.metadata.triggerTransactionIdstring | nullCentral Bank's unique transaction id of the Pix being reversed.