@tosspayments/tosspayments-sdk 2.3.2 → 2.3.4

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.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)
+
+
+### Bug Fixes
+
+* **tosspayments-sdk:** @tosspayments/standard-public-interfaces 버전업 ([#129](https://github.com/tosspayments/browser-sdk/issues/129)) ([4f7ec3b](https://github.com/tosspayments/browser-sdk/commit/4f7ec3becddc35187a8584c6454d4fe64828f888))
+
+
+
+
+
 ## [2.3.2](https://github.com/tosspayments/browser-sdk/compare/@tosspayments/tosspayments-sdk@2.3.1...@tosspayments/tosspayments-sdk@2.3.2) (2024-09-23)
 
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tosspayments/tosspayments-sdk",
   "description": "TossPayments.js Tosspayments SDK.",
-  "version": "2.3.2",
+  "version": "2.3.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.22",
+    "@tosspayments/standard-public-interfaces": "2.0.45",
     "happy-dom": "^14.12.3",
     "prettier": "^2.0.2",
     "rollup": "^2.60.0",
@@ -38,5 +38,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "54049b225d20dc37905dc955d4a04d476efd54cd"
+  "gitHead": "793c235208215386fb73996cbd93250201974f78"
 }

package/types/index.d.ts

@@ -118,23 +118,31 @@ interface WidgetPaymentRequest {
     /**
      * 구매자 이메일입니다. 결제 상태가 바뀌면 이메일 주소로 결제내역이 전송됩니다. 최대 길이는 100자입니다.
      */
-    customerEmail?: string;
+    customerEmail?: string | null;
     /**
      * 구매자명입니다. 최대 길이는 100자입니다.
      */
-    customerName?: string;
+    customerName?: string | null;
     /**
-     * 구매자의 휴대폰 번호입니다. 가상계좌 안내, 퀵계좌이체 휴대폰 번호 자동 완성에 사용되고 있어요.
+     * 구매자의 휴대폰 번호입니다. 가상계좌 안내, 퀵계좌이체 휴대폰 번호 자동 완성에 사용되고 있어요. `-` 없이 숫자로만 구성된 최소 8자, 최대 15자의 문자열입니다.
      */
-    customerMobilePhone?: string;
+    customerMobilePhone?: string | null;
     /**
      * 결제 금액 중 면세 금액입니다. 면세 상점 혹은 복합 과세 상점으로 계약된 상점만 사용하세요. 자세한 내용은 세금 처리 가이드에서 확인하세요.
      */
-    taxFreeAmount?: number;
+    taxFreeAmount?: number | null;
     /**
-     * 중국 및 동남아 간편결제(비동기)의 결제 요청이 완료되면 리다이렉트되는 URL입니다. 반드시 오리진을 포함해야 합니다.
+     * 브라우저에서 결제창이 열리는 프레임입니다. `self`, `iframe` 중 하나입니다.
+     *
+     * \- `self`는 현재 브라우저를 결제창으로 이동시켜요. 모바일 환경에서 기본 값입니다.
+     *
+     * \- `iframe`은 iframe에서 결제창이 열려요. PC 환경에서 기본 값입니다. **모바일 환경에서는 `iframe`을 사용할 수 없습니다.**
      */
-    pendingUrl?: string;
+    windowTarget?: 'iframe' | 'self' | null;
+    /**
+     * @ignore
+     */
+    pendingUrl?: string | null;
     /**
      * 결제 관련 정보를 추가할 수 있는 객체입니다. 최대 5개의 키-값(key-value) 쌍을 자유롭게 추가해주세요. 키는 `[` , `]` 를 사용하지 않는 최대 40자의 문자열, 값은 최대 500자의 문자열입니다.
      */
@@ -147,8 +155,12 @@ interface WidgetPaymentRequest {
          * 과세를 제외한 결제 금액(컵 보증금 등)입니다. 값을 넣지 않으면 기본값인 0으로 설정됩니다.
          * 과세 제외 금액이 있는 카드 결제는 부분 취소가 안 됩니다.
          */
-        taxExemptionAmount?: number;
-    };
+        taxExemptionAmount?: number | null;
+        /**
+         * 페이북/ISP 앱에서 상점 앱으로 돌아올 때 사용됩니다. 상점의 앱 스킴을 지정하면 됩니다. 예를 들면 testapp://같은 형태입니다.
+         */
+        appScheme?: string | null;
+    } | null;
     /**
      * 구매자가 계좌이체를 선택하면 결제에 적용되는 옵션입니다.
      */
@@ -157,7 +169,7 @@ interface WidgetPaymentRequest {
          * 에스크로 적용 여부입니다. `true`로 설정하면 구매자가 반드시 에스크로 적용에 동의해야 결제가 완료돼요.
          * `false`로 설정하거나 파라미터를 설정하지 않으면 에스크로 적용을 구매자 선택에 맡겨요.
          */
-        useEscrow?: boolean;
+        useEscrow?: boolean | null;
         /**
          * 각 상품의 상세 정보 객체를 담는 배열입니다. 에스크로를 사용하는 상점이라면 필수 파라미터입니다.
          * 예를 들어 사용자가 세 가지 종류의 상품을 구매했다면 길이가 3인 배열이어야 합니다.
@@ -166,25 +178,25 @@ interface WidgetPaymentRequest {
             /**
              * 각 상품의 고유 ID입니다.
              */
-            id?: string;
+            id?: string | null;
             /**
              * 상품명입니다.
              */
-            name?: string;
+            name?: string | null;
             /**
              * 내 상점에서 사용하는 상품 관리 코드입니다.
              */
-            code?: string;
+            code?: string | null;
             /**
              * 상품의 1개의 개별 가격입니다.
              */
-            unitPrice?: number;
+            unitPrice?: number | null;
             /**
              * 상품 구매 수량입니다.
              */
-            quantity?: number;
-        }>;
-    };
+            quantity?: number | null;
+        }> | null;
+    } | null;
     /**
      * 구매자가 가상계좌를 선택하면 결제에 적용되는 옵션입니다.
      */
