回调与幂等
创建任务时传入公网 HTTPS callBackUrl。VezAPI 核实任务状态和账务后再转发客户响应。回调地址不能指向私有网络,也不能依赖重定向。
回调验签
在「控制台 → 设置」获取账号回调验签密钥。使用 HMAC-SHA256 对 timestamp.eventId.rawBody 签名,与 X-VezAPI-Signature 比较;校验 X-VezAPI-Timestamp 在五分钟内,并按 X-VezAPI-Event-Id 去重。
重试与生成幂等
每笔提交使用唯一 Idempotency-Key。以相同密钥和请求内容重复访问时返回原提交状态;同一密钥对应不同内容会返回冲突。回调重试和队列重复投递不会发起新的生成。