@tosspayments/tosspayments-sdk 2.3.5 → 2.3.7

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.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)
+
+
+### Bug Fixes
+
+* **tosspayments-sdk:** @tosspayments/standard-public-interfaces 버전업 ([#132](https://github.com/tosspayments/browser-sdk/issues/132)) ([282947a](https://github.com/tosspayments/browser-sdk/commit/282947a03ecdd1e969e2c7a42e432285c2126c5e))
+
+
+
+
+
 ## [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)
 
 

package/package.json

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

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;
     /**
@@ -209,6 +209,10 @@ interface WidgetPaymentRequest {
              */
             quantity?: number | null;
         }> | null;
+        /**
+         * 문화비(도서, 공연 티켓, 박물관·미술관 입장권 등) 지출 여부입니다.
+         */
+        isCulturalExpenses?: boolean | null;
     } | null;
     /**
      * 구매자가 가상계좌를 선택하면 결제에 적용되는 옵션입니다.
@@ -253,6 +257,10 @@ interface WidgetPaymentRequest {
              */
             type: '소득공제' | '지출증빙' | '미발행';
         } | null;
+        /**
+         * 문화비(도서, 공연 티켓, 박물관·미술관 입장권 등) 지출 여부입니다.
+         */
+        isCulturalExpenses?: boolean | null;
     } | null;
     /**
      * 구매자가 해외간편결제를 선택하면 결제에 적용되는 옵션입니다.
@@ -344,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 {
@@ -608,7 +640,7 @@ interface BrandpayPaymentRequest {
      */
     methodId?: string | null;
     /**
-     * 결제 관련 정보를 추가할 수 있는 객체입니다. 최대 5개의 키-값(key-value) 쌍을 자유롭게 추가해주세요. 키는 `[` , `]` 를 사용하지 않는 최대 40자의 문자열, 값은 최대 500자의 문자열입니다.
+     * 결제 관련 정보를 추가할 수 있는 객체입니다. 최대 5개의 키-값(key-value) 쌍을 자유롭게 추가해주세요. 키는 `[` , `]` 를 사용하지 않는 최대 40자의 문자열, 값은 최대 2000자의 문자열입니다.
      */
     metadata?: Record<string | symbol | number, unknown> | null;
 }
@@ -801,6 +833,21 @@ type IsOneTouchPayEnabled = () => Promise<{
     isEnabled: boolean;
 }>;
 
