跳至正文
EN
VezAPI Docs

回调与幂等

创建任务时传入公网 HTTPS callBackUrl。VezAPI 核实任务状态和账务后再转发客户响应。回调地址不能指向私有网络,也不能依赖重定向。

回调验签

在「控制台 → 设置」获取账号回调验签密钥。使用 HMAC-SHA256 对 timestamp.eventId.rawBody 签名,与 X-VezAPI-Signature 比较;校验 X-VezAPI-Timestamp 在五分钟内,并按 X-VezAPI-Event-Id 去重。

重试与生成幂等

每笔提交使用唯一 Idempotency-Key。以相同密钥和请求内容重复访问时返回原提交状态;同一密钥对应不同内容会返回冲突。回调重试和队列重复投递不会发起新的生成。