CustomerKey — @gj-kit/toss-payments

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

검증된 import 예제

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

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

/**
 * 고객 키 — 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'>;

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

Release context

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

구현 주석

고객 키 — 2–300자, ^[A-Za-z0-9\-_=.@]+$.

Phase 0 실측(2026-08-09): 토스 서버는 사실상 검증하지 않는다 — 301자는 400이 아닌 500 FAILED_DB_PROCESSING, "bad key!"(공백+허용 외 문자)도 200. 따라서 이 생성자가 실질 방어선이다. “특수문자 최소 1개” 문구는 허용 집합 나열로 확인됐으므로(순수 영숫자 200 통과) 특수문자 필수 검증은 하지 않는다.