オンライン決済実装研究所
用語集

冪等性キー

決済 API の再試行で二重作成を防ぐ冪等性キーの役割と、内部注文 ID との違いを短く整理します。

冪等性キーは、同じ意味の API リクエストを安全に再試行するための識別子 です。

通信タイムアウトや 5xx のあとに同じ POST を再送しても、二重作成や二重課金を防ぎやすくなります。
ただし、これは API レベルの安全装置であり、業務上の一意性は内部注文 ID で別に持つ必要があります。