@@ -192,7 +204,7 @@ interface WidgetPaymentRequest {
         /**
          * 에스크로 사용 여부입니다. 값을 주지 않으면 결제창에서 고객이 직접 에스크로 결제 여부를 선택합니다.
          */
-        useEscrow?: boolean;
+        useEscrow?: boolean | null;
         /**
          * 각 상품의 상세 정보 객체를 담는 배열입니다. 에스크로를 사용하는 상점이라면 필수 파라미터입니다.
          * 예를 들어 사용자가 세 가지 종류의 상품을 구매했다면 길이가 3인 배열이어야 합니다.
@@ -201,25 +213,34 @@ interface WidgetPaymentRequest {
             /**
              * 각 상품의 고유 ID입니다.
              */
-            id?: string;
+            id?: string | null;
             /**
              * 상품명입니다.
              */
-            name?: string;
+            name?: string | null;
             /**
              * 내 상점에서 사용하는 상품 관리 코드입니다.
              */
-            code?: string;
+            code?: string | null;
             /**
              * 상품의 1개의 개별 가격입니다.
              */
-            unitPrice?: number;
+            unitPrice?: number | null;
             /**
              * 상품 구매 수량입니다.
              */
-            quantity?: number;
-        }>;
-    };
+            quantity?: number | null;
+        }> | null;
+        /**
+         * 현금영수증 정보입니다.
+         */
+        cashReceipt?: {
+            /**
+             * 현금영수증 발급 용도입니다. '소득공제', '지출증빙', '미발행' 중 하나입니다.
+             */
+            type: '소득공제' | '지출증빙' | '미발행';
+        } | null;
+    } | null;
     /**
      * 구매자가 해외간편결제를 선택하면 결제에 적용되는 옵션입니다.
      */
@@ -254,7 +275,7 @@ interface WidgetPaymentRequest {
              * 상품 설명입니다.
              */
             description: string;
-        }>;
+        }> | null;
         /**
          * 배송 정보입니다.
          */
@@ -262,27 +283,27 @@ interface WidgetPaymentRequest {
             /**
              * 수령인입니다.
              */
-            fullName?: string;
+            fullName?: string | null;
             /**
              * 배송 주소입니다.
              */
             address?: {
                 /**
-                 * 국가입니다.
+                 * 구매자가 위치한 국가입니다. ISO-3166의 두 자리 국가 코드를 입력하세요.
                  */
                 country: string;
                 /**
                  * 주소입니다. 도로명 및 건물(Street, Apt), 번지 정보입니다.
                  */
-                line1?: string;
+                line1?: string | null;
                 /**
                  * 상세 주소입니다. 번지 및 동호수 정보를 입력하세요.
                  */
-                line2?: string;
+                line2?: string | null;
                 /**
                  * 주(State, Province, Region) 정보입니다. 국가의 도시 체계에 따라 없는 경우가 있습니다.
                  */
-                area1?: string;
+                area1?: string | null;
                 /**
                  * 도시입니다.
                  */
@@ -290,9 +311,9 @@ interface WidgetPaymentRequest {
                 /**
                  * 배송지 우편번호입니다. 중국, 일본, 프랑스, 독일 등 [일부 국가](https://developer.paypal.com/api/rest/reference/orders/v2/country-address-requirements/#link-countryandregionaddressrequirements)에서는 필수 파라미터입니다
                  */
-                postalCode?: string;
-            };
-        };
+                postalCode?: string | null;
+            } | null;
+        } | null;
         /**
          * 특정 해외간편결제 수단에만 필요한 정보입니다.
          */
