BillingAuthRequest — @gj-kit/toss-payments

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

Verified import example

import { BillingAuthRequest } from '@gj-kit/toss-payments/browser';

Signature, parameters, and return type

/**
 * 빌링 등록 인증창 — SDK payment({customerKey}).requestBillingAuth 래퍼.
 *
 * 빌링은 API 개별 키(ck) 전용 — 위젯 키(gck)는 컴파일 에러.
 * customer는 WidgetCustomerKey만 — ANONYMOUS는 파라미터 타입에서 배제된다
 * (빌링은 고유 customerKey 전제, SDK 문서에 ANONYMOUS 빌링 언급 없음 — 연구문서 §빌링).
 */
/**
 * SDK v2.7.1 타입 정의로 확정(Phase 0): method 'CARD' | 'TRANSFER' 판별 유니언.
 * selectableCardTypes는 CARD 전용 — TRANSFER 쪽은 `?: never`로 변수 경유 전달까지 차단한다.
 */
type BillingAuthRequest = {
    readonly method: 'CARD';
    /** origin을 포함한 완전 URL — 성공 시 쿼리로 authKey, customerKey가 붙는다. */
    readonly successUrl: string;
    readonly failUrl: string;
    readonly customerName?: string;
    readonly customerEmail?: string;
    readonly windowTarget?: 'self' | 'iframe';
    /** 결제화면에 노출할 카드 타입 — 입력 순서대로 노출, 첫 항목이 기본 선택. */
    readonly selectableCardTypes?: readonly ('PERSONAL' | 'CORPORATE')[];
} | {
    readonly method: 'TRANSFER';
    readonly successUrl: string;
    readonly failUrl: string;
    readonly customerName?: string;
    readonly customerEmail?: string;
    readonly windowTarget?: 'self' | 'iframe';
    /** 카드 전용 파라미터 (SDK v2.7.1 타입 정합) — TRANSFER에서는 존재 자체가 컴파일 에러. */
    readonly selectableCardTypes?: never;
};

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: ./browser
• Source: GitHub