@tosspayments/tosspayments-sdk 2.3.3 → 2.3.5

package/CHANGELOG.md

@@ -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.3.5](https://github.com/tosspayments/browser-sdk/compare/@tosspayments/tosspayments-sdk@2.3.4...@tosspayments/tosspayments-sdk@2.3.5) (2025-05-16)
+
+
+### Bug Fixes
+
+* **tosspayments-sdk:** @tosspayments/standard-public-interfaces 버전업 ([#131](https://github.com/tosspayments/browser-sdk/issues/131)) ([006451e](https://github.com/tosspayments/browser-sdk/commit/006451e3cb508b851433e11019aa0bc5d2179f16))
+
+
+
+
+
+## [2.3.4](https://github.com/tosspayments/browser-sdk/compare/@tosspayments/tosspayments-sdk@2.3.3...@tosspayments/tosspayments-sdk@2.3.4) (2024-12-12)
+
+
+### Bug Fixes
+
+* **tosspayments-sdk:** @tosspayments/standard-public-interfaces 버전업 ([#130](https://github.com/tosspayments/browser-sdk/issues/130)) ([62069d3](https://github.com/tosspayments/browser-sdk/commit/62069d34a798ef8324fe032f59c59933d5dba0d1))
+
+
+
+
+
 ## [2.3.3](https://github.com/tosspayments/browser-sdk/compare/@tosspayments/tosspayments-sdk@2.3.2...@tosspayments/tosspayments-sdk@2.3.3) (2024-12-09)
 
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tosspayments/tosspayments-sdk",
   "description": "TossPayments.js Tosspayments SDK.",
-  "version": "2.3.3",
+  "version": "2.3.5",
   "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.38",
+    "@tosspayments/standard-public-interfaces": "2.0.51",
     "happy-dom": "^14.12.3",
     "prettier": "^2.0.2",
     "rollup": "^2.60.0",
@@ -38,5 +38,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "f2fa79e499251c03f5886981b8ed8e8fa46f383a"
+  "gitHead": "eb5f441be087a2116a2be35b2ec322ffe956e9ac"
 }

package/types/index.d.ts

@@ -1,11 +1,17 @@
 declare function clearTossPayments(): void;
 
-interface WidgetSelectedPaymentMethod {
+type WidgetSelectedPaymentMethod = {
     /**
      * 구매자가 결제 UI에서 선택한 결제수단입니다. 예를 들어, 신용・체크카드를 선택하면 `CARD` 코드가 응답됩니다. [ENUM 코드](/codes/enum-codes) 및 [기관 코드](/codes/org-codes)를 참고하세요.
      */
-    code: WidgetsPaymentMethodCode;
-}
+    code: Exclude<WidgetsPaymentMethodCode, 'BRANDPAY'>;
+} | {
+    code: 'BRANDPAY';
+    /**
+     * 현재 브랜드페이에서 선택되어 있는 결제수단의 ID입니다.
+     */
+    methodId?: string;
+};
 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 {
@@ -32,9 +38,7 @@ interface WidgetPaymentMethodWidget {
      * @throws {@link PublicError.Widgets.InvalidCallbackParameterError} callback이 유효하지 않은 경우
      * @throws {@link PublicError.Widgets.UnknownError} 알 수 없는 오류가 발생한 경우
      */
-    on: {
-        (eventName: 'paymentMethodSelect', callback: (paymentMethod: WidgetSelectedPaymentMethod) => void): void;
-    };
+    on: (eventName: 'paymentMethodSelect', callback: (paymentMethod: WidgetSelectedPaymentMethod) => void) => void;
     /**
      * 구매자가 선택한 결제수단을 불러옵니다. [자세히 >](#paymentmethodwidgetgetselectedpaymentmethod)
      *
@@ -147,6 +151,15 @@ interface WidgetPaymentRequest {
      * 결제 관련 정보를 추가할 수 있는 객체입니다. 최대 5개의 키-값(key-value) 쌍을 자유롭게 추가해주세요. 키는 `[` , `]` 를 사용하지 않는 최대 40자의 문자열, 값은 최대 500자의 문자열입니다.
      */
     metadata?: Record<string | symbol | number, unknown> | null;
+    /**
+     * @ignore
+     */
+    sandbox?: {
+        /**
+         * @ignore
+         */
+        paymentResult: 'SUCCESS' | 'FAIL';
+    };
     /**
      * 구매자가 카드를 선택하면 결제에 적용되는 옵션입니다.
      */
@@ -231,6 +244,15 @@ interface WidgetPaymentRequest {
              */
             quantity?: number | null;
         }> | null;
+        /**
+         * 현금영수증 정보입니다.
+         */
+        cashReceipt?: {
+            /**
+             * 현금영수증 발급 용도입니다. '소득공제', '지출증빙', '미발행' 중 하나입니다.
+             */
+            type: '소득공제' | '지출증빙' | '미발행';
+        } | null;
     } | null;
     /**
      * 구매자가 해외간편결제를 선택하면 결제에 적용되는 옵션입니다.
@@ -581,6 +603,10 @@ interface BrandpayPaymentRequest {
      * 결제 금액 중 면세 금액입니다. 면세 상점 혹은 복합 과세 상점으로 계약된 상점만 사용하세요. 자세한 내용은 세금 처리 가이드에서 확인하세요.
      */
     taxFreeAmount?: number | null;
+    /**
+     * 결제수단의 ID입니다. 결제수단 ID 입니다. 등록되어 있는 결제수단 중 하나를 지정해서 바로 결제하고 싶을 때 사용합니다.
+     */
+    methodId?: string | null;
     /**
      * 결제 관련 정보를 추가할 수 있는 객체입니다. 최대 5개의 키-값(key-value) 쌍을 자유롭게 추가해주세요. 키는 `[` , `]` 를 사용하지 않는 최대 40자의 문자열, 값은 최대 500자의 문자열입니다.
      */
@@ -847,6 +873,15 @@ interface PaymentRequest {
      * 결제 관련 정보를 추가할 수 있는 객체입니다. 최대 5개의 키-값(key-value) 쌍을 자유롭게 추가해주세요. 키는 `[` , `]` 를 사용하지 않는 최대 40자의 문자열, 값은 최대 500자의 문자열입니다.
      */
     metadata?: Record<string | symbol | number, unknown> | null;
+    /**
+     * @ignore
+     */
+    sandbox?: {
+        /**
+         * @ignore
+         */
+        paymentResult: 'SUCCESS' | 'FAIL';
+    };
 }
 
 interface CardPaymentRequest extends PaymentRequest {
@@ -1045,11 +1080,11 @@ interface TransferPaymentRequest extends PaymentRequest {
          */
         taxExemptionAmount?: number | null;
         /**
-         * 현금영수증 정보입니다.
+         * @ignore
          */
         cashReceipt?: {
             /**
-             * 현금영수증 발급 용도입니다. '소득공제', '지출증빙', '미발행' 중 하나입니다.
+             * @ignore
              */
             type: '소득공제' | '지출증빙' | '미발행';
         } | null;
@@ -1232,7 +1267,7 @@ interface BillingAuthRequest {
      * 자동결제(빌링)에 등록할 결제수단입니다. 토스페이먼츠 자동결제는 현재 신용·체크카드만 지원해요.
      *
      */
-    method: 'CARD' | 'TRANSFER';
+    method: 'CARD';
     /**
      * 카드 등록이 성공하면 리다이렉트되는 URL입니다. 리다이렉트되면 URL의 쿼리 파라미터로 `authKey`, `customerKey`가 추가돼요. 값을 검증하고 [빌링키 발급 API](/reference#authkey로-카드-빌링키-발급)를 호출하세요.
      * 반드시 오리진을 포함해야 합니다.
@@ -1284,7 +1319,7 @@ interface BillingAuthRequest {
 type RequestPayment = RequestCardPaymentWithRedirection & RequestCardPaymentWithPromise & RequestVirtualAccountPaymentWithRedirection & RequestVirtualAccountPaymentWithPromise & RequestTransferPaymentWithRedirection & RequestTransferPaymentWithPromise & RequestMobilePhonePaymentWithRedirection & RequestMobilePhonePaymentWithPromise & RequestGiftCertificatePaymentWithRedirection & RequestGiftCertificatePaymentWithPromise & RequestForeignEasyPayPaymentWithRedirection;
 /**
  * @docsAlias 카드(Promise 방식)
- * @returns `WidgetPaymentResult` 객체가 응답됩니다. 객체 필드를 확인하고 [결제 승인 API](/reference#결제-승인)를 호출해야 결제가 최종적으로 완료돼요.
+ * @returns `RequestPaymentResult` 객체가 응답됩니다. 객체 필드를 확인하고 [결제 승인 API](/reference#결제-승인)를 호출해야 결제가 최종적으로 완료돼요.
  * @param {RequestCardPaymentWithPromise} paymentRequest 결제 요청 정보입니다.
  *
  * @example
@@ -1350,7 +1385,7 @@ type RequestCardPaymentWithPromise = (paymentRequest: CardPaymentRequest) => Pro
 type RequestCardPaymentWithRedirection = (paymentRequest: WithRedirection<CardPaymentRequest>) => Promise<void>;
 /**
  * @docsAlias 가상계좌(Promise 방식)
- * @returns `WidgetPaymentResult` 객체가 응답됩니다. 객체 필드를 확인하고 [결제 승인 API](/reference#결제-승인)를 호출해야 결제가 최종적으로 완료돼요.
+ * @returns `RequestPaymentResult` 객체가 응답됩니다. 객체 필드를 확인하고 [결제 승인 API](/reference#결제-승인)를 호출해야 결제가 최종적으로 완료돼요.
  * @param {VirtualAccountPaymentRequest} paymentRequest 결제 요청 정보입니다.
  *
  * @example
@@ -1418,7 +1453,7 @@ type RequestVirtualAccountPaymentWithPromise = (paymentRequest: VirtualAccountPa
 type RequestVirtualAccountPaymentWithRedirection = (paymentRequest: WithRedirection<VirtualAccountPaymentRequest>) => Promise<void>;
 /**
  * @docsAlias 계좌이체(Promise 방식)
- * @returns `WidgetPaymentResult` 객체가 응답됩니다. 객체 필드를 확인하고 [결제 승인 API](/reference#결제-승인)를 호출해야 결제가 최종적으로 완료돼요.
+ * @returns `RequestPaymentResult` 객체가 응답됩니다. 객체 필드를 확인하고 [결제 승인 API](/reference#결제-승인)를 호출해야 결제가 최종적으로 완료돼요.
  * @param {RequestTransferPaymentWithPromise} paymentRequest 결제 요청 정보입니다.
  *
  * @example
@@ -1483,7 +1518,7 @@ type RequestTransferPaymentWithPromise = (paymentRequest: TransferPaymentRequest
 type RequestTransferPaymentWithRedirection = (paymentRequest: WithRedirection<TransferPaymentRequest>) => Promise<void>;
 /**
  * @docsAlias 휴대폰 결제(Promise 방식)
- * @returns `WidgetPaymentResult` 객체가 응답됩니다. 객체 필드를 확인하고 [결제 승인 API](/reference#결제-승인)를 호출해야 결제가 최종적으로 완료돼요.
+ * @returns `RequestPaymentResult` 객체가 응답됩니다. 객체 필드를 확인하고 [결제 승인 API](/reference#결제-승인)를 호출해야 결제가 최종적으로 완료돼요.
  * @param {RequestMobilePhonePaymentWithPromise} paymentRequest 결제 요청 정보입니다.
  *
  * @example
@@ -1536,7 +1571,7 @@ type RequestMobilePhonePaymentWithPromise = (paymentRequest: MobilePhonePaymentR
 type RequestMobilePhonePaymentWithRedirection = (paymentRequest: WithRedirection<MobilePhonePaymentRequest>) => Promise<void>;
 /**
  * @docsAlias 상품권(Promise 방식)
- * @returns `WidgetPaymentResult` 객체가 응답됩니다. 객체 필드를 확인하고 [결제 승인 API](/reference#결제-승인)를 호출해야 결제가 최종적으로 완료돼요.
+ * @returns `RequestPaymentResult` 객체가 응답됩니다. 객체 필드를 확인하고 [결제 승인 API](/reference#결제-승인)를 호출해야 결제가 최종적으로 완료돼요.
  * @param {RequestGiftCertificatePaymentWithPromise} paymentRequest 결제 요청 정보입니다.
  *
  * @example