@@ -307,9 +328,9 @@ interface WidgetPaymentRequest {
                  * 문서의 표에 있는 ‘Data Field Name’ 컬럼 값을 객체의 ‘key’로, ‘Description’에 맞는 값을 객체의 ‘value’로 넣어주시면 됩니다.
                  */
                 setTransactionContext?: unknown;
-            };
-        };
-    };
+            } | null;
+        } | null;
+    } | null;
 }
 
 interface Amount {
@@ -328,12 +349,12 @@ type WithRedirection<T> = T & {
      * 결제 요청이 성공하면 리다이렉트되는 URL입니다. `https://www.example.com/success`와 같이 오리진을 포함한 형태로 설정해주세요.
      * 리다이렉트되면 URL의 쿼리 파라미터로 `amount`, `orderId`, `paymentKey`가 추가돼요.
      */
-    successUrl?: string;
+    successUrl?: string | null;
     /**
      * 결제 요청이 실패하면 리다이렉트되는 URL입니다. `https://www.example.com/fail`와 같이 오리진을 포함한 형태로 설정해주세요.
      * 리다이렉트되면 URL의 쿼리 파라미터로 에러 코드와 메시지를 확인할 수 있어요.
      */
-    failUrl?: string;
+    failUrl?: string | null;
 };
 
 type WidgetPaymentResult = {
@@ -464,7 +485,6 @@ type RequestPayment$2 = RequestPaymentWithPromise$1 & RequestPaymentWithRedirect
       orderName: "토스 티셔츠 외 2건",
       customerEmail: "customer123@gmail.com",
       customerName: "김토스",
-      customerMobilePhone: "01012341234",
     });
  * ```
 
@@ -494,7 +514,6 @@ type RequestPaymentWithPromise$1 = (paymentRequest: WidgetPaymentRequest) => Pro
       failUrl: window.location.origin + "/fail.html",
       customerEmail: "customer123@gmail.com",
       customerName: "김토스",
-      customerMobilePhone: "01012341234",
     });
  * ```
  */
@@ -562,15 +581,15 @@ interface BrandpayPaymentRequest {
     /**
      * 구매자 이메일입니다. 결제 상태가 바뀌면 이메일 주소로 결제내역이 전송됩니다. 최대 길이는 100자입니다.
      */
-    customerEmail?: string;
+    customerEmail?: string | null;
     /**
      * 구매자명입니다. 최대 길이는 100자입니다.
      */
-    customerName?: string;
+    customerName?: string | null;
     /**
      * 결제 금액 중 면세 금액입니다. 면세 상점 혹은 복합 과세 상점으로 계약된 상점만 사용하세요. 자세한 내용은 세금 처리 가이드에서 확인하세요.
      */
-    taxFreeAmount?: number;
+    taxFreeAmount?: number | null;
     /**
      * 결제 관련 정보를 추가할 수 있는 객체입니다. 최대 5개의 키-값(key-value) 쌍을 자유롭게 추가해주세요. 키는 `[` , `]` 를 사용하지 않는 최대 40자의 문자열, 값은 최대 500자의 문자열입니다.
      */
@@ -639,7 +658,6 @@ type RequestPayment$1 = RequestPaymentWithPromise & RequestPaymentWithRedirectio
  *   failUrl: window.location.origin + '/fail.html',
  *   customerEmail: 'customer123@gmail.com',
  *   customerName: '김토스',
- *   customerMobilePhone: '01012341234',
  * });
  * ```
  */
@@ -660,7 +678,6 @@ type RequestPaymentWithRedirection = (paymentRequest: WithRedirection<BrandpayPa
  *   orderName: '토스 티셔츠 외 2건',
  *   customerEmail: 'customer123@gmail.com',
  *   customerName: '김토스',
- *   customerMobilePhone: '01012341234',
  * });
  * ```
  */
