멱등성과 재시도
두 단계의 멱등성으로 시간 초과 후에도 결제, 환불 또는 부작용을 중복 생성하지 않고 재시도할 수 있습니다.
핵심 사항
- 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"
}