Webhook 概览

Webhook 会在支付状态发生变化的瞬间通知您的服务器。对于您订阅的每个事件，我们都会向您配置的 URL 发送带签名的 HTTP POST 请求。这是确认支付成功、失败或过期的可靠方式。

事件类型

我们会发送以下支付事件：

• SUCCESS — 支付已确认

• FAILED — 支付失败或已取消

• EXPIRED — 支付会话在支付前已过期

• PENDING_REVIEW — 支付需要人工审核

• UTR_SUBMITTED — 客户已提交其交易参考号

单独的 test.ping 事件仅用于验证您的 endpoint，不属于支付订阅列表。

选择接收哪些事件

您的订阅决定哪些事件会发送到您的 endpoint：

• 从未配置 — 您会接收所有支付事件。

• 设置为空列表 — 您不会接收任何事件。

• 设置为特定列表 — 您只会接收这些事件。

投递与重试

每次投递都是一个带有 JSON 请求体的 HTTP POST。投递会在 10 秒后超时。失败的投递会被存储并自动重试，因此您的 endpoint 应具备幂等性——同一事件多次到达时，不会被重复处理。