Webhooks são o método principal para receber atualizações da nossa API. Eles recebem a mais alta prioridade, garantindo que as atualizações sejam entregues a eles primeiro. Portanto, é crucial configurar corretamente seus webhooks para garantir que você receba atualizações prontamente e de forma confiável. Recomendamos que para configuração do webhook no ambiente de homologação, que não seja usada uma das chaves de API públicas, pois dificulta a configuração uma vez que qualquer usuário pode usa-las
Configuração Webhooks
Requisição
POST 'https://apisandbox.delbank.com.br/baas/api/v1/webhooks'
Cabeçalhos (Headers)
| Nome | Descrição |
|---|---|
| x-delbank-api-key | Obrigatório. Chave de API |
Corpo da requisição (Body)
| Nome | Tipo | Descrição |
|---|---|---|
| eventType | enum | Obrigatório. Tipo de evento a ser monitorado/ouvinte |
| url | string | Obrigatório. URL da API do sistema cliente que irá receber as informações do webhook |
| authorizationScheme | enum | Tipo de autorização que deve ser utilizado durante a execução da chamada do endpoint (conforme o campo url). Domínios:- BASIC- BEARER- HEADER |
| authorization | string | Informação que será enviada no header da requisição ao endpoint |
Exemplo básico
Configurando Webhook com Authentication Basic
{
"eventType": "PIX_RECEIVED",
"url": "https://example.com.br/webhooks/v1/bankslips",
"authorization": "bG9naW46cGFzc3dvcmQ=",
"authorizationScheme": "BASIC"
}
Configurando Webhook com Authentication Bearer
{
"eventType": "PIX_RECEIVED",
"url": "https://example.com.br/webhooks/v1/bankslips",
"authorization": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"authorizationScheme": "BEARER"
}
Configurando Webhook com Authentication customizada
{
"eventType": "PIX_RECEIVED",
"url": "https://example.com.br/webhooks/v1/bankslips",
"authorization": "x-webhook-key: yourKey",
"authorizationScheme": "HEADER"
}
Manutenção das configurações
| endpoint | método http | descrição |
|---|---|---|
| https://apisandbox.delbank.com.br/baas/api/v1/webhooks | GET | Busca todos os webhook cadastrados da chave de API usada na requisição. |
| https://apisandbox.delbank.com.br/baas/api/v1/webhooks/{ID} | GET | Buscar webhook por ID |
| https://apisandbox.delbank.com.br/baas/api/v1/webhooks/{ID} | PATCH | Atualização do webhook por ID (utilizar o mesmo payload do cadastro de webhook) |
| https://apisandbox.delbank.com.br/baas/api/v1/webhooks/{ID} | DELETE | Remoção do Webhook por ID |
Tipos de Eventos
A seguir, uma relação entre os tipos de evento e seu significado.
| Nome | Descrição |
|---|---|
| CHARGE_PAID | Cobrança paga. |
| PIX_RECEIVED | Pix recebido. (Novo fluxo para o webhook para pegar somente recebimento de pix) |
| PIX_PAYMENT_UPDATED | Atualização de situação de Pagamento Pix |
| PIX_REFUNDED | Evento para reembolsos recebidos |
| PIX_REFUND_PAYMENT_UPDATED | Evento para reembolsos enviados |
| WHITELABEL_CUSTOMER_DOCUMENTATION_REJECTED | Documentos rejeitados para uma nova conta criada |
| WHITELABEL_CUSTOMER_APPROVED | Cliente aprovado e conta bancária criada |