@@ -810,29 +827,31 @@ interface PaymentRequest {
     /**
      * 구매자명입니다. 최대 길이는 100자입니다.
      */
-    customerName?: string;
+    customerName?: string | null;
     /**
      * 구매자 이메일입니다. 결제 상태가 바뀌면 이메일 주소로 결제내역이 전송됩니다. 최대 길이는 100자입니다.
      */
-    customerEmail?: string;
+    customerEmail?: string | null;
     /**
-     * 구매자의 휴대폰 번호입니다. 가상계좌 안내, 퀵계좌이체 휴대폰 번호 자동 완성에 사용되고 있어요.
+     * 구매자의 휴대폰 번호입니다. 가상계좌 안내, 퀵계좌이체 휴대폰 번호 자동 완성에 사용되고 있어요. `-` 없이 숫자로만 구성된 최소 8자, 최대 15자의 문자열입니다.
      */
-    customerMobilePhone?: string;
+    customerMobilePhone?: string | null;
     /**
      * 결제 금액 중 면세 금액입니다. 면세 상점 혹은 복합 과세 상점으로 계약된 상점만 사용하세요. 자세한 내용은 세금 처리 가이드에서 확인하세요.
      */
-    taxFreeAmount?: number;
+    taxFreeAmount?: number | null;
     /**
      * 브라우저에서 결제창이 열리는 프레임입니다. `self`, `iframe` 중 하나입니다.
+     *
      * \- `self`는 현재 브라우저를 결제창으로 이동시켜요. 모바일 환경에서 기본 값입니다.
+     *
      * \- `iframe`은 iframe에서 결제창이 열려요. PC 환경에서 기본 값입니다. **모바일 환경에서는 `iframe`을 사용할 수 없습니다.**
      */
-    windowTarget?: 'iframe' | 'self';
+    windowTarget?: 'iframe' | 'self' | null;
     /**
-     * 중국 및 동남아 간편결제(비동기)의 결제 요청이 완료되면 리다이렉트되는 URL입니다. 반드시 오리진을 포함해야 합니다.
+     * @ignore
      */
-    pendingUrl?: string;
+    pendingUrl?: string | null;
     /**
      * 결제 관련 정보를 추가할 수 있는 객체입니다. 최대 5개의 키-값(key-value) 쌍을 자유롭게 추가해주세요. 키는 `[` , `]` 를 사용하지 않는 최대 40자의 문자열, 값은 최대 500자의 문자열입니다.
      */
@@ -851,105 +870,109 @@ interface CardPaymentRequest extends PaymentRequest {
         /**
          * 에스크로 적용 여부입니다. `true`로 설정하면 구매자가 반드시 에스크로 적용에 동의해야 결제가 완료돼요. `false`로 설정하거나 파라미터를 설정하지 않으면 에스크로 적용을 구매자 선택에 맡겨요.
          */
-        useEscrow?: boolean;
+        useEscrow?: boolean | null;
         /**
          * 과세를 제외한 결제 금액(컵 보증금 등)입니다.
          * 과세 제외 금액이 있는 카드 결제는 부분 취소가 안 됩니다.
          */
-        taxExemptionAmount?: number;
+        taxExemptionAmount?: number | null;
         /**
          * 결제창을 여는 방법입니다. `DEFAULT`는 카드/간편결제 통합결제창을 열고, `DIRECT`는 카드 또는 간편결제의 자체창을 열어요.
          * 기본 값은 `DEFAULT`입니다.
          */
-        flowMode?: 'DIRECT' | 'DEFAULT';
+        flowMode?: 'DIRECT' | 'DEFAULT' | null;
         /**
-         * 카드사 코드입니다. `flowMode` 값에 따라 아래와 같이 다르게 동작해요.
+         * [카드사 코드](/codes/org-codes#카드사-코드)입니다. `flowMode` 값에 따라 아래와 같이 다르게 동작해요.
          * `flowMode`가 `DIRECT`일 때는 입력한 코드의 카드사 앱이 열려요.
          * `flowMode`가 `DEFAULT`일 때는 통합결제창에 입력한 코드의 카드사만 보여요.
          */
-        cardCompany?: string;
+        cardCompany?: string | null;
         /**
-         * 간편결제 코드입니다. `flowMode` 값에 따라 아래와 같이 다르게 동작해요.
+         * [간편결제 코드](/codes/org-codes#간편결제사-코드)입니다. `flowMode` 값에 따라 아래와 같이 다르게 동작해요.
          * `flowMode`가 `DIRECT`일 때는 입력한 코드의 간편결제 앱이 열려요.
-         * `flowMode`가 `DEFAULT`일 때는 통합결제창에 입력한 코드의 간편결제만 보여요.
+         * `flowMode`가 `DEFAULT`일 때는 해당 파라미터와 상관 없이 기본 통합결제창이 열려요.
          */
-        easyPay?: string;
+        easyPay?: string | null;
         /**
          * 신용카드 결제에 적용되는 할부 개월 수입니다.
          * 예를 들어, `6`으로 설정하면 할부 개월 수가 6개월로 고정돼요. 자체창에서는 구매자가 할부 개월 수를 볼 수 없으니 사전에 충분히 안내를 해주세요.
          * 0(일시불), 2~12 값으로 설정할 수 있고 `maxCardInstallmentPlan` 파라미터와 함께 사용할 수 없어요. 카드사 별로 할부결제가 가능한 [최소 금액](https://pgweb.tosspayments.com/tosspayments/MainPopUp.do)을 확인하세요.
          */
-        cardInstallmentPlan?: number;
+        cardInstallmentPlan?: number | null;
         /**
          * 신용카드 결제에 적용할 수 있는 최대 할부 개월 수입니다.
          * 예를 들어, `6`으로 설정하면 구매자는 일시불부터 6개월 할부를 선택할 수 있어요. 0(일시불), 2~12 값으로 설정할 수 있고 `cardInstallmentPlan` 파라미터와 함께 사용할 수 없어요. 카드사 별로 할부결제가 가능한 [최소 금액](https://pgweb.tosspayments.com/tosspayments/MainPopUp.do)을 확인하세요.
          */
-        maxCardInstallmentPlan?: number;
+        maxCardInstallmentPlan?: number | null;
         /**
          * 신용카드 결제에 적용할 수 있는 **상점 부담 무이자** 할부 정보입니다.
          * 구매자가 선택한 카드, 할부 개월 수가 배열에 등록한 정보와 같다면 무이자가 할부가 자동으로 적용돼요. 카드사 별로 할부결제가 가능한 [최소 금액](https://pgweb.tosspayments.com/tosspayments/MainPopUp.do)을 확인하세요.
          */
         freeInstallmentPlans?: Array<{
             /**
-             * 상점 부담 무이자를 적용할 카드사 코드입니다.
+             * 상점 부담 무이자를 적용할 카드사 코드](/codes/org-codes#카드사-코드)입니다.
              */
             company: string;
             /**
              * 상점 부담 무이자를 적용할 할부 개월입니다.
              */
             months: number[];
-        }>;
+        }> | null;
         /**
          * 카드사 포인트 사용 여부입니다. `true`로 설정하면 카드사 포인트 사용이 체크된 상태로 결제창이 열려요. `false`로 설정하거나 값을 넣지 않으면 구매자가 직접 카드사 포인트 사용 여부를 선택할 수 있어요.
          *
          * \* 추가 계약이 필요한 파라미터입니다. 토스페이먼츠 고객센터(1544-7772, support@tosspayments.com)로 문의해주세요.
          */
-        useCardPoint?: boolean;
+        useCardPoint?: boolean | null;
         /**
          * 앱카드 단독 사용 여부입니다. `true`로 설정하면 카드사의 앱카드만 열려요. 국민, 농협, 롯데, 삼성, 신한, 우리, 현대 카드 결제에 적용할 수 있어요.
          */
-        useAppCardOnly?: boolean;
+        useAppCardOnly?: boolean | null;
         /**
          * 카드사의 프로모션 코드입니다. 프로모션은 `flowMode`가 `DIRECT`로 설정된 자체창 결제에만 사용할 수 있어요. 프로모션 조회 API로 적용할 수 있는 프로모션 코드를 확인하세요.
          */
-        discountCode?: string;
+        discountCode?: string | null;
         /**
          * 시간으로 설정하는 결제 기한입니다. 설정할 수 있는 최대 값은 2160시간(90일)입니다.
          * 기한이 지나고 시도하는 결제는 실패해요. 예를 들어 `24`로 설정하면, 결제 요청 시점으로부터 24시간 동안 결제할 수 있어요.
          */
-        validHours?: number;
+        validHours?: number | null;
         /**
          * 특정 날짜로 설정하는 결제 기한입니다. `yyyy-MM-dd'T'HH:mm:ss` ISO 8601 형식입니다.
          * 기한이 지나고 시도하는 결제는 실패해요. 예를 들어 `2025-01-01T00:00:00`으로 설정하면, 2024년 12월 31일 23:59까지 결제할 수 있어요.
          */
-        dueDate?: string;
+        dueDate?: string | null;
         escrowProducts?: Array<{
             /**
              * 각 상품의 고유 ID입니다.
              */
-            id?: string;
+            id?: string | null;
             /**
              * 상품명입니다.
              */
-            name?: string;
+            name?: string | null;
             /**
              * 내 상점에서 사용하는 상품 관리 코드입니다.
              */
-            code?: string;
+            code?: string | null;
             /**
              * 상품의 1개의 개별 가격입니다.
              */
-            unitPrice?: number;
+            unitPrice?: number | null;
             /**
              * 상품 구매 수량입니다.
              */
-            quantity?: number;
-        }>;
+            quantity?: number | null;
+        }> | null;
         /**
          * 해외카드(Visa, MasterCard, JCB, UnionPay 등) 결제 여부입니다. `true`로 설정하면 해외카드 결제가 가능한 [다국어 결제창](/resources/glossary/payment-window#다국어-결제창)이 열립니다.
          */
