冪等性キーは、同じ意味の API リクエストを安全に再試行するための識別子 です。
通信タイムアウトや 5xx のあとに同じ POST を再送しても、二重作成や二重課金を防ぎやすくなります。
ただし、これは API レベルの安全装置であり、業務上の一意性は内部注文 ID で別に持つ必要があります。
決済 API の再試行で二重作成を防ぐ冪等性キーの役割と、内部注文 ID との違いを短く整理します。
冪等性キーは、同じ意味の API リクエストを安全に再試行するための識別子 です。
通信タイムアウトや 5xx のあとに同じ POST を再送しても、二重作成や二重課金を防ぎやすくなります。
ただし、これは API レベルの安全装置であり、業務上の一意性は内部注文 ID で別に持つ必要があります。