# Webhook 事件

## 事件类型

| 事件 | 描述 |
|------|------|
| `boleto.created` | Boleto 已创建 |
| `boleto.registered` | Boleto 已在 PCR 登记 |
| `boleto.paid` | Boleto 已付款 |
| `boleto.cancelled` | Boleto 已取消 |
| `settlement.completed` | 清算周期已完成 |
| `settlement.failed` | 清算处理失败 |

## 事件载荷示例

```json
{
  "event": "boleto.paid",
  "timestamp": "2026-02-05T14:30:00Z",
  "data": {
    "boleto_id": "uuid",
    "nosso_numero": "12345",
    "valor_pago": 15000,
    "data_pagamento": "2026-02-05"
  }
}
```