Skip to content

CancelRetryTicket — @gj-kit/toss-payments

A public interface from @gj-kit/toss-payments/server. The signature below is taken directly from the 0.6.1 release declaration.

import { CancelRetryTicket } from '@gj-kit/toss-payments/server';
/**
* transport 실패 시 발급되는 불투명 재시도 티켓. 같은 프로세스에서는 비열거 봉인을,
* 재시작 뒤에는 CancelRetryStore의 암호화 record를 사용해 동일 멱등키+body를 복원한다.
* issuedAt 기준 `DEFAULT_IDEMPOTENCY_REPLAY_WINDOW_MS`(14일 — provider TTL 15일에서 하루 여유)가
* 지난 티켓은 새 요청으로 실행될 위험이 있어 로컬에서 `retry-ticket-expired`로 거부한다.
*/
interface CancelRetryTicket extends Brand<'CancelRetryTicket'> {
readonly ticketId: string;
readonly paymentKey: PaymentKey;
readonly idempotencyKey: IdempotencyKey;
readonly issuedAt: string;
/** true면 네트워크 요청 전에 주입된 CancelRetryStore에 요청 바이트가 저장된 상태. */
readonly durable: boolean;
}

This declaration is the source of truth for parameters, optionality, generics, return values, and public union/type contracts. Check the package golden path and this subpath’s import conditions for required environment, permission, and error boundaries before calling it.

  • Package: @gj-kit/toss-payments
  • Version: 0.6.1
  • Public entry: ./server
  • Source: GitHub