StoredOrder — @gj-kit/toss-payments

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

검증된 import 예제

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

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

/**
 * 저장소 인터페이스 — 검증 플로우가 성립하기 위한 필수 주입 지점.
 *
 * - OrderStore: 금액 비교의 단일 진실 공급원. createOrder가 save를 호출하므로
 *   '저장을 잊는' 실수가 플로우 안에서 불가능해진다.
 * - BillingKeyStore: 토스에 빌링키 조회 API가 없다 — 저장 실패 = 복구 불가.
 */
interface StoredOrder {
    readonly orderId: OrderId;
    /** requestPayment 시점에 고정한 금액 — 단일 진실 공급원. */
    readonly amount: number;
    readonly currency: 'KRW' | 'USD' | 'JPY';
    readonly orderName: string;
    /** ISO 8601. */
    readonly createdAt: string;
}

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

Release context

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

구현 주석

저장소 인터페이스 — 검증 플로우가 성립하기 위한 필수 주입 지점.

• OrderStore: 금액 비교의 단일 진실 공급원. createOrder가 save를 호출하므로 ‘저장을 잊는’ 실수가 플로우 안에서 불가능해진다.
• BillingKeyStore: 토스에 빌링키 조회 API가 없다 — 저장 실패 = 복구 불가.