-        useInternationalCardOnly?: boolean;
-    };
+        useInternationalCardOnly?: boolean | null;
+        /**
+         * 페이북/ISP 앱에서 상점 앱으로 돌아올 때 사용됩니다. 상점의 앱 스킴을 지정하면 됩니다. 예를 들면 testapp://같은 형태입니다.
+         */
+        appScheme?: string | null;
+    } | null;
 }
 
 interface VirtualAccountPaymentRequest extends PaymentRequest {
@@ -964,50 +987,57 @@ interface VirtualAccountPaymentRequest extends PaymentRequest {
         /**
          * 과세를 제외한 결제 금액(컵 보증금 등)입니다.
          */
-        taxExemptionAmount?: number;
+        taxExemptionAmount?: number | null;
         /**
-         * 현금영수증 발급 용도입니다.
+         * 현금영수증 정보입니다.
          */
         cashReceipt?: {
+            /**
+             * 현금영수증 발급 용도입니다. '소득공제', '지출증빙', '미발행' 중 하나입니다.
+             */
             type: '소득공제' | '지출증빙' | '미발행';
-        };
+        } | null;
         /**
          * 에스크로 적용 여부입니다.
          */
-        useEscrow?: boolean;
+        useEscrow?: boolean | null;
+        /**
+         * 에스크로 상품 정보입니다.
+         * 여러 가지의 상품을 결제했다면 각 상품의 정보를 입력하세요. 예를 들어, 구매자가 세 가지 종류의 상품을 구매했다면 배열의 길이는 3이어야 합니다.
+         */
         escrowProducts?: Array<{
             /**
              * 각 상품의 고유 ID입니다.
              */
-            id?: string;
+            id?: string | null;
             /**
              * 상품명입니다.
              */
-            name?: string;
+            name?: string | null;
             /**
              * 내 상점에서 사용하는 상품 관리 코드입니다.
              */
-            code?: string;
+            code?: string | null;
             /**
              * 상품의 1개의 개별 가격입니다.
              */
-            unitPrice?: number;
+            unitPrice?: number | null;
             /**
              * 상품 구매 수량입니다.
              */
-            quantity?: number;
-        }>;
+            quantity?: number | null;
+        }> | null;
         /**
          * 시간으로 설정하는 결제 기한입니다. 설정할 수 있는 최대 값은 2160시간(90일)입니다.
          * 기한이 지나고 시도하는 결제는 실패해요. 예를 들어 `24`로 설정하면, 결제 요청 시점으로부터 24시간 동안 결제할 수 있어요.
          */
