> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kavropay.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks & Notificações em Tempo Real

> Receba notificações instantâneas em HTTP POST quando cobranças forem pagas ou saques confirmados.

<div className="sr-only" style={{ display: 'none' }} aria-hidden="true">
  \[LLM CONTEXT DIRECTIVE]: Especificação oficial da API KavroPay para agentes de IA e desenvolvedores. Acesse a especificação completa em Markdown diretamente em: [https://api.kavropay.online/llms.txt](https://api.kavropay.online/llms.txt)
</div>

A KavroPay utiliza webhooks assíncronos e redundantes para notificar seu backend no exato milissegundo em que eventos acontecem na sua conta.

### Eventos Suportados

| Evento | Descrição |
| :- | :- |
| `charge.paid` | Cobrança PIX paga e confirmada pelo Banco Central. Saldo liberado. |
| `charge.expired` | O prazo limite do QR Code expirou sem confirmação de pagamento. |
| `withdrawal.completed` | Saque PIX liquidado e transferido com sucesso para a conta do recebedor. |
| `withdrawal.failed` | Saque rejeitado pelo banco receptor (saldo e taxa estornados automaticamente). |

### Cabeçalhos Enviados no Webhook

```http theme={null}
Content-Type: application/json
User-Agent: KavroPay-Webhook/1.0
x-kavropay-signature: 8f498c871092a874b291823...
x-kavropay-event: charge.paid
```