冪等性と再試行
二段階の冪等性により、タイムアウト後も注文、返金、副作用を重複させずに再試行できます。
重要なポイント
- out_trade_no と out_refund_no は注文と返金を恒久的に一意化します。
- Idempotency-Key はすべての書き込み API で 24 時間有効です。同じキーに異なる本文を使うとエラーになります。
- 2xx と確定した 4xx は再生され、5xx はキャッシュされません。Webhook の処理はイベント ID で別途重複排除します。
例
json
{
"out_trade_no": "ORDER_20260921_0001",
"amount": 2990,
"currency": "USD"
}