> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.bilion.com.br/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Eventos de webhook

São dez eventos que a Bilion dispara. Você escolhe quais quer receber em cada
webhook.

| Evento | Quando dispara |
|---|---|
| `order_approved` | Pagamento aprovado |
| `order_rejected` | Pagamento recusado |
| `billet_created` | Boleto gerado |
| `pix_created` | Pix gerado |
| `order_refunded` | Venda reembolsada |
| `chargeback` | Compra contestada no banco emissor |
| `subscription_renewed` | Assinatura renovada com sucesso |
| `subscription_late` | Assinatura em atraso |
| `subscription_canceled` | Assinatura cancelada |
| `cart_abandoned` | Carrinho abandonado |

![Cadastro de webhook, com a URL de destino e os eventos](https://bucket-bilion-producao.s3.us-east-2.amazonaws.com/uploads/central-ajuda/webhook-eventos.png)

## Quais escolher

**Para liberar acesso em sistema externo:** `order_approved` e
`order_refunded`. O segundo é tão importante quanto o primeiro, senão você
libera e nunca revoga.

**Para recuperação de venda:** `billet_created`, `pix_created` e
`cart_abandoned`. São os três momentos em que a pessoa demonstrou intenção e não
concluiu.

**Para gestão de assinatura:** `subscription_late` avisa antes de perder o
cliente, `subscription_canceled` e `subscription_renewed` mantêm sua base
sincronizada.

**Cuidado ao marcar todos.** Cada evento vira uma chamada no seu sistema.
Assinar tudo sem tratar tudo gera ruído e mascara falha real.

## Reembolso e chargeback são eventos diferentes

`order_refunded` é a devolução combinada, pela Bilion. `chargeback` é a
contestação feita no banco. Se o seu sistema revoga acesso, precisa tratar os
dois.

## Artigos relacionados

- [Configurar um webhook](https://ajuda.bilion.com.br/pt-br/article/configurar-um-webhook-cknypz/)
- [Testar e depurar seu webhook](https://ajuda.bilion.com.br/pt-br/article/testar-e-depurar-seu-webhook-shcg57/)