Webhook 配置
位置： 设置 → 支付 → Webhook
位置： 设置 → 支付 → Webhook
Webhook 允许 QuantaPay 在支付完成时实时通知您的服务器。
字段
| 字段 | 说明 |
|---|---|
| Webhook URL | 您服务器上的 HTTPS 端点，用于接收支付事件发生时的 POST 请求。必须是可公开访问的 URL。 |
| Webhook Secret Key | 自动生成的密钥，包含在 Webhook JSON 载荷的 key 字段中。用于验证收到的 Webhook 是否确实来自 QuantaPay。 |
设置步骤
- 输入您的 Webhook 端点 URL（例如
https://yoursite.com/webhook/quantapay） - Webhook Secret Key 会自动生成。如需重新生成，点击刷新按钮即可。
- 保存设置。
工作原理
当支付完成（状态为 C）时，QuantaPay 会向您的 Webhook URL 发送 HTTP POST 请求，包含：
- JSON 请求体：
{ "key": "your-secret", "transaction": { ... } } - 验证
key字段是否与您的 Webhook Secret Key 匹配，以确认请求的真实性
完整的 Webhook 载荷格式、签名验证代码和最佳实践，请参阅 API 参考：Webhooks。
测试
测试您的 Webhook：
- 通过 API 创建一个测试结账会话
- 完成一笔小额支付
- 检查您的服务器日志，查看收到的 Webhook 请求
提示：开发阶段可使用 webhook.site 等服务来检查收到的 Webhook 载荷。