Webhook V2 是推荐的 Webhook 格式。它采用统一信封结构,所有事件共享相同的 { event, timestamp, data } 格式,使 Webhook 的解析和处理更加一致。
包含内容
V2 Webhook 涵盖 5 种事件类型:
| 事件 | 描述 |
|---|---|
payment.v2.completed |
付款成功完成 |
disbursement.v2.completed |
出款成功完成 |
disbursement.v2.fail |
出款失败 |
disbursement.v2.expired |
出款过期 |
transaction_settlement.settled |
结算完成 |
完整详情请参阅 Webhook V2 文档。
V2 与 V1 Webhook 的区别
V1 和 V2 Webhook 可并行运行——迁移期间您可以同时订阅两个版本。新集成应仅使用 V2 Webhook。
详情请参阅 V1 → V2 迁移指南。