+/**
+ * 자동결제(빌링) 약관 동의와 비밀번호 인증을 수행합니다
+ *
+ * @example
+ * ```javascript
+ * brandpay.requestBillingAuth();
+ * ```
+ *
+ * @throws {@link PublicError.Brandpay.UserCancelError} 사용자가 자동결제 인증창을 닫은 경우
+ * @throws {@link PublicError.Brandpay.NotRegisteredRedirectUrlError} redirectUrl이 등록되지 않은 경우
+ * @throws {@link PublicError.Brandpay.InvalidMethodTransactionError} 이미 다른 명령을 수행 중인 경우
+ * @throws {@link PublicError.Brandpay.UnknownError} 알 수 없는 오류가 발생한 경우
+ */
+type RequestBillingAuth$1 = () => Promise<void>;
+
 interface TossPaymentsBrandpay {
     /**
      * 브랜드페이 결제창을 띄웁니다. [자세히 >](#brandpayrequestpayment)
@@ -826,6 +873,13 @@ interface TossPaymentsBrandpay {
      * 원터치결제 활성화 여부를 확인합니다. [자세히 >](#brandpayisonetouchpayenabled)
      */
     isOneTouchPayEnabled: IsOneTouchPayEnabled;
+    /**
+     * 자동결제(빌링) 약관 동의와 비밀번호 인증을 수행합니다 [자세히 >](#brandpayrequestbillingauth)
+     */
+    /**
+     * @ignore
+     */
+    requestBillingAuth: RequestBillingAuth$1;
 }
 
 interface PaymentRequest {
@@ -870,7 +924,7 @@ interface PaymentRequest {
      */
     pendingUrl?: string | null;
     /**
-     * 결제 관련 정보를 추가할 수 있는 객체입니다. 최대 5개의 키-값(key-value) 쌍을 자유롭게 추가해주세요. 키는 `[` , `]` 를 사용하지 않는 최대 40자의 문자열, 값은 최대 500자의 문자열입니다.
+     * 결제 관련 정보를 추가할 수 있는 객체입니다. 최대 5개의 키-값(key-value) 쌍을 자유롭게 추가해주세요. 키는 `[` , `]` 를 사용하지 않는 최대 40자의 문자열, 값은 최대 2000자의 문자열입니다.
      */
     metadata?: Record<string | symbol | number, unknown> | null;
     /**
@@ -882,6 +936,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 {
@@ -922,21 +990,21 @@ interface CardPaymentRequest extends PaymentRequest {
         /**
          * 신용카드 결제에 적용되는 할부 개월 수입니다.
          * 예를 들어, `6`으로 설정하면 할부 개월 수가 6개월로 고정돼요. 자체창에서는 구매자가 할부 개월 수를 볼 수 없으니 사전에 충분히 안내를 해주세요.
-         * 0(일시불), 2~12 값으로 설정할 수 있고 `maxCardInstallmentPlan` 파라미터와 함께 사용할 수 없어요. 카드사 별로 할부결제가 가능한 [최소 금액](https://pgweb.tosspayments.com/tosspayments/MainPopUp.do)을 확인하세요.
+         * 0(일시불), 2~12 값으로 설정할 수 있고 `maxCardInstallmentPlan` 파라미터와 함께 사용할 수 없어요. 카드사 별로 할부결제가 가능한 [최소 금액](https://consumer.tosspayments.com/notice/free-installment)을 확인하세요.
          */
         cardInstallmentPlan?: number | null;
         /**
          * 신용카드 결제에 적용할 수 있는 최대 할부 개월 수입니다.
-         * 예를 들어, `6`으로 설정하면 구매자는 일시불부터 6개월 할부를 선택할 수 있어요. 0(일시불), 2~12 값으로 설정할 수 있고 `cardInstallmentPlan` 파라미터와 함께 사용할 수 없어요. 카드사 별로 할부결제가 가능한 [최소 금액](https://pgweb.tosspayments.com/tosspayments/MainPopUp.do)을 확인하세요.
+         * 예를 들어, `6`으로 설정하면 구매자는 일시불부터 6개월 할부를 선택할 수 있어요. 0(일시불), 2~12 값으로 설정할 수 있고 `cardInstallmentPlan` 파라미터와 함께 사용할 수 없어요. 카드사 별로 할부결제가 가능한 [최소 금액](https://consumer.tosspayments.com/notice/free-installment)을 확인하세요.
          */
         maxCardInstallmentPlan?: number | null;
         /**
          * 신용카드 결제에 적용할 수 있는 **상점 부담 무이자** 할부 정보입니다.
-         * 구매자가 선택한 카드, 할부 개월 수가 배열에 등록한 정보와 같다면 무이자가 할부가 자동으로 적용돼요. 카드사 별로 할부결제가 가능한 [최소 금액](https://pgweb.tosspayments.com/tosspayments/MainPopUp.do)을 확인하세요.
+         * 구매자가 선택한 카드, 할부 개월 수가 배열에 등록한 정보와 같다면 무이자가 할부가 자동으로 적용돼요. 카드사 별로 할부결제가 가능한 [최소 금액](https://consumer.tosspayments.com/notice/free-installment)을 확인하세요.
          */
         freeInstallmentPlans?: Array<{
             /**
-             * 상점 부담 무이자를 적용할 카드사 코드](/codes/org-codes#카드사-코드)입니다.
+             * 상점 부담 무이자를 적용할 [카드사 코드](/codes/org-codes#카드사-코드)입니다.
              */
             company: string;
             /**
@@ -998,6 +1066,15 @@ interface CardPaymentRequest extends PaymentRequest {
          * 페이북/ISP 앱에서 상점 앱으로 돌아올 때 사용됩니다. 상점의 앱 스킴을 지정하면 됩니다. 예를 들면 testapp://같은 형태입니다.
          */
         appScheme?: string | null;
+        /**
+         * 키인 결제정보입니다.
+         */
+        keyin?: {
+            /**
+             * 결제화면에 노출할 카드 타입입니다. `PERSONAL`(개인카드), `CORPORATE`(법인카드), `FOREIGN`(해외카드) 값을 배열 형태로 전달할 수 있습니다. 입력한 순서대로 화면에 노출되며, 첫 번째로 입력한 카드 타입이 기본 선택됩니다.
+             */
+            selectableCardTypes?: Array<'PERSONAL' | 'CORPORATE' | 'FOREIGN'> | null;
+        } | null;
     } | null;
 }
 
@@ -1063,6 +1140,10 @@ interface VirtualAccountPaymentRequest extends PaymentRequest {
          * 기한이 지나고 시도하는 결제는 실패해요. 예를 들어 `2025-01-01T00:00:00`으로 설정하면, 2024년 12월 31일 23:59까지 결제할 수 있어요.
          */
         dueDate?: string | null;
+        /**
+         * 문화비(도서, 공연 티켓, 박물관·미술관 입장권 등) 지출 여부입니다.
+         */
+        isCulturalExpenses?: boolean | null;
     } | null;
 }
 
