CallOptions — @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.

Verified import example

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

Signature, parameters, and return type

interface CallOptions<E extends Env> {
    /**
     * ≤300자, POST 전용. 처음 사용일부터 15일 유효 — TTL 초과 후 재사용하면 새 요청으로
     * 실행될 수 있다(문서는 기간만 명시 — 안전하지 않은 것으로 취급). 멱등 판정 조합은 "키 + API 키 + 주소 + 메서드"이며 body는 포함되지
     * 않는다(문서 명시) — 키 재사용 시 body 동일성은 호출자(또는 재시도 티켓)가 보장해야 한다.
     */
    readonly idempotencyKey?: IdempotencyKey;
    /**
     * TossPayments-Test-Code 헤더 — 에러 시나리오 시뮬레이션.
     * 라이브 키에선 서버가 조용히 무시하는 함정 → 타입으로 차단.
     * ⚠ 비분배 조건부 — 미내로잉 union 키(E = Env)도 never다.
     */
    readonly testCode?: [
        E
    ] extends [
        'test'
    ] ? string : never;
    readonly signal?: AbortSignal;
}

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.

Release context

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