-        validHours?: number;
+        validHours?: number | null;
         /**
          * 특정 날짜로 설정하는 결제 기한입니다. `yyyy-MM-dd'T'HH:mm:ss` ISO 8601 형식입니다.
          * 기한이 지나고 시도하는 결제는 실패해요. 예를 들어 `2025-01-01T00:00:00`으로 설정하면, 2024년 12월 31일 23:59까지 결제할 수 있어요.
          */
-        dueDate?: string;
-    };
+        dueDate?: string | null;
+    } | null;
 }
 
 interface TransferPaymentRequest extends PaymentRequest {
@@ -1022,21 +1052,21 @@ interface TransferPaymentRequest extends PaymentRequest {
         /**
          * 과세를 제외한 결제 금액(컵 보증금 등)입니다.
          */
-        taxExemptionAmount?: number;
+        taxExemptionAmount?: number | null;
         /**
-         * 현금영수증 정보입니다.
+         * @ignore
          */
         cashReceipt?: {
             /**
-             * 현금영수증 발급 용도입니다.
+             * @ignore
              */
             type: '소득공제' | '지출증빙' | '미발행';
-        };
+        } | null;
         /**
          * 에스크로 적용 여부입니다. `true`로 설정하면 구매자가 반드시 에스크로 적용에 동의해야 결제가 완료돼요.
          * `false`로 설정하거나 파라미터를 설정하지 않으면 에스크로 적용을 구매자 선택에 맡겨요.
          */
-        useEscrow?: boolean;
+        useEscrow?: boolean | null;
         /**
          * 에스크로 상품 정보입니다.
          * 여러 가지의 상품을 결제했다면 각 상품의 정보를 입력하세요. 예를 들어, 구매자가 세 가지 종류의 상품을 구매했다면 배열의 길이는 3이어야 합니다.
@@ -1045,35 +1075,35 @@ interface TransferPaymentRequest extends PaymentRequest {
             /**
              * 각 상품의 고유 ID입니다.
              */
-            id?: string;
+            id?: string | null;
             /**
              * 상품명입니다.
              */
-            name?: string;
+            name?: string | null;
             /**
              * 내 상점에서 사용하는 상품 관리 코드입니다.
              */
-            code?: string;
+            code?: string | null;
             /**
              * 상품의 1개의 개별 가격입니다.
              */
-            unitPrice?: number;
+            unitPrice?: number | null;
             /**
              * 상품 구매 수량입니다.
              */
-            quantity?: number;
-        }>;
+            quantity?: number | null;
+        }> | null;
         /**
          * 시간으로 설정하는 결제 기한입니다. 설정할 수 있는 최대 값은 2160시간(90일)입니다.
          * 기한이 지나고 시도하는 결제는 실패해요. 예를 들어 `24`로 설정하면, 결제 요청 시점으로부터 24시간 동안 결제할 수 있어요.
          */
-        validHours?: number;
+        validHours?: number | null;
         /**
          * 특정 날짜로 설정하는 결제 기한입니다. `yyyy-MM-dd'T'HH:mm:ss` ISO 8601 형식입니다.
          * 기한이 지나고 시도하는 결제는 실패해요. 예를 들어 `2025-01-01T00:00:00`으로 설정하면, 2024년 12월 31일 23:59까지 결제할 수 있어요.
          */
-        dueDate?: string;
-    };
+        dueDate?: string | null;
+    } | null;
 }
 
 interface MobilePhonePaymentRequest extends PaymentRequest {
@@ -1102,7 +1132,7 @@ interface ForeignEasyPayPaymentRequest extends PaymentRequest {
         /**
          * 해외간편결제 코드입니다. 현재는 `PAYPAL`만 지원하고 있어요.
          */
-        provider: string;
+        provider: 'PAYPAL' | 'GCASH' | 'TOUCHNGO' | 'BOOST' | 'BPI' | 'BILLEASE' | 'DANA' | 'ALIPAYHK' | 'TRUEMONEY' | 'RABBIT_LINE_PAY' | 'ALIPAY';
         /**
          * 구매자가 위치한 국가입니다. ISO-3166의 두 자리 국가 코드를 입력하세요.
          */
@@ -1133,7 +1163,7 @@ interface ForeignEasyPayPaymentRequest extends PaymentRequest {
              * 상품 설명입니다.
              */
             description: string;
-        }>;
+        }> | null;
         /**
          * 배송 정보입니다.
          */
@@ -1141,27 +1171,27 @@ interface ForeignEasyPayPaymentRequest extends PaymentRequest {
             /**
              * 수령인입니다.
              */
-            fullName?: string;
+            fullName?: string | null;
             /**
              * 배송 주소입니다.
              */
             address?: {
                 /**
-                 * 국가입니다.
+                 * 구매자가 위치한 국가입니다. ISO-3166의 두 자리 국가 코드를 입력하세요.
                  */
                 country: string;
                 /**
                  * 주소입니다. 도로명 및 건물(Street, Apt), 번지 정보입니다.
                  */
-                line1?: string;
+                line1?: string | null;
                 /**
                  * 상세 주소입니다. 번지 및 동호수 정보를 입력하세요.
                  */
-                line2?: string;
+                line2?: string | null;
                 /**
                  * 주(State, Province, Region) 정보입니다. 국가의 도시 체계에 따라 없는 경우가 있습니다.
                  */
-                area1?: string;
+                area1?: string | null;
                 /**
                  * 도시입니다.
                  */
@@ -1169,9 +1199,9 @@ interface ForeignEasyPayPaymentRequest extends PaymentRequest {
                 /**
                  * 배송지 우편번호입니다. 중국, 일본, 프랑스, 독일 등 [일부 국가](https://developer.paypal.com/api/rest/reference/orders/v2/country-address-requirements/#link-countryandregionaddressrequirements)에서는 필수 파라미터입니다
                  */
-                postalCode?: string;
-            };
-        };
+                postalCode?: string | null;
+            } | null;
+        } | null;
         /**
          * 특정 해외간편결제 수단에만 필요한 정보입니다.
          */
