Subotiz 的 Webhooks 用于将系统中的关键事件以实时通知的方式发送至商户服务器，帮助商户在支付、订阅及交易状态发生变化时，及时同步数据并自动触发后端业务逻辑。该机制适用于系统集成、状态同步与自动化处理等场景，是 API 集成的重要组成部分。
Webhooks 的作用说明
Webhooks 通过 服务器到服务器（server-to-server） 的方式，将事件数据主动推送至商户配置的端点 URL，无需商户轮询接口即可获取最新状态变化。
常见使用场景包括：
- 支付成功或失败后的状态同步
- 订阅创建、更新或终止时的系统联动
- 订单或账单状态变更的自动处理
- 内部系统、CRM 或数据平台的实时更新
Webhooks 仅用于后台事件通知，不涉及客户页面跳转或前端展示。
Webhooks 与跳转 URL 的区别
为避免概念混淆，Webhooks 与 跳转 URL（支付成功跳转 URL / 取消支付跳转 URL） 的职责如下：
- Webhooks：用于后台系统接收事件通知，适用于业务逻辑处理与数据同步。
- 跳转 URL：用于控制客户在支付流程中的页面跳转，仅影响用户体验，不参与交易确认。
两者服务于不同层级，需分别配置与使用。
Webhooks 状态说明
每个 Webhook 端点均可单独控制其生效状态：
- 激活：系统将在事件触发时向该端点推送通知。
- 冻结：暂停向该端点发送任何事件通知，但配置将被保留。
该设计便于商户在调试、维护或系统异常期间灵活控制通知行为。
Webhooks 管理入口
进入 Webhooks 页面：前往 开发者 > Webhooks，查看当前已配置的端点列表。
页面将展示以下信息：
- 端点 URL
- 状态（激活 / 冻结）
- 已订阅的事件数量
Webhooks 是 Subotiz 提供的核心事件通知机制，用于在后台实时同步支付、订阅与交易状态。通过合理配置Webhooks，商户可实现系统间的自动联动，减少人工干预，并提升整体交易处理效率与稳定性。