@@ -1080,11 +1161,11 @@ interface TransferPaymentRequest extends PaymentRequest {
          */
         taxExemptionAmount?: number | null;
         /**
-         * @ignore
+         * 현금영수증 정보입니다.
          */
         cashReceipt?: {
             /**
-             * @ignore
+             *  type을 '미발행' 으로 보내면 현금영수증을 발행하지 않습니다.
              */
             type: '소득공제' | '지출증빙' | '미발행';
         } | null;
@@ -1129,6 +1210,10 @@ interface TransferPaymentRequest extends PaymentRequest {
          * 기한이 지나고 시도하는 결제는 실패해요. 예를 들어 `2025-01-01T00:00:00`으로 설정하면, 2024년 12월 31일 23:59까지 결제할 수 있어요.
          */
         dueDate?: string | null;
+        /**
+         * 문화비(도서, 공연 티켓, 박물관·미술관 입장권 등) 지출 여부입니다.
+         */
+        isCulturalExpenses?: boolean | null;
     } | null;
 }
 
@@ -1265,9 +1350,8 @@ interface RequestPaymentResult {
 interface BillingAuthRequest {
     /**
      * 자동결제(빌링)에 등록할 결제수단입니다. 토스페이먼츠 자동결제는 현재 신용·체크카드만 지원해요.
-     *
      */
-    method: 'CARD';
+    method: 'CARD' | 'TRANSFER';
     /**
      * 카드 등록이 성공하면 리다이렉트되는 URL입니다. 리다이렉트되면 URL의 쿼리 파라미터로 `authKey`, `customerKey`가 추가돼요. 값을 검증하고 [빌링키 발급 API](/reference#authkey로-카드-빌링키-발급)를 호출하세요.
      * 반드시 오리진을 포함해야 합니다.
@@ -1298,6 +1382,10 @@ interface BillingAuthRequest {
      * @default 'iframe'
      */
     windowTarget?: 'iframe' | 'self' | null;
+    /**
+     * 결제화면에 노출할 카드 타입입니다. `PERSONAL`(개인카드), `CORPORATE`(법인카드) 값을 배열 형태로 전달할 수 있습니다. 입력한 순서대로 화면에 노출되며, 첫 번째로 입력한 카드 타입이 기본 선택됩니다.
+     */
+    selectableCardTypes?: Array<'PERSONAL' | 'CORPORATE'> | null;
 }
 
 /**