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

# Webhook 设置

> 在 UQPAY 商户后台配置 Webhook 端点，接收实时事件通知。

## 设置 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 概览](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/guide/webhooks-overview.md)。

## 查看或重新触发历史 Webhook

你可以在商户后台查看历史投递并重新发送：

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

## 编辑或删除 Webhook

在 **Summary** 标签页打开行操作菜单，可以编辑端点、发送测试事件、轮换签名密钥或删除 Webhook。

> [!WARNING]
>
> 轮换签名密钥会立即使当前密钥失效。后续投递前，请先在接收服务中更新为新密钥。

## 相关内容

签名验证、重试逻辑和最佳实践参见 [Webhook 概览](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/guide/webhooks-overview.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.