幂等性请求
Token Charge(令牌扣款)支持幂等性,因此在超时或网络连接错误后您可以重试扣款,而不会对银行卡重复扣款。
在每次逻辑扣款尝试中发送唯一的 Idempotency-Key(每个预期的账单使用一个 Key,而不是每次 HTTP 重试使用一个 Key)。如果首次 HTTP 调用超时,请使用相同的 Key 重复发送相同的 JSON 请求体。Coda 将返回原始处理结果,而不是创建第二次扣款。
Init(初始化)、Inquiry(查询)以及 Webhook 不在此请求头的作用范围内。
安全重试的工作原理
生成 Key
Key 由您生成。Coda 仅使用它来识别该次尝试的重试操作。
推荐做法 (Do)
禁止做法 (Do not)
使用 UUID v4(或其他高熵随机字符串)
在不同的计费周期、用户或金额之间复用 Key
为每次新的逻辑扣款创建新的 Key
使用电子邮箱、买家 ID、卡号 (PAN) 或其他个人数据作为 Key
持久化保存该 Key 与对应尝试的关联,直到获取确定结果(HTTP 响应、完整通知或查询结果)
如果您可能在 24 小时后复用 orderId,切勿仅基于 orderId 生成 Key
作用域: 在您的账户中,一个 Idempotency-Key 仅映射一次 Token Charge 尝试。如果出现冲突,应视其为 Key 生成逻辑中的 Bug。
最后更新于
这有帮助吗?