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",
    "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.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 = 'OUT'
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.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.