@tosspayments/tosspayments-sdk 2.3.6 → 2.4.0

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.4.0](https://github.com/tosspayments/browser-sdk/compare/@tosspayments/tosspayments-sdk@2.3.7...@tosspayments/tosspayments-sdk@2.4.0) (2025-09-10)
+
+
+### Features
+
+* standard-public-interfaces 버전업 ([#134](https://github.com/tosspayments/browser-sdk/issues/134)) ([3dbead5](https://github.com/tosspayments/browser-sdk/commit/3dbead5e1aabc8bf7e4a26cbc558c5a81cdc1f41))
+
+
+
+
+
+## [2.3.7](https://github.com/tosspayments/browser-sdk/compare/@tosspayments/tosspayments-sdk@2.3.6...@tosspayments/tosspayments-sdk@2.3.7) (2025-08-22)
+
+
+### Bug Fixes
+
+* **tosspayments-sdk:** @tosspayments/standard-public-interfaces 버전업 ([#133](https://github.com/tosspayments/browser-sdk/issues/133)) ([1d2a4a6](https://github.com/tosspayments/browser-sdk/commit/1d2a4a6d55192f323f74b1672628b1bf44d1b810))
+
+
+
+
+
 ## [2.3.6](https://github.com/tosspayments/browser-sdk/compare/@tosspayments/tosspayments-sdk@2.3.5...@tosspayments/tosspayments-sdk@2.3.6) (2025-08-13)
 
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tosspayments/tosspayments-sdk",
   "description": "TossPayments.js Tosspayments SDK.",
-  "version": "2.3.6",
+  "version": "2.4.0",
   "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.1.4",
+    "@tosspayments/standard-public-interfaces": "2.4.2",
     "happy-dom": "^14.12.3",
     "prettier": "^2.0.2",
     "rollup": "^2.60.0",
@@ -38,5 +38,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "e1bef43ea888b8474f865a318177cf74087a6d83"
+  "gitHead": "42ca041f917ae5834d48e8a2aca203c23bbfe064"
 }

package/types/index.d.ts

@@ -148,7 +148,7 @@ interface WidgetPaymentRequest {
      */
     pendingUrl?: string | null;
     /**
-     * 결제 관련 정보를 추가할 수 있는 객체입니다. 최대 5개의 키-값(key-value) 쌍을 자유롭게 추가해주세요. 키는 `[` , `]` 를 사용하지 않는 최대 40자의 문자열, 값은 최대 500자의 문자열입니다.
+     * 결제 관련 정보를 추가할 수 있는 객체입니다. 최대 5개의 키-값(key-value) 쌍을 자유롭게 추가해주세요. 키는 `[` , `]` 를 사용하지 않는 최대 40자의 문자열, 값은 최대 2000자의 문자열입니다.
      */
     metadata?: Record<string | symbol | number, unknown> | null;
     /**
@@ -352,6 +352,30 @@ interface WidgetPaymentRequest {
             } | null;
         } | null;
     } | null;
+    /**
+     * @ignore
+     */
+    subMerchantSetting?: {
+        normalClientKey?: string | null;
+        keyinClientKey?: string | null;
+        foreignEasyPayClientKey?: string | null;
+        brandpayClientKey?: string | null;
+        brandpayRedirectUrl?: string | null;
+    } | null;
+    /**
+     * @ignore
+     */
+    subOrders?: Array<{
+        merchantBusinessNumber: string;
+        merchantName: string;
+        merchantAddress: {
+            country: string;
+            postalCode: string;
+            address: string;
+            detailAddress?: string | null;
+        };
+        orderName: string;
+    }> | null;
 }
 
 interface Amount {
@@ -616,10 +640,72 @@ interface BrandpayPaymentRequest {
      */
     methodId?: string | null;
     /**
-     * 결제 관련 정보를 추가할 수 있는 객체입니다. 최대 5개의 키-값(key-value) 쌍을 자유롭게 추가해주세요. 키는 `[` , `]` 를 사용하지 않는 최대 40자의 문자열, 값은 최대 500자의 문자열입니다.
+     * 결제 관련 정보를 추가할 수 있는 객체입니다. 최대 5개의 키-값(key-value) 쌍을 자유롭게 추가해주세요. 키는 `[` , `]` 를 사용하지 않는 최대 40자의 문자열, 값은 최대 2000자의 문자열입니다.
      */
     metadata?: Record<string | symbol | number, unknown> | null;
+    /**
+     * 구매자가 카드를 선택하면 결제에 적용되는 옵션입니다.
+     */
+    card?: {
+        /**
+         * 신용 카드의 할부 개월 수입니다. 값을 넣으면 해당 할부 개월 수로 결제가 진행됩니다.
+         * 2부터 12사이의 값을 사용할 수 있고, 0이 들어가면 할부가 아닌 일시불로 결제됩니다.
+         * 결제 금액(amount)이 5만원 이상일 때만 할부가 적용됩니다.
+         */
+        cardInstallmentPlan?: number | null;
+        /**
+         * 카드사 포인트 사용 여부입니다.
+         * 값을 주지 않거나 값이 false라면 사용자가 카드사 포인트 사용 여부를 결정할 수 있습니다. 이 값을 true로 주면 카드사 포인트 사용이 체크된 상태로 결제창이 열립니다.
+         *
+         * \* 추가 계약이 필요한 파라미터입니다. 토스페이먼츠 고객센터(1544-7772, support@tosspayments.com)로 문의해주세요.
+         */
+        useCardPoint?: boolean | null;
+        /**
+         * 카드 즉시 할인 코드입니다. methodId 파라미터가 있을 경우 적용됩니다.
+         * [카드 프로모션 조회 API](https://docs.tosspayments.com/reference/brandpay#%EC%B9%B4%EB%93%9C-%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98-%EC%A1%B0%ED%9A%8C)로 적용할 수 있는 할인 코드의 목록을 조회할 수 있습니다.
+         */
+        discountCode?: string | null;
+    } | null;
+    /**
+     * 구매자가 계좌를 선택하면 결제에 적용되는 옵션입니다.
+     */
+    transfer?: {
+        /**
+         * 현금영수증 발급 정보를 담는 객체입니다.
+         */
+        cashReceipt?: CashReceipt | null;
+        /**
+         * 문화비(도서, 공연 티켓, 박물관·미술관 입장권 등) 지출 여부입니다.
+         */
+        isCulturalExpenses?: boolean | null;
+        /**
+         * 계좌 즉시 할인 코드입니다. methodId 파라미터가 있을 경우 적용됩니다.
+         * [계좌 프로모션 조회 API](https://docs.tosspayments.com/reference/brandpay#%EA%B3%84%EC%A2%8C-%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98-%EC%A1%B0%ED%9A%8C)로 적용할 수 있는 할인 코드의 목록을 조회할 수 있습니다.
+         */
+        discountCode?: string | null;
+    } | null;
+}
+interface BasicCashReceipt {
+    type: '소득공제' | '지출증빙' | '미발행';
+    registrationNumber?: string;
+    registrationNumberType?: 'CASH_RECEIPT_CARD' | 'BUSINESS_REGISTRATION' | 'MOBILE';
+}
+interface 소득공제_현금영수증 extends BasicCashReceipt {
+    type: '소득공제';
+    registrationNumberType: 'MOBILE' | 'CASH_RECEIPT_CARD';
+    registrationNumber: string;
 }
+interface 지출증빙_현금영수증 extends BasicCashReceipt {
+    type: '지출증빙';
+    registrationNumberType: 'BUSINESS_REGISTRATION' | 'CASH_RECEIPT_CARD';
+    registrationNumber: string;
+}
+interface 미발행 extends BasicCashReceipt {
+    type: '미발행';
+    registrationNumberType?: never;
+    registrationNumber?: never;
+}
+type CashReceipt = 소득공제_현금영수증 | 지출증빙_현금영수증 | 미발행;
 
 interface BrandpayRequestPaymentResult {
     /**
@@ -855,10 +941,6 @@ interface TossPaymentsBrandpay {
     /**
      * @ignore
      */
-    /**
-     * 브랜드페이 빌링은 sales 가맹점 중 rm 검토된 곳에만 제한적으로 제공되기 때문에 docs에서 노출하지 않습니다.
-     * @link https://tossteam.slack.com/archives/C06ENN7PJK1/p1752207105929219
-     */
     requestBillingAuth: RequestBillingAuth$1;
 }
 
@@ -904,7 +986,7 @@ interface PaymentRequest {
      */
     pendingUrl?: string | null;
     /**
-     * 결제 관련 정보를 추가할 수 있는 객체입니다. 최대 5개의 키-값(key-value) 쌍을 자유롭게 추가해주세요. 키는 `[` , `]` 를 사용하지 않는 최대 40자의 문자열, 값은 최대 500자의 문자열입니다.
+     * 결제 관련 정보를 추가할 수 있는 객체입니다. 최대 5개의 키-값(key-value) 쌍을 자유롭게 추가해주세요. 키는 `[` , `]` 를 사용하지 않는 최대 40자의 문자열, 값은 최대 2000자의 문자열입니다.
      */
     metadata?: Record<string | symbol | number, unknown> | null;
     /**
@@ -916,6 +998,20 @@ interface PaymentRequest {
          */
         paymentResult: 'SUCCESS' | 'FAIL';
     };
+    /**
+     * @ignore
+     */
+    subOrders?: Array<{
+        merchantBusinessNumber: string;
+        merchantName: string;
+        merchantAddress: {
+            country: string;
+            postalCode: string;
+            address: string;
+            detailAddress?: string | null;
+        };
+        orderName: string;
+    }> | null;
 }
 
 interface CardPaymentRequest extends PaymentRequest {
@@ -1349,7 +1445,7 @@ interface BillingAuthRequest {
      */
     windowTarget?: 'iframe' | 'self' | null;
     /**
-     * 결제화면에 노출할 카드 타입입니다. `PERSONAL`(개인카드), `CORPORATE`(법인카드), `FOREIGN`(해외카드) 값을 배열 형태로 전달할 수 있습니다. 입력한 순서대로 화면에 노출되며, 첫 번째로 입력한 카드 타입이 기본 선택됩니다.
+     * 결제화면에 노출할 카드 타입입니다. `PERSONAL`(개인카드), `CORPORATE`(법인카드) 값을 배열 형태로 전달할 수 있습니다. 입력한 순서대로 화면에 노출되며, 첫 번째로 입력한 카드 타입이 기본 선택됩니다.
      */
     selectableCardTypes?: Array<'PERSONAL' | 'CORPORATE'> | null;
 }