CustomerKey — @gj-kit/toss-payments

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

Verified import example

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

Signature, parameters, and return type

/**
 * 고객 키 — 2–300자, `^[A-Za-z0-9\-_=.@]+$`.
 *
 * Phase 0 실측(2026-08-09): 토스 서버는 사실상 검증하지 않는다 —
 * 301자는 400이 아닌 **500 FAILED_DB_PROCESSING**, `"bad key!"`(공백+허용 외 문자)도 200.
 * 따라서 이 생성자가 실질 방어선이다. "특수문자 최소 1개" 문구는 허용 집합
 * 나열로 확인됐으므로(순수 영숫자 200 통과) 특수문자 필수 검증은 하지 않는다.
 */
type CustomerKey = string & Brand<'CustomerKey'>;

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