npm - @tosspayments/tosspayments-sdk - Versions diffs - 2.2.1 → 2.2.3 - Mend

@tosspayments/tosspayments-sdk 2.2.1 → 2.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -3,6 +3,28 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+## [2.2.3](https://github.com/tosspayments/browser-sdk/compare/@tosspayments/tosspayments-sdk@2.2.2...@tosspayments/tosspayments-sdk@2.2.3) (2024-07-17)
+### Bug Fixes
+* **tosspayments-sdk:** loadTossPayments 반환 타입 변경 ([#118](https://github.com/tosspayments/browser-sdk/issues/118)) ([4b16012](https://github.com/tosspayments/browser-sdk/commit/4b1601206ba77856a1fe0c811f01a4a8700a9f53))
+## [2.2.2](https://github.com/tosspayments/browser-sdk/compare/@tosspayments/tosspayments-sdk@2.2.1...@tosspayments/tosspayments-sdk@2.2.2) (2024-07-17)
+### Bug Fixes
+* **tosspayments-sdk:** PI 버전 업 ([#117](https://github.com/tosspayments/browser-sdk/issues/117)) ([bd416a0](https://github.com/tosspayments/browser-sdk/commit/bd416a0b0407e4a3bdc4bec6379ba99f5120c13a))
 ## [2.2.1](https://github.com/tosspayments/browser-sdk/compare/@tosspayments/tosspayments-sdk@2.2.0...@tosspayments/tosspayments-sdk@2.2.1) (2024-07-08)

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@tosspayments/tosspayments-sdk",
   "description": "TossPayments.js Tosspayments SDK.",
-  "version": "2.2.1",
+  "version": "2.2.3",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",
   "types": "types/index.d.ts",
@@ -21,7 +21,7 @@
     "@rollup/plugin-commonjs": "^21.0.1",
     "@rollup/plugin-typescript": "^8.3.0",
     "@tosspayments/sdk-loader": "2.0.1",
-    "@tosspayments/standard-public-interfaces": "2.0.2",
+    "@tosspayments/standard-public-interfaces": "2.0.6",
     "happy-dom": "^14.12.3",
     "prettier": "^2.0.2",
     "rollup": "^2.60.0",
@@ -38,5 +38,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "32f15f03267096258d766409ce4c69f572cd5828"
+  "gitHead": "3033873ff3952ec13030ac054ad91626b0da5a59"
 }

package/types/index.d.ts CHANGED Viewed

@@ -1,12 +1,12 @@
 declare function clearTossPayments(): void;
-interface WidgetSelectedPaymentMethod<CustomPaymentMethodCode = WidgetsPaymentMethodCode> {
+interface WidgetSelectedPaymentMethod {
     /**
      * 구매자가 결제 UI에서 선택한 결제수단입니다. 예를 들어, 신용・체크카드를 선택하면 `CARD` 코드가 응답됩니다. [ENUM 코드](/codes/enum-codes) 및 [기관 코드](/codes/org-codes)를 참고하세요.
      */
-    code: WidgetsPaymentMethodCode | CustomPaymentMethodCode;
+    code: WidgetsPaymentMethodCode;
 }
-type WidgetsPaymentMethodCode = 'CARD' | 'VIRTUAL_ACCOUNT' | 'MOBILE_PHONE' | 'TRANSFER' | 'CULTURE_GIFT_CERTIFICATE' | 'GAME_GIFT_CERTIFICATE' | 'BOOK_GIFT_CERTIFICATE' | 'TOSSPAY' | 'NAVERPAY' | 'SAMSUNGPAY' | 'LPAY' | 'KAKAOPAY' | 'PAYCO' | 'SSG' | 'APPLEPAY' | 'PINPAY' | 'KBPAY' | 'PAYPAL' | 'GCASH' | 'TOUCHNGO' | 'BOOST' | 'BPI' | 'BILLEASE' | 'DANA' | 'ALIPAYHK' | 'TRUEMONEY' | 'RABBIT_LINE_PAY' | 'ALIPAY' | 'SHINHAN' | 'HYUNDAI' | 'SAMSUNG' | 'WOORI' | 'KOOKMIN' | 'LOTTE' | 'NONGHYEOP' | 'HANA' | 'BC' | 'KDBBANK' | 'TOSSBANK' | 'KAKAOBANK' | 'SUHYEOP' | 'JEONBUKBANK' | 'KBANK' | 'POST' | 'SAEMAUL' | 'CITI' | 'SAVINGBANK' | 'JEJUBANK' | 'GWANGJUBANK' | 'SHINHYEOP' | 'JCB' | 'UNIONPAY' | 'MASTER' | 'VISA' | 'DINERS' | 'DISCOVER' | 'IBK_BC' | 'AMEX' | 'TOSS_PAYMENTS' | 'BANKPAY' | 'BRANDPAY' | 'KEYIN';
+type WidgetsPaymentMethodCode = 'CARD' | 'VIRTUAL_ACCOUNT' | 'MOBILE_PHONE' | 'TRANSFER' | 'CULTURE_GIFT_CERTIFICATE' | 'GAME_GIFT_CERTIFICATE' | 'BOOK_GIFT_CERTIFICATE' | 'TOSSPAY' | 'NAVERPAY' | 'SAMSUNGPAY' | 'LPAY' | 'KAKAOPAY' | 'PAYCO' | 'SSG' | 'APPLEPAY' | 'PINPAY' | 'KBPAY' | 'PAYPAL' | 'GCASH' | 'TOUCHNGO' | 'BOOST' | 'BPI' | 'BILLEASE' | 'DANA' | 'ALIPAYHK' | 'TRUEMONEY' | 'RABBIT_LINE_PAY' | 'ALIPAY' | 'SHINHAN' | 'HYUNDAI' | 'SAMSUNG' | 'WOORI' | 'KOOKMIN' | 'LOTTE' | 'NONGHYEOP' | 'HANA' | 'BC' | 'KDBBANK' | 'TOSSBANK' | 'KAKAOBANK' | 'SUHYEOP' | 'JEONBUKBANK' | 'KBANK' | 'POST' | 'SAEMAUL' | 'CITI' | 'SAVINGBANK' | 'JEJUBANK' | 'GWANGJUBANK' | 'SHINHYEOP' | 'JCB' | 'UNIONPAY' | 'MASTER' | 'VISA' | 'DINERS' | 'DISCOVER' | 'IBK_BC' | 'AMEX' | 'TOSS_PAYMENTS' | 'BANKPAY' | 'BRANDPAY' | 'KEYIN' | (NonNullable<unknown> & string);
 interface WidgetPaymentMethodWidget {
     /**
@@ -33,7 +33,7 @@ interface WidgetPaymentMethodWidget {
      * @throws {@link PublicError.Widgets.UnknownError} 알 수 없는 오류가 발생한 경우
      */
     on: {
-        (eventName: 'paymentMethodSelect', callback: <CustomPaymentMethodCode>(paymentMethod: WidgetSelectedPaymentMethod<CustomPaymentMethodCode>) => void): void;
+        (eventName: 'paymentMethodSelect', callback: (paymentMethod: WidgetSelectedPaymentMethod) => void): void;
     };
     /**
      * 구매자가 선택한 결제수단을 불러옵니다. [자세히 >](#paymentmethodwidgetgetselectedpaymentmethod)
@@ -45,7 +45,7 @@ interface WidgetPaymentMethodWidget {
      *
      * @throws {@link PublicError.Widgets.UnknownError} 알 수 없는 오류가 발생한 경우
      */
-    getSelectedPaymentMethod: <CustomPaymentMethodCode>() => Promise<WidgetSelectedPaymentMethod<CustomPaymentMethodCode>>;
+    getSelectedPaymentMethod: () => Promise<WidgetSelectedPaymentMethod>;
     /**
      * 결제 UI 객체를 제거합니다. [자세히 >](#paymentmethodwidgetdestroy)
      *
@@ -268,7 +268,7 @@ interface WidgetPaymentRequest {
                  */
                 line1?: string;
                 /**
-                 * 상세 주소입니다. 번지 및 동 호수 정보를 입력하세요.
+                 * 상세 주소입니다. 번지 및 동호수 정보를 입력하세요.
                  */
                 line2?: string;
                 /**
@@ -409,7 +409,7 @@ type RenderAgreement = (params: {
      */
     selector: string;
     /**
-     * 렌더링하고 싶은 약과 UI의 `variantKey`입니다. 상점관리자의 결제위젯 어드민에서 확인할 수 있어요.
+     * 렌더링하고 싶은 약관 UI의 `variantKey`입니다. 상점관리자의 결제위젯 어드민에서 확인할 수 있어요.
      */
     variantKey?: string;
 }) => Promise<WidgetAgreementWidget>;
@@ -435,6 +435,7 @@ type RenderAgreement = (params: {
  * @throws {@link PublicError.Widgets.IncorrectFailUrlFormatError} failUrl이 유효하지 않은 경우
  * @throws {@link PublicError.Widgets.PaymentRequestFailError} 결제 요청에 실패한 경우
  * @throws {@link PublicError.Widgets.NotSupportedPromiseError} promise 방식을 지원하지 않는 환경인 경우
+ * @throws {@link PublicError.Widgets.CustomPaymentMethodUnableToPayError} 커스텀 결제수단이 선택된 상태에서 결제요청을 한 경우
  * @throws {@link PublicError.Widgets.InvalidMethodTransactionError} 이미 다른 명령을 수행 중인 경우
  * @throws {@link PublicError.Widgets.InvalidParametersError} 파라미터가 올바르지 않은 경우
  * @throws {@link PublicError.Widgets.UnknownError} 알 수 없는 오류가 발생한 경우
@@ -491,7 +492,7 @@ type RequestPaymentWithRedirection$1 = (paymentRequest: WithRedirection<WidgetPa
 /**
  * 결제 금액을 변경합니다
  *
- * @param {Amount} amount 새로운 결제 금액입니다.
+ * @param {Amount} amount 결제 금액 정보입니다.
  *
  * @example
  *  ```javascript
@@ -850,19 +851,19 @@ interface CardPaymentRequest extends PaymentRequest {
          */
         easyPay?: string;
         /**
-         * 5만원 이상의 신용카드 결제에 적용되는 할부 개월 수입니다.
+         * 신용카드 결제에 적용되는 할부 개월 수입니다.
          * 예를 들어, `6`으로 설정하면 할부 개월 수가 6개월로 고정돼요. 자체창에서는 구매자가 할부 개월 수를 볼 수 없으니 사전에 충분히 안내를 해주세요.
-         * 0(일시불), 2~12 값으로 설정할 수 있고 `maxCardInstallmentPlan` 파라미터와 함께 사용할 수 없어요.
+         * 0(일시불), 2~12 값으로 설정할 수 있고 `maxCardInstallmentPlan` 파라미터와 함께 사용할 수 없어요. 카드사 별로 할부결제가 가능한 [최소 금액](https://pgweb.tosspayments.com/tosspayments/MainPopUp.do)을 확인하세요.
          */
         cardInstallmentPlan?: number;
         /**
-         * 5만원 이상의 신용카드 결제에 적용할 수 있는 최대 할부 개월 수입니다.
-         * 예를 들어, `6`으로 설정하면 구매자는 일시불부터 6개월 할부를 선택할 수 있어요. 0(일시불), 2~12 값으로 설정할 수 있고 `cardInstallmentPlan` 파라미터와 함께 사용할 수 없어요.
+         * 신용카드 결제에 적용할 수 있는 최대 할부 개월 수입니다.
+         * 예를 들어, `6`으로 설정하면 구매자는 일시불부터 6개월 할부를 선택할 수 있어요. 0(일시불), 2~12 값으로 설정할 수 있고 `cardInstallmentPlan` 파라미터와 함께 사용할 수 없어요. 카드사 별로 할부결제가 가능한 [최소 금액](https://pgweb.tosspayments.com/tosspayments/MainPopUp.do)을 확인하세요.
          */
         maxCardInstallmentPlan?: number;
         /**
-         * 5만원 이상의 신용카드 결제에 적용할 수 있는 **상점 부담 무이자** 할부 정보입니다.
-         * 구매자가 선택한 카드, 할부 개월 수가 배열에 등록한 정보와 같다면 무이자가 할부가 자동으로 적용돼요.
+         * 신용카드 결제에 적용할 수 있는 **상점 부담 무이자** 할부 정보입니다.
+         * 구매자가 선택한 카드, 할부 개월 수가 배열에 등록한 정보와 같다면 무이자가 할부가 자동으로 적용돼요. 카드사 별로 할부결제가 가능한 [최소 금액](https://pgweb.tosspayments.com/tosspayments/MainPopUp.do)을 확인하세요.
          */
         freeInstallmentPlans?: Array<{
             /**
@@ -881,7 +882,7 @@ interface CardPaymentRequest extends PaymentRequest {
          */
         useCardPoint?: boolean;
         /**
-         * 앱카드 단독 사용 여부입니다. 'true'로 설정하면 카드사의 앱카드만 열려요. 국민, 농협, 롯데, 삼성, 신한, 우리, 현대 카드 결제에 적용할 수 있어요.
+         * 앱카드 단독 사용 여부입니다. `true`로 설정하면 카드사의 앱카드만 열려요. 국민, 농협, 롯데, 삼성, 신한, 우리, 현대 카드 결제에 적용할 수 있어요.
          */
         useAppCardOnly?: boolean;
         /**
@@ -889,12 +890,12 @@ interface CardPaymentRequest extends PaymentRequest {
          */
         discountCode?: string;
         /**
-         * 시간으로 설정하는 결제가 기한입니다. 설정할 수 있는 최대 값은 2160시간(90일)입니다.
+         * 시간으로 설정하는 결제 기한입니다. 설정할 수 있는 최대 값은 2160시간(90일)입니다.
          * 기한이 지나고 시도하는 결제는 실패해요. 예를 들어 `24`로 설정하면, 결제 요청 시점으로부터 24시간 동안 결제할 수 있어요.
          */
         validHours?: number;
         /**
-         * 특정일로 설정하는 결제 기한입니다. `yyyy-MM-dd'T'HH:mm:ss` ISO 8601 형식입니다.
+         * 특정 날짜로 설정하는 결제 기한입니다. `yyyy-MM-dd'T'HH:mm:ss` ISO 8601 형식입니다.
          * 기한이 지나고 시도하는 결제는 실패해요. 예를 들어 `2025-01-01T00:00:00`으로 설정하면, 2024년 12월 31일 23:59까지 결제할 수 있어요.
          */
         dueDate?: string;
@@ -969,12 +970,12 @@ interface VirtualAccountPaymentRequest extends PaymentRequest {
             quantity?: number;
         }>;
         /**
-         * 시간으로 설정하는 결제가 기한입니다. 설정할 수 있는 최대 값은 2160시간(90일)입니다.
+         * 시간으로 설정하는 결제 기한입니다. 설정할 수 있는 최대 값은 2160시간(90일)입니다.
          * 기한이 지나고 시도하는 결제는 실패해요. 예를 들어 `24`로 설정하면, 결제 요청 시점으로부터 24시간 동안 결제할 수 있어요.
          */
         validHours?: number;
         /**
-         * 특정일로 설정하는 결제 기한입니다. `yyyy-MM-dd'T'HH:mm:ss` ISO 8601 형식입니다.
+         * 특정 날짜로 설정하는 결제 기한입니다. `yyyy-MM-dd'T'HH:mm:ss` ISO 8601 형식입니다.
          * 기한이 지나고 시도하는 결제는 실패해요. 예를 들어 `2025-01-01T00:00:00`으로 설정하면, 2024년 12월 31일 23:59까지 결제할 수 있어요.
          */
         dueDate?: string;
@@ -1035,12 +1036,12 @@ interface TransferPaymentRequest extends PaymentRequest {
             quantity?: number;
         }>;
         /**
-         * 시간으로 설정하는 결제가 기한입니다. 설정할 수 있는 최대 값은 2160시간(90일)입니다.
+         * 시간으로 설정하는 결제 기한입니다. 설정할 수 있는 최대 값은 2160시간(90일)입니다.
          * 기한이 지나고 시도하는 결제는 실패해요. 예를 들어 `24`로 설정하면, 결제 요청 시점으로부터 24시간 동안 결제할 수 있어요.
          */
         validHours?: number;
         /**
-         * 특정일로 설정하는 결제 기한입니다. `yyyy-MM-dd'T'HH:mm:ss` ISO 8601 형식입니다.
+         * 특정 날짜로 설정하는 결제 기한입니다. `yyyy-MM-dd'T'HH:mm:ss` ISO 8601 형식입니다.
          * 기한이 지나고 시도하는 결제는 실패해요. 예를 들어 `2025-01-01T00:00:00`으로 설정하면, 2024년 12월 31일 23:59까지 결제할 수 있어요.
          */
         dueDate?: string;
@@ -1126,7 +1127,7 @@ interface ForeignEasyPayPaymentRequest extends PaymentRequest {
                  */
                 line1?: string;
                 /**
-                 * 상세 주소입니다. 번지 및 동 호수 정보를 입력하세요.
+                 * 상세 주소입니다. 번지 및 동호수 정보를 입력하세요.
                  */
                 line2?: string;
                 /**
@@ -1179,7 +1180,7 @@ interface RequestPaymentResult {
 interface BillingAuthRequest {
     /**
-     * 자동결제(빌링)에 등록할 결제수단입니다. 토스페이먼츠는 현재 신용·체크카드만 자동결제만 지원해요.
+     * 자동결제(빌링)에 등록할 결제수단입니다. 토스페이먼츠 자동결제는 현재 신용·체크카드만 지원해요.
      *
      */
     method: 'CARD';
@@ -1215,18 +1216,18 @@ interface BillingAuthRequest {
 /**
  *
- * @throws {@link PublicError.PaymentGateway.UserCancelError} 사용자가 결제창을 닫은 경우
- * @throws {@link PublicError.PaymentGateway.InvalidAmountValueError} 결제 금액이 유효하지 않은 경우
- * @throws {@link PublicError.PaymentGateway.InvalidAmountCurrencyError} 결제 금액의 통화가 유효하지 않은 경우
- * @throws {@link PublicError.PaymentGateway.BelowZeroAmountError} 결제 금액이 0 미만인 경우
- * @throws {@link PublicError.PaymentGateway.NotSupportedPromiseError} promise 방식을 지원하지 않는 환경인 경우
- * @throws {@link PublicError.PaymentGateway.NotSupportedMethodError} 가맹점에서 정의되지 않은 method를 넘겨준 경우
- * @throws {@link PublicError.PaymentGateway.IncorrectSuccessUrlFormatError} 가맹점에서 유효하지 않은 successUrl을 넘겨준 경우
- * @throws {@link PublicError.PaymentGateway.IncorrectFailUrlFormatError} 가맹점에서 유효하지 않은 failUrl을 넘겨준 경우
- * @throws {@link PublicError.PaymentGateway.PaymentRequestFailError} 결제에 실패한 경우
- * @throws {@link PublicError.PaymentGateway.InvalidMethodTransactionError} 이미 다른 명령을 수행 중인 경우
- * @throws {@link PublicError.PaymentGateway.InvalidParametersError} 파라미터가 올바르지 않은 경우
- * @throws {@link PublicError.PaymentGateway.UnknownError} 알 수 없는 오류가 발생한 경우
+ * @throws {@link PublicError.Payment.UserCancelError} 사용자가 결제창을 닫은 경우
+ * @throws {@link PublicError.Payment.InvalidAmountValueError} 결제 금액이 유효하지 않은 경우
+ * @throws {@link PublicError.Payment.InvalidAmountCurrencyError} 결제 금액의 통화가 유효하지 않은 경우
+ * @throws {@link PublicError.Payment.BelowZeroAmountError} 결제 금액이 0 미만인 경우
+ * @throws {@link PublicError.Payment.NotSupportedPromiseError} promise 방식을 지원하지 않는 환경인 경우
+ * @throws {@link PublicError.Payment.NotSupportedMethodError} 가맹점에서 정의되지 않은 method를 넘겨준 경우
+ * @throws {@link PublicError.Payment.IncorrectSuccessUrlFormatError} 가맹점에서 유효하지 않은 successUrl을 넘겨준 경우
+ * @throws {@link PublicError.Payment.IncorrectFailUrlFormatError} 가맹점에서 유효하지 않은 failUrl을 넘겨준 경우
+ * @throws {@link PublicError.Payment.PaymentRequestFailError} 결제에 실패한 경우
+ * @throws {@link PublicError.Payment.InvalidMethodTransactionError} 이미 다른 명령을 수행 중인 경우
+ * @throws {@link PublicError.Payment.InvalidParametersError} 파라미터가 올바르지 않은 경우
+ * @throws {@link PublicError.Payment.UnknownError} 알 수 없는 오류가 발생한 경우
  */
 type RequestPayment = RequestCardPaymentWithRedirection & RequestCardPaymentWithPromise & RequestVirtualAccountPaymentWithRedirection & RequestVirtualAccountPaymentWithPromise & RequestTransferPaymentWithRedirection & RequestTransferPaymentWithPromise & RequestMobilePhonePaymentWithRedirection & RequestMobilePhonePaymentWithPromise & RequestGiftCertificatePaymentWithRedirection & RequestGiftCertificatePaymentWithPromise & RequestForeignEasyPayPaymentWithRedirection & RequestForeignEasyPayPaymentWithPromise;
 /**
@@ -1629,17 +1630,17 @@ type RequestForeignEasyPayPaymentWithRedirection = (paymentRequest: WithRedirect
  * });
  * ```
  *
- * @throws {@link PublicError.PaymentGateway.UserCancelError} 사용자가 자동결제 인증창을 닫은 경우
- * @throws {@link PublicError.PaymentGateway.NotSupportedMethodError} 가맹점에서 정의되지 않은 method를 넘겨준 경우
- * @throws {@link PublicError.PaymentGateway.IncorrectSuccessUrlFormatError} 가맹점에서 유효하지 않은 successUrl을 넘겨준 경우
- * @throws {@link PublicError.PaymentGateway.IncorrectFailUrlFormatError} 가맹점에서 유효하지 않은 failUrl을 넘겨준 경우
- * @throws {@link PublicError.PaymentGateway.InvalidMethodTransactionError} 이미 다른 명령을 수행 중인 경우
- * @throws {@link PublicError.PaymentGateway.InvalidParametersError} 파라미터가 올바르지 않은 경우
- * @throws {@link PublicError.PaymentGateway.UnknownError} 알 수 없는 오류가 발생한 경우
+ * @throws {@link PublicError.Payment.UserCancelError} 사용자가 자동결제 인증창을 닫은 경우
+ * @throws {@link PublicError.Payment.NotSupportedMethodError} 가맹점에서 정의되지 않은 method를 넘겨준 경우
+ * @throws {@link PublicError.Payment.IncorrectSuccessUrlFormatError} 가맹점에서 유효하지 않은 successUrl을 넘겨준 경우
+ * @throws {@link PublicError.Payment.IncorrectFailUrlFormatError} 가맹점에서 유효하지 않은 failUrl을 넘겨준 경우
+ * @throws {@link PublicError.Payment.InvalidMethodTransactionError} 이미 다른 명령을 수행 중인 경우
+ * @throws {@link PublicError.Payment.InvalidParametersError} 파라미터가 올바르지 않은 경우
+ * @throws {@link PublicError.Payment.UnknownError} 알 수 없는 오류가 발생한 경우
  */
 type RequestBillingAuth = (billingAuthRequest: BillingAuthRequest) => Promise<void>;
-interface TossPaymentsPaymentGateway {
+interface TossPaymentsPayment {
     /**
      * 결제창을 띄웁니다. [자세히 >](#paymentrequestpayment)
      */
@@ -1649,7 +1650,7 @@ interface TossPaymentsPaymentGateway {
      */
     requestBillingAuth: RequestBillingAuth;
 }
-interface TossPaymentsInstance {
+interface TossPaymentsSDK {
     /**
      *
      * 결제위젯을 초기화합니다. [자세히 >](#결제위젯)
@@ -1671,10 +1672,10 @@ interface TossPaymentsInstance {
      * import { ANONYMOUS } from "@tosspayments/tosspayments-sdk";
      * const widgets = tossPayments.widgets({ customerKey: ANONYMOUS });
      * ```
-     * @param {WidgetSDKInitParams} params 결제위젯 초기화 정보입니다.
+     * @param {WidgetInitParams} params 결제위젯 초기화 정보입니다.
      *
      */
-    widgets: (params: WidgetSDKInitParams) => TossPaymentsWidgets;
+    widgets: (params: WidgetInitParams) => TossPaymentsWidgets;
     /**
      * 브랜드페이를 초기화합니다. [자세히 >](#브랜드페이)
      *
@@ -1690,10 +1691,10 @@ interface TossPaymentsInstance {
      * });
      * ```
      * @returns 아래 메서드를 호출할 수 있는 브랜드페이 객체를 반환합니다.
-     * @param {BrandpaySDKInitParams} params 브랜드페이 초기화 정보입니다.
+     * @param {BrandpayInitParams} params 브랜드페이 초기화 정보입니다.
      *
      */
-    brandpay: (params: BrandpaySDKInitParams) => TossPaymentsBrandpay;
+    brandpay: (params: BrandpayInitParams) => TossPaymentsBrandpay;
     /**
      * 결제창을 초기화합니다. [자세히 >](#결제창)
      *
@@ -1705,11 +1706,11 @@ interface TossPaymentsInstance {
      * ```javascript
      * const payment = tossPayments.payment({ customerKey });
      * ```
-     * @param {PaymentGatewaySDKInitParams} params 결제창 초기화 정보입니다.
+     * @param {PaymentInitParams} params 결제창 초기화 정보입니다.
      * @returns 아래 메서드를 호출할 수 있는 결제창 객체를 반환합니다.
      *
      */
-    payment: (params: PaymentGatewaySDKInitParams) => TossPaymentsPaymentGateway;
+    payment: (params: PaymentInitParams) => TossPaymentsPayment;
 }
 /**
  * @example
@@ -1729,8 +1730,8 @@ interface TossPaymentsInstance {
  * @returns
  * 아래 메서드를 호출할 수 있는 토스페이먼츠 객체를 반환합니다.
  */
-type TossPayments = (clientKey: string) => TossPaymentsInstance;
-interface BrandpaySDKInitParams {
+type TossPayments = (clientKey: string) => TossPaymentsSDK;
+interface BrandpayInitParams {
     /**
      * 구매자를 식별하는 고유 아이디입니다.
      * 이메일・전화번호나 자동 증가하는 숫자와 같이 유추가 가능한 값은 안전하지 않아요. UUID와 같이 충분히 무작위적인 고유 값으로 생성해주세요.
@@ -1747,7 +1748,7 @@ interface BrandpaySDKInitParams {
 /**
  * @returns 아래 메서드를 호출할 수 있는 토스페이먼츠 객체를 반환합니다.
  */
-interface WidgetSDKInitParams {
+interface WidgetInitParams {
     /**
      * 구매자를 식별하는 고유 아이디입니다.
      * 이메일・전화번호나 자동 증가하는 숫자와 같이 유추가 가능한 값은 안전하지 않아요. UUID와 같이 충분히 무작위적인 고유 값으로 생성해주세요.
@@ -1766,7 +1767,7 @@ interface WidgetSDKInitParams {
         redirectUrl?: string;
     };
 }
-interface PaymentGatewaySDKInitParams {
+interface PaymentInitParams {
     /**
      * 구매자를 식별하는 고유 아이디입니다.
      * 이메일・전화번호나 자동 증가하는 숫자와 같이 유추가 가능한 값은 안전하지 않아요. UUID와 같이 충분히 무작위적인 고유 값으로 생성해주세요.
@@ -1778,8 +1779,8 @@ interface PaymentGatewaySDKInitParams {
 type TosspaymentsParams = Parameters<TossPayments>;
 declare function loadTossPayments(clientKey: TosspaymentsParams[0], loadOptions?: {
     src?: string;
-}): Promise<TossPaymentsInstance>;
+}): Promise<TossPaymentsSDK>;
 declare const ANONYMOUS = "@@ANONYMOUS";
-export { ANONYMOUS, type WidgetAgreementStatus, type WidgetAgreementWidget, type WidgetPaymentMethodWidget, type WidgetSelectedPaymentMethod, clearTossPayments, loadTossPayments };
+export { ANONYMOUS, type TossPaymentsBrandpay, type TossPaymentsPayment, type TossPaymentsSDK, type TossPaymentsWidgets, type WidgetAgreementStatus, type WidgetAgreementWidget, type WidgetPaymentMethodWidget, type WidgetSelectedPaymentMethod, clearTossPayments, loadTossPayments };