Skip to main content

​
设置 Webhook

1

打开 Webhooks

登录商户后台，在侧边栏底部打开 Developers，然后选择 Webhooks。
2

创建 Webhook

在 Summary 标签页选择 Add Webhook。
3

配置端点

填写 Webhook 信息：
  1. 输入接收事件 payload 的 notification URL。
  2. 选择需要订阅的事件类型，或选择 Subscribe to all events。
  3. 选择 Create 保存端点。
  4. 从确认对话框复制签名密钥并安全保存。该密钥只显示一次。
4

将 UQPAY IP 地址加入白名单

为确保生产环境能够收到 Webhook，请将 UQPAY 的 IP 地址加入服务器白名单。完整列表参见 Webhook 概览。

​
查看或重新触发历史 Webhook

你可以在商户后台查看历史投递并重新发送：
  1. 在 Webhooks 页面选择 Events 标签页。
  2. 打开一条投递记录，查看事件 ID、来源 ID、HTTP 状态、尝试次数和请求 payload。
  3. 在事件详情中选择 Re-Trigger 重新发送通知。

​
编辑或删除 Webhook

在 Summary 标签页打开行操作菜单，可以编辑端点、发送测试事件、轮换签名密钥或删除 Webhook。
轮换签名密钥会立即使当前密钥失效。后续投递前，请先在接收服务中更新为新密钥。

​
相关内容

签名验证、重试逻辑和最佳实践参见 Webhook 概览。