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"
}
Webhooks
Cadastrar webhook
Registre uma URL para receber notificações de um tipo de evento específico.
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
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_REJECTEDstring
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"
}