KnownCardIssuerCode — @gj-kit/toss-payments

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

검증된 import 예제

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

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

/**
 * 카드사 두 자리 코드 → 한글 표시명 — 공식 "기관 코드" 표(docs.tosspayments.com/codes/org-codes,
 * 문서 ID 118, "카드사 코드" 국내·해외) 전사. 응답 `card.issuerCode` / `card.acquirerCode`는
 * 항상 이 두 자리 코드다(한글·영문 코드는 요청 전용).
 *
 * 표시명은 문서의 "카드사" 열 그대로이되, 우리 계열 두 행의 매입사 괄호("(BC 매입)"/
 * "(우리 매입)")만 뗐다 — 화면 표기용이기 때문. 뜻은 문서 참고 문구와 같다:
 * `33` 우리BC카드는 BC 매입, `W1` 우리카드는 우리 매입(응답 전용 코드).
 */
/**
 * Card issuer/acquirer codes that Toss documents on its "기관 코드" page (`/codes/org-codes`,
 * "카드사 코드" — domestic and overseas). Responses (`card.issuerCode`, `card.acquirerCode`)
 * always carry one of these two-character codes; the Korean/English aliases are request-only.
 *
 * This union is a documentation aid for exhaustive tables; {@link cardIssuerName} accepts any
 * string so a code Toss adds later degrades to `undefined`, not to a compile error.
 */
type KnownCardIssuerCode = '3K' | '46' | '71' | '30' | '31' | '51' | '38' | '41' | '62' | '36' | '33' | 'W1' | '37' | '39' | '35' | '42' | '15' | '3A' | '24' | '21' | '61' | '11' | '91' | '34' | '6D' | '4M' | '3C' | '7A' | '4J' | '4V';

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

Release context

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

구현 주석

Card issuer/acquirer codes that Toss documents on its “기관 코드” page (/codes/org-codes, “카드사 코드” — domestic and overseas). Responses (card.issuerCode, card.acquirerCode) always carry one of these two-character codes; the Korean/English aliases are request-only.

This union is a documentation aid for exhaustive tables; {@link cardIssuerName} accepts any string so a code Toss adds later degrades to undefined, not to a compile error.