wbhk
Event
事件 Webhook 端点
此端点用于接收系统中各类事件的 Webhook 通知。
支持的事件类型
更多信息，请参阅 API 通知文档
安全说明
- 所有 Webhook 负载均包含
resource字段，该字段包含 JSON 格式数据 - 请使用
resource字段验证 Webhook 签名 - 确保你的端点返回 HTTP 200 状态码，并响应
{"received":true}
重试策略
- 失败的 Webhook 最多会重试 16 次
- 重试间隔：10 秒、30 秒、1 分钟、2 分钟等
- 持续失败的 Webhook 将被标记为失败状态
最佳实践
- 幂等性：使用
requestId确保重复事件被正确处理 - 快速响应：在 5 秒内响应以避免超时
- 数据验证：处理前务必验证事件负载的有效性
- 错误处理：针对不同场景返回合适的 HTTP 状态码
重要提示：接收方系统必须具备处理重复通知的能力。若未实现该处理机制，商户需自行承担因重复通知导致的所有财务风险（如重复入账等）。