幂等性 - Waffo Documentation

幂等性确保当同一个请求被执行多次时，其结果与仅执行一次相同。在支付场景中，这可以防止因网络超时触发重试而导致的重复扣款。

幂等键

Waffo 使用 paymentRequestId（支付）和 subscriptionRequest（订阅）作为幂等键。

规则

最大长度：32 个字符
每个新请求必须生成唯一值
必须在发送请求之前持久化到数据库
重试时，复用原始幂等键；不要生成新的

模式

// 1. 生成不超过 32 字符的唯一幂等键
const paymentRequestId = generateUniqueRequestId();

// 2. Persist (before sending the request!)
await db.order.create({ paymentRequestId, status: 'PENDING' });

// 3. Send the request
try {
  const response = await waffo.order().create({ paymentRequestId, ... });
} catch (e) {
  if (e instanceof WaffoUnknownStatusException) {
    // 4. Unknown status: inquire, do not retry create
    const inquiry = await waffo.order().inquiry({ paymentRequestId });
  }
}

常见错误