Exemplo de Webhook — Status REFUNDED

Para transações do tipo devolução, os clientes que optarem por utilizar o status REFUSED devem esperar o padrão abaixo.

O status REFUNDED tem comportamento semelhante ao status SUCCESS. Ele é enviado apenas quando a transação atinge sua fase final, indicando que o processo foi concluído — com seu rembolso feito com sucesso, seja ele de "débito" ou "crédito".

Os webhooks das transações de devolução seguem o mesmo padrão de uma transação normal de crédito ou débito

Alguns Pontos que deve ser percebido na diferenciação de uma transação de devolução

• EndToEnd da transação começa com a letra D

• Existencia do endToEndOrigin

• Status da transação - quando finalizada - é REFUNDED

{
  "id": "111111-92d1-4b2b-95b3-8a5f2b0b3e42",
  "txId": "PAGAPAGA123",
  "endToEnd": "D3015394320251106112233ABCDE1234",
  "dtHrTransaction": "2025-11-06T11:22:33.000Z",
  "initializationType": "null",
  "payer": {
    "ispb": "360305",
    "personType": "FISICA",
    "cpfCnpj": "12345678900",
    "name": "JOAO SILVA",
    "agency": "1234",
    "accountType": "POUPANCA",
    "accountNumber": "9876543210"
  },
  "receiver": {
    "ispb": "11165756",
    "personType": "JURIDICA",
    "cpfCnpj": "98765432000100",
    "name": "EMPRESA ABC TECNOLOGIA LTDA",
    "agency": "0001",
    "accountType": "CORRENTE",
    "accountNumber": "100020003000"
  },
  "paymentPriority": "LIQUIDACAO_PRIORITARIA",
  "tpPaymentPriority": "PAGAMENTO_PRIORITARIO",
  "purpose": "COMPRA_TRANSFERENCIA",
  "amount": 250.75,
  "message": "",
  "description": "MD06: Devolvido pelo recebedor",
  "key": "11111111-1111-1111-7cd9-08de1783c3c0",
  "status": "REFUNDED",
  "notify": "pix_in",
  "endToEndOrigin": "E1116575620251106112233ABCDE1234"
}

---

{
id: "11111111-1111-1111-7cd9-08de1783c3c0",
txId: "AAAAAA-1111-CCCC-1111-03ec8772f9d7",
endToEnd: "D1116575620251106112233ABCDE1234",
dtHrTransaction: "2025-10-30T07:13:03.864Z",
initializationType: "MANUAL",
payer: {
ispb: "11165756",
personType: "JURIDICA",
cpfCnpj: "98765432000100",
agency: "1",
accountType: "CORRENTE",
accountNumber: "9876543210"
},
receiver: {
ispb: "416968",
personType: "FISICA",
cpfCnpj: "1234567890",
agency: "1",
accountType: "CORRENTE",
accountNumber: "100020003000",
name: "JOAO SILVA"
},
paymentPriority: "LIQUIDACAO_PRIORITARIA",
tpPaymentPriority: "PAGAMENTO_PRIORITARIO",
purpose: "COMPRA_TRANSFERENCIA",
amount: 1,
description: "Refund of transaction: E0041696820251106112233ABCDE1234",
message: "O CPF do pagador não corresponde ao documento informado no QR Code.",
key: "11111111-1111-1111-7cd9-08de1783c3c0",
status: "REFUNDED",
notify: "pix_out",
endToEndOrigin: "E0041696820251106112233ABCDE1234"
}