Subotiz 的 Webhook 配置用于接收实时支付通知（如支付成功或失败），是启用 支付链接分享、订阅计费 及事件追踪的必要前提。
在为支付链接配置 Webhook 之前，建议先了解 Webhook 的基本概念及创建方式：
访问 Webhook 配置页面
- 进入 Subotiz 后台，前往 开发者 > Webhooks。
- 点击 创建Webhook。
完成基础配置
-
输入 Endpoint URL： 填写用于接收 Webhook 通知的 HTTPS 地址。
- 示例:
https://your-domain.com/webhook - 如暂无 Endpoint URL，请参考下方 Webhook 配置方式。
-
添加描述：填写用于识别该 Webhook 的名称。
- 示例：
支付链接通知
Webhook 配置方式
根据实际情况选择合适的配置方式：
- 使用开发支持：由技术人员搭建后端接口（Endpoint）以接收 Webhook 事件。
- 使用第三方工具：通过自动化工具（如 Zapier、Make）生成 Webhook URL，无需自行开发后端服务。
选择事件类型
为启用分享支付链接，仅需选择最基础的事件即可。
-
必选（推荐所有商户）
- 支付成功：
v2.trades.succeeded
-
可选（按业务需求）
- 支付失败：
v2.trades.payment_failed - 订阅创建：
v2.subscription.first - 订阅取消：
v2.subscription.canceled
选择建议
- 一次性商品: 仅选择支付成功。
- 订阅商品: 支付成功，并添加订阅相关事件。
启用 Webhook
- 点击 创建并激活。
- 确认 Webhook 状态显示为 激活。
配置要求与限制
- Webhook 配置必须提供可接收请求的 HTTPS 接口，通常需要后端服务或第三方工具支持。
- 未配置或未启用 Webhook 时，无法使用 分享支付链接 功能。
Webhook 配置是启用 Subotiz 支付链接分享功能的必要步骤。通过配置有效的接收地址并选择所需事件，商户可实现支付结果的实时接收与订阅业务的正常运行。