@@ -1186,8 +1216,8 @@ interface ForeignEasyPayPaymentRequest extends PaymentRequest {
                  * 문서의 표에 있는 ‘Data Field Name’ 컬럼 값을 객체의 ‘key’로, ‘Description’에 맞는 값을 객체의 ‘value’로 넣어주시면 됩니다.
                  */
                 setTransactionContext?: unknown;
-            };
-        };
+            } | null;
+        } | null;
     };
 }
 
@@ -1211,7 +1241,7 @@ interface BillingAuthRequest {
      * 자동결제(빌링)에 등록할 결제수단입니다. 토스페이먼츠 자동결제는 현재 신용·체크카드만 지원해요.
      *
      */
-    method: 'CARD';
+    method: 'CARD' | 'TRANSFER';
     /**
      * 카드 등록이 성공하면 리다이렉트되는 URL입니다. 리다이렉트되면 URL의 쿼리 파라미터로 `authKey`, `customerKey`가 추가돼요. 값을 검증하고 [빌링키 발급 API](/reference#authkey로-카드-빌링키-발급)를 호출하세요.
      * 반드시 오리진을 포함해야 합니다.
@@ -1227,19 +1257,21 @@ interface BillingAuthRequest {
     /**
      * 구매자명입니다. 상점관리자 및 결제내역 이메일에 사용됩니다. 최대 길이는 100자입니다.
      */
-    customerName?: string;
+    customerName?: string | null;
     /**
      * 구매자의 이메일 주소입니다. 결제 상태가 바뀌면 이메일 주소로 결제내역이 전송됩니다. 최대 길이는 100자입니다.
      */
-    customerEmail?: string;
+    customerEmail?: string | null;
     /**
      * 브라우저에서 결제창이 열리는 프레임입니다. `self`, `iframe` 중 하나입니다.
+     *
      * \- `self`는 현재 브라우저를 결제창으로 이동시켜요. 모바일 환경에서 기본 값입니다.
+     *
      * \- `iframe`은 iframe에서 결제창이 열려요. PC 환경에서 기본 값입니다. **모바일 환경에서는 `iframe`을 사용할 수 없습니다.**
      *
      * @default 'iframe'
      */
-    windowTarget?: 'iframe' | 'self';
+    windowTarget?: 'iframe' | 'self' | null;
 }
 
 /**
@@ -1258,7 +1290,7 @@ interface BillingAuthRequest {
  * @throws {@link PublicError.Payment.InvalidParametersError} 파라미터가 올바르지 않은 경우
  * @throws {@link PublicError.Payment.UnknownError} 알 수 없는 오류가 발생한 경우
  */
