@tosspayments/tosspayments-sdk 2.2.1 → 2.2.4

package/CHANGELOG.md

@@ -3,6 +3,39 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [2.2.4](https://github.com/tosspayments/browser-sdk/compare/@tosspayments/tosspayments-sdk@2.2.3...@tosspayments/tosspayments-sdk@2.2.4) (2024-07-23)
+
+
+### Bug Fixes
+
+* **tosspayments-sdk:** requestPayment 의 타입이 정상적으로 추론되지 않는 버그 수정 ([#119](https://github.com/tosspayments/browser-sdk/issues/119)) ([6d42b8c](https://github.com/tosspayments/browser-sdk/commit/6d42b8cc26f10a73bb001a64c7483faed4cf7948))
+
+
+
+
+
+## [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

@@ -1,7 +1,7 @@
 {
   "name": "@tosspayments/tosspayments-sdk",
   "description": "TossPayments.js Tosspayments SDK.",
-  "version": "2.2.1",
+  "version": "2.2.4",
   "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.7",
     "happy-dom": "^14.12.3",
     "prettier": "^2.0.2",
     "rollup": "^2.60.0",
@@ -38,5 +38,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "32f15f03267096258d766409ce4c69f572cd5828"
+  "gitHead": "e9ddfc2f54498c25c9c7ffa621e933ab26fc3a8c"
 }

package/types/index.d.ts

@@ -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,11 +435,12 @@ 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} 알 수 없는 오류가 발생한 경우
  */
-type RequestPayment$2 = RequestPaymentWithRedirection$1 & RequestPaymentWithPromise$1;
+type RequestPayment$2 = RequestPaymentWithPromise$1 & RequestPaymentWithRedirection$1;
 /**
  * @docsAlias Promise 방식
  * @returns `WidgetPaymentResult` 객체가 응답됩니다. 객체 필드를 확인하고 [결제 승인 API](/reference#결제-승인)를 호출해야 결제가 최종적으로 완료돼요.
@@ -491,7 +492,7 @@ type RequestPaymentWithRedirection$1 = (paymentRequest: WithRedirection<WidgetPa
 /**
  * 결제 금액을 변경합니다
  *
- * @param {Amount} amount 새로운 결제 금액입니다.
+ * @param {Amount} amount 결제 금액 정보입니다.
  *
  * @example
  *  ```javascript
@@ -594,7 +595,7 @@ interface BrandpayRequestPaymentResult {
  * @throws {@link PublicError.Brandpay.InvalidParametersError} 파라미터가 올바르지 않은 경우
  * @throws {@link PublicError.Brandpay.UnknownError} 알 수 없는 오류가 발생한 경우
  */
-type RequestPayment$1 = RequestPaymentWithRedirection & RequestPaymentWithPromise;
+type RequestPayment$1 = RequestPaymentWithPromise & RequestPaymentWithRedirection;
 /**
  * @docsAlias Redirect 방식
  * @returns 결제 요청이 성공하면 파라미터로 설정한 `successUrl`로 이동해요. 쿼리 파라미터의 `amount` 값이 메서드 파라미터로 설정한 `amount`와 같은지 반드시 확인하고 [브랜드페이 결제 승인 API](/reference/brandpay#결제-승인)를 호출해서 결제를 완료하세요.
@@ -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 };