BillingKeyRecord — @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 { BillingKeyRecord } from '@gj-kit/toss-payments/server';

Signature, parameters, and return type

/**
 * 영속화 경계 — 여기서만 raw 쌍(customerKey + billingKey)이 보인다.
 *
 * ⚠ 토스의 빌링 보안 모델은 이 쌍의 분리에 의존한다("빌링키가 노출되어도 매핑된
 * customerKey를 모른다면 결제가 불가능합니다" — 빌링 가이드). billingKey와
 * customerKey를 같은 로그에 함께 남기지 말 것.
 */
interface BillingKeyRecord {
    readonly customerKey: string;
    readonly billingKey: string;
    /** 응답 원문 한글 리터럴 — 요청 enum(CARD/TRANSFER)과 비대칭. */
    readonly method: '카드' | '계좌이체';
    /** 발급 응답의 authenticatedAt. */
    readonly issuedAt: string;
    readonly card: {
        readonly issuerCode: string;
        readonly number: string;
        readonly cardType: '신용' | '체크' | '기프트' | '미확인';
        readonly ownerType: '개인' | '법인' | '미확인';
    } | null;
    /** 퀵계좌이체 발급 — 배열이다(응답 원문 구조). */
    readonly transfers: readonly {
        readonly bankName: string;
        readonly bankAccountNumber: string;
    }[] | null;
}

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