-type RequestPayment = RequestCardPaymentWithRedirection & RequestCardPaymentWithPromise & RequestVirtualAccountPaymentWithRedirection & RequestVirtualAccountPaymentWithPromise & RequestTransferPaymentWithRedirection & RequestTransferPaymentWithPromise & RequestMobilePhonePaymentWithRedirection & RequestMobilePhonePaymentWithPromise & RequestGiftCertificatePaymentWithRedirection & RequestGiftCertificatePaymentWithPromise & RequestForeignEasyPayPaymentWithRedirection & RequestForeignEasyPayPaymentWithPromise;
+type RequestPayment = RequestCardPaymentWithRedirection & RequestCardPaymentWithPromise & RequestVirtualAccountPaymentWithRedirection & RequestVirtualAccountPaymentWithPromise & RequestTransferPaymentWithRedirection & RequestTransferPaymentWithPromise & RequestMobilePhonePaymentWithRedirection & RequestMobilePhonePaymentWithPromise & RequestGiftCertificatePaymentWithRedirection & RequestGiftCertificatePaymentWithPromise & RequestForeignEasyPayPaymentWithRedirection;
 /**
  * @docsAlias 카드(Promise 방식)
  * @returns `WidgetPaymentResult` 객체가 응답됩니다. 객체 필드를 확인하고 [결제 승인 API](/reference#결제-승인)를 호출해야 결제가 최종적으로 완료돼요.
@@ -1276,7 +1308,6 @@ type RequestPayment = RequestCardPaymentWithRedirection & RequestCardPaymentWith
       orderName: "토스 티셔츠 외 2건",
       customerEmail: "customer123@gmail.com",
       customerName: "김토스",
-      customerMobilePhone: "01012341234",
       windowTarget: "iframe",
       card: {
         useEscrow: false,
@@ -1316,7 +1347,6 @@ type RequestCardPaymentWithPromise = (paymentRequest: CardPaymentRequest) => Pro
       failUrl: window.location.origin + "/fail.html",
       customerEmail: "customer123@gmail.com",
       customerName: "김토스",
-      customerMobilePhone: "01012341234",
       card: {
         useEscrow: false,
         flowMode: "DEFAULT",
@@ -1344,7 +1374,6 @@ type RequestCardPaymentWithRedirection = (paymentRequest: WithRedirection<CardPa
       orderName: "토스 티셔츠 외 2건",
       customerEmail: "customer123@gmail.com",
       customerName: "김토스",
-      customerMobilePhone: "01012341234",
       windowTarget: "iframe",
       virtualAccount: {
         cashReceipt: {
@@ -1385,7 +1414,6 @@ type RequestVirtualAccountPaymentWithPromise = (paymentRequest: VirtualAccountPa
       failUrl: window.location.origin + "/fail.html",
       customerEmail: "customer123@gmail.com",
       customerName: "김토스",
-      customerMobilePhone: "01012341234",
       virtualAccount: {
         cashReceipt: {
           type: "소득공제",
@@ -1414,7 +1442,6 @@ type RequestVirtualAccountPaymentWithRedirection = (paymentRequest: WithRedirect
       orderName: "토스 티셔츠 외 2건",
       customerEmail: "customer123@gmail.com",
       customerName: "김토스",
-      customerMobilePhone: "01012341234",
       transfer: {
         cashReceipt: {
           type: "소득공제",
@@ -1453,7 +1480,6 @@ type RequestTransferPaymentWithPromise = (paymentRequest: TransferPaymentRequest
       failUrl: window.location.origin + "/fail.html",
       customerEmail: "customer123@gmail.com",
       customerName: "김토스",
-      customerMobilePhone: "01012341234",
       transfer: {
         cashReceipt: {
           type: "소득공제",
@@ -1481,7 +1507,6 @@ type RequestTransferPaymentWithRedirection = (paymentRequest: WithRedirection<Tr
       orderName: "토스 티셔츠 외 2건",
       customerEmail: "customer123@gmail.com",
       customerName: "김토스",
-      customerMobilePhone: "01012341234",
     });
  * ```
  */
@@ -1514,7 +1539,6 @@ type RequestMobilePhonePaymentWithPromise = (paymentRequest: MobilePhonePaymentR
       failUrl: window.location.origin + "/fail.html",
       customerEmail: "customer123@gmail.com",
       customerName: "김토스",
-      customerMobilePhone: "01012341234",
     });
  * ```
  */
@@ -1536,7 +1560,6 @@ type RequestMobilePhonePaymentWithRedirection = (paymentRequest: WithRedirection
       orderName: "토스 티셔츠 외 2건",
       customerEmail: "customer123@gmail.com",
       customerName: "김토스",
-      customerMobilePhone: "01012341234",
     });
  * ```
  */
@@ -1569,37 +1592,10 @@ type RequestGiftCertificatePaymentWithPromise = (paymentRequest: GiftCertificate
       failUrl: window.location.origin + "/fail.html",
       customerEmail: "customer123@gmail.com",
       customerName: "김토스",
-      customerMobilePhone: "01012341234",
     });
  * ```
  */
 type RequestGiftCertificatePaymentWithRedirection = (paymentRequest: WithRedirection<GiftCertificatePaymentRequest>) => Promise<void>;
-/**
- * @docsAlias 해외 간편결제(Promise 방식)
- * @returns `WidgetPaymentResult` 객체가 응답됩니다. 객체 필드를 확인하고 [결제 승인 API](/reference#결제-승인)를 호출해야 결제가 최종적으로 완료돼요.
- * @param {RequestForeignEasyPayPaymentWithPromise} paymentRequest 결제 요청 정보입니다.
- *
- * @example
- *  ```javascript
- *  payment.requestPayment({
-      method: "FOREIGN_EASY_PAY",
-      amount: {
-        currency: "USD",
-        value: 5000,
-      },
-      orderId: "<UniqueId name='orderId.paypal' />",
-      orderName: "토스 티셔츠 외 2건",
-      customerEmail: "customer123@gmail.com",
-      customerName: "김토스",
-      customerMobilePhone: "01012341234",
-      foreignEasyPay: {
-        provider: "PAYPAL",
-        country: "KR",
-      },
-    });
- * ```
- */
-type RequestForeignEasyPayPaymentWithPromise = (paymentRequest: ForeignEasyPayPaymentRequest) => Promise<RequestPaymentResult>;
 /**
  * @docsAlias 해외 간편결제(Redirect 방식)
  * @returns 결제 요청이 성공하면 파라미터로 설정한 `successUrl`로 이동해요. 쿼리 파라미터의 `amount` 값이 메서드 파라미터로 설정한 `amount`와 같은지 반드시 확인하고 [결제 승인 API](/reference#결제-승인)를 호출해서 결제를 완료하세요.
@@ -1628,7 +1624,6 @@ type RequestForeignEasyPayPaymentWithPromise = (paymentRequest: ForeignEasyPayPa
       failUrl: window.location.origin + "/fail.html",
       customerEmail: "customer123@gmail.com",
       customerName: "김토스",
-      customerMobilePhone: "01012341234",
       foreignEasyPay: {
         provider: "PAYPAL",
         country: "KR",