Skip to main content
POST
/
baas
/
api
/
v1
/
webhooks
curl --request POST \
  --url 'https://apisandbox.delbank.com.br/baas/api/v1/webhooks' \
  --header 'Content-Type: application/json' \
  --header 'x-delbank-api-key: {{apiKey}}' \
  --header 'x-delfinance-account-id: {{accountId}}' \
  --data '{
    "eventType": "PIX_RECEIVED",
    "url": "https://seuservidor.com.br/webhooks/pix",
    "authorizationScheme": "BEARER",
    "authorization": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}'

curl --request POST \
  --url 'https://apisandbox.delbank.com.br/baas/api/v1/webhooks' \
  --header 'Content-Type: application/json' \
  --header 'x-delbank-api-key: {{apiKey}}' \
  --header 'x-delfinance-account-id: {{accountId}}' \
  --data '{
    "eventType": "CHARGE_PAID",
    "url": "https://seuservidor.com.br/webhooks/boleto",
    "authorizationScheme": "NONE"
}'

{
  "id": "wbh_a1b2c3d4",
  "eventType": "PIX_RECEIVED",
  "url": "https://seuservidor.com.br/webhooks/pix",
  "authorizationScheme": "BEARER",
  "createdAt": "2026-07-06T10:00: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.

​
Body

​
eventType
string
required
Tipo de evento a monitorar. Cada webhook escuta um único tipo de evento.Valores: PIX_RECEIVED, PIX_PAYMENT_UPDATED, PIX_REFUNDED, PIX_REFUND_PAYMENT_UPDATED, CHARGE_PAID, INFRACTION_NOTIFICATION_CREATED, INFRACTION_NOTIFICATION_UPDATED, ACCOUNT_STATUS_UPDATED, WHITELABEL_CUSTOMER_APPROVED, WHITELABEL_CUSTOMER_DOCUMENTATION_REJECTED
​
url
string
required
URL do seu servidor que receberá os eventos via POST. Deve começar com http:// ou https:// e conter um domínio válido.
​
authorizationScheme
string
Esquema de autenticação usado para chamar o seu endpoint. Valores: NONE, BASIC, BEARER, HEADER. Padrão: NONE.
​
authorization
string
Valor enviado no header Authorization da requisição para o seu servidor. Obrigatório quando authorizationScheme não for NONE.

​
Response

​
id
string
ID único do webhook cadastrado.
​
eventType
string
Tipo de evento monitorado.
​
url
string
URL registrada.
​
authorizationScheme
string
Esquema de autenticação configurado.
​
createdAt
string
Data e hora de criação no formato ISO 8601.
curl --request POST \
  --url 'https://apisandbox.delbank.com.br/baas/api/v1/webhooks' \
  --header 'Content-Type: application/json' \
  --header 'x-delbank-api-key: {{apiKey}}' \
  --header 'x-delfinance-account-id: {{accountId}}' \
  --data '{
    "eventType": "PIX_RECEIVED",
    "url": "https://seuservidor.com.br/webhooks/pix",
    "authorizationScheme": "BEARER",
    "authorization": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}'

curl --request POST \
  --url 'https://apisandbox.delbank.com.br/baas/api/v1/webhooks' \
  --header 'Content-Type: application/json' \
  --header 'x-delbank-api-key: {{apiKey}}' \
  --header 'x-delfinance-account-id: {{accountId}}' \
  --data '{
    "eventType": "CHARGE_PAID",
    "url": "https://seuservidor.com.br/webhooks/boleto",
    "authorizationScheme": "NONE"
}'

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