TOSS_IDEMPOTENCY_KEY_TTL_MS — @gj-kit/toss-payments

@gj-kit/toss-payments/server에서 공개하는 constant입니다. package version 0.6.1의 release declaration을 그대로 표시합니다.

검증된 import 예제

import { TOSS_IDEMPOTENCY_KEY_TTL_MS } from '@gj-kit/toss-payments/server';

시그니처, 매개변수, 반환 타입

TOSS_IDEMPOTENCY_KEY_TTL_MS: number

이 선언은 매개변수, optionality, 제네릭, 반환값, 공개 union/type 계약의 정본입니다. 호출 전 필요한 환경·권한·오류 경계는 패키지 Golden path와 이 subpath의 import 조건을 함께 확인하세요.

Release context

• 패키지: @gj-kit/toss-payments
• 버전: 0.6.1
• 공개 entry: ./server
• 소스: GitHub

구현 주석

How long Toss binds an Idempotency-Key to its first response: 15 days from first use, in milliseconds.

Source: Toss Payments API reference, “Using the API › Authorization”, Idempotency-Key section (docs.tosspayments.com/reference/using-api/authorization): max 300 characters, valid for 15 days from the first use, applies to every POST. What happens to a key reused after the window is not explicitly documented; treat it as unsafe — the same key may be executed as a brand-new request — so a long-lived retry queue must stop resubmitting with the same key once the window has passed and fall back to a lookup.

Measured against the test environment: 4xx error responses are bound to the key for the same window, so a key that received a definitive 4xx cannot be “fixed” by resending — derive a new attempt instead (see {@link deriveIdempotencyKey}).