Skip to main content
GET
/
baas
/
api
/
v1
/
webhooks
curl --request GET \
  --url 'https://apisandbox.delbank.com.br/baas/api/v1/webhooks' \
  --header 'x-delbank-api-key: {{apiKey}}' \
  --header 'x-delfinance-account-id: {{accountId}}'

[
  {
    "id": "wbh_a1b2c3d4",
    "eventType": "PIX_RECEIVED",
    "url": "https://seuservidor.com.br/webhooks/pix",
    "authorizationScheme": "BEARER",
    "createdAt": "2026-07-06T10:00:00Z"
  },
  {
    "id": "wbh_e5f6g7h8",
    "eventType": "CHARGE_PAID",
    "url": "https://seuservidor.com.br/webhooks/boleto",
    "authorizationScheme": "NONE",
    "createdAt": "2026-07-06T10:05:00Z"
  }
]
Para o contexto completo, veja o guia Webhooks.

​
Headers

​
x-delbank-api-key
string
required
Sua API key.
​
x-delfinance-account-id
string
required
Número da conta Delfinance.

​
Response

Retorna um array com os webhooks cadastrados.
​
id
string
ID único do webhook.
​
eventType
string
Tipo de evento monitorado.
​
url
string
URL registrada para receber os eventos.
​
authorizationScheme
string
Esquema de autenticação configurado: NONE, BASIC, BEARER ou HEADER.
​
createdAt
string
Data e hora de criação no formato ISO 8601.
curl --request GET \
  --url 'https://apisandbox.delbank.com.br/baas/api/v1/webhooks' \
  --header 'x-delbank-api-key: {{apiKey}}' \
  --header 'x-delfinance-account-id: {{accountId}}'

[
  {
    "id": "wbh_a1b2c3d4",
    "eventType": "PIX_RECEIVED",
    "url": "https://seuservidor.com.br/webhooks/pix",
    "authorizationScheme": "BEARER",
    "createdAt": "2026-07-06T10:00:00Z"
  },
  {
    "id": "wbh_e5f6g7h8",
    "eventType": "CHARGE_PAID",
    "url": "https://seuservidor.com.br/webhooks/boleto",
    "authorizationScheme": "NONE",
    "createdAt": "2026-07-06T10:05:00Z"
  }
]