Skip to content

BillingProfile — @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.

import { BillingProfile } from '@gj-kit/toss-payments/server';
/**
* billingKey는 공개 필드·JSON 직렬화·열거 어디에도 노출되지 않는다(비공개 심볼, 비열거).
* WeakMap이 아니므로 일반 전달은 안전하지만, 스프레드/직렬화 복제본은 approve에서
* 명시적 Err('profile-detached') — billing.load()로 재수화하라.
*/
interface BillingProfile extends Brand<'BillingProfile'> {
readonly customerKey: CustomerKey;
readonly method: '카드' | '계좌이체';
/** "433012******890" — 표시용. */
readonly maskedSource: string;
readonly issuedAt: string;
}

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.

  • Package: @gj-kit/toss-payments
  • Version: 0.6.1
  • Public entry: ./server
  • Source: GitHub