編號與內容版本一起記錄
Stripe 文件按 API 版本說明行為,當中 API v1 有參數比較及編號保存規則。指令證據要記實際目標的 API 系列、版本及冪等要求;不能把某個版本的保障套用到其他 API。以下只示範本地記錄。
| 指令 | 冪等編號 | 內容 | 處理決定 |
|---|---|---|---|
| 原預留 | CMD-41 | item=A,quantity=2 | 發送前保存 |
| 結果未明後重試 | CMD-41 | item=A,quantity=2 | 同一決定沿用編號 |
| 已批准改數量 | 先核實原結果,再建立新指令 | item=A,quantity=3 | 不以 CMD-41 送出不同參數 |
過了保存界線不能當作仍有保障
保存內容指紋及受控指令結果參考。重試時若已超出目標保存冪等編號的界線,先查原操作結果,再考慮提交。換新編號避開衝突,可能多做一次操作。
舊編號回覆參數不符,客戶端應自動換新編號嗎?
查看參考答案
不應。先查是否決定有改,還是重試內容被改壞。核實原結果後,真有改動才另行批准指令。