Partner Webhooks

Partner Webhook

Partner API 的异步状态通过 webhook 投递。请求 body 为：

{
  "id": "wh_...",
  "event": "order.paid",
  "createdAt": "2026-10-20T00:00:00.000Z",
  "data": {}
}

投递 headers 包括 X-SP-Event、X-SP-Delivery、X-SP-Timestamp；配置回调私钥后还会携带 X-SP-Key-Id 与 X-SP-Signature。验证算法与入站请求签名相同，方法固定为 POST，nonce 等于 delivery ID，签名路径包含 webhook URL 的 path 和 query。

投递是至少一次语义。成功 HTTP 状态为任意 2xx；失败按 30 秒、60 秒、90 秒递增退避，最多六次，随后标记失败。接收端必须按 id 或 X-SP-Delivery 去重、快速返回成功，并把耗时处理放入自己的队列；事件不保证顺序。

当签名无效、事件过期或 payload 无法解析时返回非成功状态；不要根据来源 IP 或显示文本建立信任。订单和服务的最终状态以 Partner API 查询为准。