Cadastrar webhook

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"
}

POST

baas

api

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

string

required

Sua API key.

string

required

Número da conta Delfinance.

Body

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

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.

string

Esquema de autenticação usado para chamar o seu endpoint. Valores: NONE, BASIC, BEARER, HEADER. Padrão: NONE.

string

Valor enviado no header Authorization da requisição para o seu servidor. Obrigatório quando authorizationScheme não for NONE.

Response

string

ID único do webhook cadastrado.

string

Tipo de evento monitorado.

string

URL registrada.

string

Esquema de autenticação configurado.

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"
}

Introdução

Pix

Boleto

Split de Pagamentos

Webhooks

Headers

Body

Response

​Headers

​Body

​Response

Headers

Body

Response