Bankslip voided Webhook

info

📘 To learn more about webhooks in our API, follow the link below:

About Webhooks

When a bankslip charge is voided, the best way to receive this information is using the webhook CHARGE_VOIDED. As soon as a bankslip charge is voided, a CHARGE_VOIDED webhook is sent to the registered URL.

Here's the simplest way to configure a CHARGE_VOIDED webhook:

Headers

Name	Description
x-delbank-api-key	Required. API key
x-delfinance-account-id	Required. The Delfinance bank account number

Body

{
  "eventType": "CHARGE_VOIDED",
  "url": "https://example.com.br/webhooks/v1/chargevoided",
  "authorization": "NONE",
  "authorizationScheme": "NONE"
}

Once a bankslip charge is voided, here's what you are going to receive on the registered URL:

CHARGE_VOIDED

{
  "dynamicQrCodeExpiresInDefault": 86400,
  "id": 326344,
  "bankAccount": "10073",
  "correlationId": "992b1814-37c2-487b-b0e0-acdfeaff643a",
  "type": "BANKSLIP_PIX",
  "amount": 1.11,
  "dueDate": "2026-03-18T02:59:59",
  "dueDateBrazil": "2026-03-18T02:59:59",
  "status": "Voided",
  "payers": [
    {
      "id": 290387,
      "chargeId": 326344,
      "type": "Payer",
      "name": "JOSEPHTESTERSONPOGGERSON",
      "document": "30030030030",
      "email": "[email protected]",
      "dialCode": "79",
      "phoneNumber": "999999999",
      "address": {
        "payerId": 290387,
        "zipCode": "01030000",
        "publicPlace": "Rua Florencio de Abreu",
        "number": "S/N",
        "neighborhood": "Centro",
        "complement": "",
        "city": "SÃO PAULO",
        "state": "SP"
      }
    }
  ],
  "pix": {
    "chargeId": 326344,
    "identifier": "vcharge0000000000000326344",
    "qrCode": "00020101021226770014br.gov.bcb.pix2555pix-h.delbank.com.br/v2/cobv/vcharge00000000000003263445204000053039865802BR5907DELBANK6009SAO PAULO62070503***63043894",
    "additionalInfo": [
      {
        "key": "YourNumber",
        "value": "10"
      },
      {
        "key": "OurNumber",
        "value": "00000546293"
      },
      {
        "key": "DigitableLine",
        "value": "43590001161200000160700005462932313880000000111"
      }
    ]
  },
  "bankslip": {
    "chargeId": 326344,
    "walletNumber": "112",
    "yourNumber": "10",
    "ourNumber": "00000546293",
    "barCode": "43593138800000001110001112000001600000546293",
    "digitableLine": "43590001161200000160700005462932313880000000111"
  },
  "beneficiary": {
    "bankAccount": "10073",
    "customerName": "AlterandoNome",
    "customerDocument": "10613462939",
    "customerEmail": "[email protected]",
    "accountHeader": "43500000160000010073",
    "publicPlace": "Comendador Norberto Marcondes",
    "number": "2533",
    "zipCode": "87303100",
    "neighborhood": "Centro",
    "complement": "bloco 6 ap 01",
    "cityName": "CAMPO MOURÃO",
    "cityState": "PR",
    "cnabDirectorySource": "C:\\Autbank\\COBRANCA\\10073\\ORIGEM",
    "cnabDirectoryDestination": "C:\\Autbank\\COBRANCA\\10073\\DESTINO",
    "cnabNameFileDefault": "CB10073.REM",
    "charges": [],
    "remittances": []
  },
  "fees": [],
  "payments": [],
  "formatResponse": "PAYLOAD_AND_IMAGEBASE64",
  "isBankslipType": true,
  "hasPaymentSourceSiloc": false,
  "events": [
    {
      "id": 3085,
      "chargeId": 326344,
      "eventType": "VOIDED",
      "sourceType": "CEDENT",
      "createdAt": "2025-07-10T19:29:57.007"
    }
  ],
  "providerStatus": "Voided",
  "writtenOffAt": "2026-06-01T20:09:54.1188588Z",
  "updatedAt": "2026-06-01T20:09:54.1187818Z",
  "createdAt": "2025-06-16T19:27:21.573"
}

Here are the main attributes that are passed by the CHARGE_VOIDED webhook:

Name	Description
dynamicQrCodeExpiresInDefault	The default expiration time, in seconds, for the dynamic QR Code.
id	The unique identifier of the charge.
bankAccount	The Delfinance bank account number associated with the charge.
correlationId	A unique identifier used to track the charge.
type	The charge type, such as BANKSLIP_PIX.
amount	The charge amount.
dueDate	The charge due date.
dueDateBrazil	The charge due date in Brazilian time.
status	The current charge status, such as Voided.
payers	A list containing payer information.
payers.id	The payer identifier.
payers.chargeId	The charge identifier associated with the payer.
payers.type	The payer type.
payers.name	The payer name.
payers.document	The payer document number.
payers.email	The payer email address.
payers.dialCode	The payer phone dial code.
payers.phoneNumber	The payer phone number.
payers.address	An object containing the payer address information.
pix	An object containing Pix information for the charge.
pix.identifier	The Pix charge identifier.
pix.qrCode	The Pix QR Code payload.
pix.additionalInfo	Additional information related to the Pix charge.
bankslip	An object containing bankslip information for the charge.
bankslip.walletNumber	The wallet number.
bankslip.yourNumber	The customer's internal identifier for the bankslip.
bankslip.ourNumber	The bank identifier for the bankslip.
bankslip.barCode	The bankslip barcode.
bankslip.digitableLine	The bankslip digitable line.
beneficiary	An object containing beneficiary information.
fees	A list containing fee information, when available.
payments	A list containing payment information, when available.
formatResponse	The response format configured for the charge.
isBankslipType	Indicates whether the charge is a bankslip type.
hasPaymentSourceSiloc	Indicates whether the charge has a Siloc payment source.
events	A list containing events related to the charge.
events.eventType	The event recorded for the charge, such as VOIDED.
events.sourceType	The source that generated the event.
providerStatus	The status returned by the provider.
writtenOffAt	The timestamp indicating when the charge was written off.
updatedAt	The timestamp indicating when the charge was last updated.
createdAt	The timestamp indicating when the charge was created.