@apps-in-toss/native-modules 2.4.7 → 2.5.0

package/dist/bridges-meta.json

@@ -87,6 +87,10 @@
     "identifier": "checkoutPayment",
     "dts": "/**\n * @public\n * @category 토스페이\n * @name CheckoutPaymentOptions\n * @description 토스페이 결제창을 띄울 때 필요한 옵션이에요.\n * @property {string} payToken 결제 토큰이에요.\n */\nexport interface CheckoutPaymentOptions {\n\t/**\n\t * 결제 토큰이에요.\n\t */\n\tpayToken: string;\n}\n/**\n * @public\n * @category 토스페이\n * @name CheckoutPaymentResult\n * @description 토스페이 결제창에서 사용자가 인증에 성공했는지 여부예요.\n * @property {boolean} success 인증이 성공했는지 여부예요.\n * @property {string} [reason] 인증이 실패했을 경우의 이유예요.\n */\nexport interface CheckoutPaymentResult {\n\t/**\n\t * 인증이 성공했는지 여부예요.\n\t */\n\tsuccess: boolean;\n\t/**\n\t * 인증이 실패했을 경우의 이유예요.\n\t */\n\treason?: string;\n}\n/**\n * @public\n * @category 토스페이\n * @name checkoutPayment\n * @description 토스페이 결제창을 띄우고, 사용자 인증을 수행해요. 인증이 완료되면 성공 여부를 반환해요.\n *\n * 이 함수는 결제창을 통해 사용자 인증만 해요. 실제 결제 처리는 인증 성공 후 서버에서 별도로 해야 해요.\n *\n * @param {CheckoutPaymentOptions} options 결제창을 띄울 때 필요한 옵션이에요.\n * @returns {Promise<CheckoutPaymentResult>} 인증 성공 여부를 포함한 결과를 반환해요.\n *\n * @example\n *\n * ### 토스페이 결제창 띄우고 인증 처리하기\n *\n * ```tsx\n * import { TossPay } from '@apps-in-toss/framework';\n *\n * async function handlePayment() {\n *   try {\n *     // 실제 구현 시 결제 생성 역할을 하는 API 엔드포인트로 대체해주세요.\n *     const { payToken } = await fetch('/my-api/payment/create').then(res => res.json());\n *\n *     const { success, reason } = await TossPay.checkoutPayment({ payToken });\n *\n *     if (success) {\n *       // 실제 구현 시 결제를 실행하는 API 엔드포인트로 대체해주세요.\n *       await fetch('/my-api/payment/execute', {\n *         method: 'POST',\n *         body: JSON.stringify({ payToken }),\n *         headers: { 'Content-Type': 'application/json' },\n *       });\n *     } else {\n *       console.log('인증 실패:', reason);\n *     }\n *   } catch (error) {\n *     console.error('결제 인증 중 오류가 발생했어요:', error);\n *   }\n * }\n * ```\n */\nexport declare function checkoutPayment(options: {\n\tparams: CheckoutPaymentOptions;\n}): Promise<CheckoutPaymentResult>;\n\nexport {};\n"
   },
+  {
+    "identifier": "requestTossPayPaysBilling",
+    "dts": "/**\n * @public\n * @category 토스페이\n * @name RequestTossPayPaysBillingOptions\n * @description 토스페이 정기결제창을 띄울 때 필요한 옵션이에요.\n * @property {string} wrappedToken 정기결제 래핑 토큰이에요.\n */\nexport interface RequestTossPayPaysBillingOptions {\n\t/**\n\t * 정기결제 래핑 토큰이에요.\n\t */\n\twrappedToken: string;\n}\n/**\n * @public\n * @category 토스페이\n * @name RequestTossPayPaysBillingResult\n * @description 토스페이 정기결제창에서 사용자가 인증에 성공했는지 여부예요.\n * @property {boolean} success 인증이 성공했는지 여부예요.\n * @property {string} [reason] 인증이 실패했을 경우의 이유예요.\n */\nexport interface RequestTossPayPaysBillingResult {\n\t/**\n\t * 인증이 성공했는지 여부예요.\n\t */\n\tsuccess: boolean;\n\t/**\n\t * 인증이 실패했을 경우의 이유예요.\n\t */\n\treason?: string;\n}\n/**\n * @public\n * @category 토스페이\n * @name requestTossPayPaysBilling\n * @description 토스페이 정기결제창을 띄우고, 사용자 인증을 수행해요. 인증이 완료되면 성공 여부를 반환해요.\n *\n * 이 함수는 결제창을 통해 사용자 인증만 해요. 실제 결제 처리는 인증 성공 후 서버에서 별도로 해야 해요.\n *\n * @property {() => boolean} isSupported 현재 앱 버전이 이 기능을 지원하는지 확인하는 함수예요.\n * @param {RequestTossPayPaysBillingOptions} options 정기결제창을 띄울 때 필요한 옵션이에요.\n * @returns {Promise<RequestTossPayPaysBillingResult>} 인증 성공 여부를 포함한 결과를 반환해요.\n *\n * @example\n *\n * ### 토스페이 정기결제창 띄우고 인증 처리하기\n *\n * ```tsx\n * import { TossPay } from '@apps-in-toss/framework';\n *\n * async function handleBilling() {\n *   try {\n *     // 실제 구현 시 정기결제 생성 역할을 하는 API 엔드포인트로 대체해주세요.\n *     const { wrappedToken } = await fetch('/my-api/billing/create').then(res => res.json());\n *\n *     const { success, reason } = await TossPay.requestTossPayPaysBilling({ wrappedToken });\n *\n *     if (success) {\n *       // 실제 구현 시 정기결제를 실행하는 API 엔드포인트로 대체해주세요.\n *       await fetch('/my-api/billing/execute', {\n *         method: 'POST',\n *         body: JSON.stringify({ wrappedToken }),\n *         headers: { 'Content-Type': 'application/json' },\n *       });\n *     } else {\n *       console.log('인증 실패:', reason);\n *     }\n *   } catch (error) {\n *     console.error('정기결제 인증 중 오류가 발생했어요:', error);\n *   }\n * }\n * ```\n */\nexport declare function requestTossPayPaysBilling(options: {\n\tparams: RequestTossPayPaysBillingOptions;\n}): Promise<RequestTossPayPaysBillingResult | undefined>;\nexport declare namespace requestTossPayPaysBilling {\n\tvar isSupported: () => boolean;\n}\n\nexport {};\n"
+  },
   {
     "identifier": "saveBase64Data",
     "dts": "export interface SaveBase64DataParams {\n\tdata: string;\n\tfileName: string;\n\tmimeType: string;\n}\n/**\n * @public\n * @category 데이터\n * @name saveBase64Data\n * @description 문자열로 인코딩된 Base64 데이터를 지정한 파일 이름과 MIME 타입으로 사용자 기기에 저장해요. 이미지, 텍스트, PDF 등 다양한 형식의 데이터를 저장할 수 있어요.\n * @param {SaveBase64DataParams} params - 저장할 데이터와 파일 정보를 담은 객체예요.\n * @param {string} params.data - Base64 형식으로 인코딩된 데이터 문자열이에요.\n * @param {string} params.fileName - 저장할 파일 이름이에요. 확장자도 같이 붙여줘야해요. 예를 들어, 'example.png'로 저장할 수 있어요.\n * @param {string} params.mimeType - 저장할 파일의 MIME 타입이에요. 예를 들어 'image/png' 로 지정하면 이미지, 'application/pdf'는 PDF 파일이에요. 자세한 내용은 [MIME 문서](https://developer.mozilla.org/ko/docs/Web/HTTP/Guides/MIME_types)를 참고해주세요.\n *\n * @example\n * ### Base64 이미지 데이터를 사용자 기기에 저장하기\n *\n * ```tsx\n * import { Button } from 'react-native';\n * import { saveBase64Data } from '@apps-in-toss/framework';\n *\n * // '저장' 버튼을 누르면 이미지가 사용자 기기에 저장돼요.\n * function SaveButton() {\n *   const handleSave = async () => {\n *     try {\n *       await saveBase64Data({\n *         data: 'iVBORw0KGgo...',\n *         fileName: 'some-photo.png',\n *         mimeType: 'image/png',\n *       });\n *     } catch (error) {\n *       console.error('데이터 저장에 실패했어요:', error);\n *     }\n *   };\n *\n *   return <Button title=\"저장\" onPress={handleSave} />;\n * }\n * ```\n */\nexport declare function saveBase64Data(params: SaveBase64DataParams): Promise<void>;\n\nexport {};\n"

package/dist/index.cjs

@@ -62,8 +62,10 @@ __export(index_exports, {
   openGameCenterLeaderboard: () => openGameCenterLeaderboard,
   openURL: () => openURL2,
   processProductGrant: () => processProductGrant,
+  requestNotificationAgreement: () => requestNotificationAgreement,
   requestOneTimePurchase: () => requestOneTimePurchase,
   requestReview: () => requestReview,
+  requestTossPayPaysBilling: () => requestTossPayPaysBilling,
   safePostMessage: () => safePostMessage,
   safeSyncPostMessage: () => safeSyncPostMessage,
   saveBase64Data: () => saveBase64Data,
@@ -492,6 +494,17 @@ async function checkoutPayment(options) {
   return safePostMessage("checkoutPayment", options.params);
 }
 
+// src/MiniAppModule/native-modules/requestTossPayPaysBilling.ts
+var MIN_VERSION = { android: "5.256.0", ios: "5.256.0" };
+async function requestTossPayPaysBilling(options) {
+  if (!requestTossPayPaysBilling.isSupported()) {
+    console.warn("requestTossPayPaysBilling is not supported in this app version");
+    return;
+  }
+  return safePostMessage("requestTossPayPaysBilling", options.params);
+}
+requestTossPayPaysBilling.isSupported = () => isMinVersionSupported(MIN_VERSION);
+
 // src/MiniAppModule/native-modules/appLogin.ts
 async function appLogin() {
   return safePostMessage("appLogin", {});
@@ -1062,7 +1075,7 @@ async function getServerTime() {
 getServerTime.isSupported = () => isMinVersionSupported(GET_SERVER_TIME_MIN_VERSION);
 
 // src/MiniAppModule/native-modules/requestReview.ts
-var MIN_VERSION = { android: "5.253.0", ios: "5.253.0" };
+var MIN_VERSION2 = { android: "5.253.0", ios: "5.253.0" };
 async function requestReview() {
   const isSupported = requestReview.isSupported();
   if (!isSupported) {
@@ -1074,11 +1087,33 @@ async function requestReview() {
   }
   return safePostMessage("requestMiniAppReview", { title: brandDisplayName });
 }
-requestReview.isSupported = () => isMinVersionSupported(MIN_VERSION);
+requestReview.isSupported = () => isMinVersionSupported(MIN_VERSION2);
+
+// src/MiniAppModule/native-modules/requestNotificationAgreement.ts
+var import_es_toolkit3 = require("es-toolkit");
+var MIN_VERSION3 = { android: "5.255.0", ios: "5.255.0" };
+function isRequestNotificationAgreementSupported() {
+  return isMinVersionSupported(MIN_VERSION3);
+}
+function requestNotificationAgreement(params) {
+  if (!isRequestNotificationAgreementSupported()) {
+    return import_es_toolkit3.noop;
+  }
+  const { options, onEvent, onError } = params;
+  return INTERNAL__appBridgeHandler.invokeAppBridgeMethod("requestNotificationAgreement", options, {
+    onSuccess: (result) => {
+      onEvent({ type: result.agreementResult });
+    },
+    onError: (error) => {
+      onError(error);
+    }
+  });
+}
 
 // src/MiniAppModule/native-modules/index.ts
 var TossPay = {
-  checkoutPayment
+  checkoutPayment,
+  requestTossPayPaysBilling
 };
 var GoogleAdMob = {
   loadAppsInTossAdMob,
@@ -1234,8 +1269,10 @@ var INTERNAL__module = {
   openGameCenterLeaderboard,
   openURL,
   processProductGrant,
+  requestNotificationAgreement,
   requestOneTimePurchase,
   requestReview,
+  requestTossPayPaysBilling,
   safePostMessage,
   safeSyncPostMessage,
   saveBase64Data,

package/dist/index.d.cts

@@ -902,6 +902,137 @@ declare const IAP: {
     getSubscriptionInfo: typeof getSubscriptionInfo;
 };
 
+/**
+ * @public
+ * @category 알림
+ * @name NotificationAgreementResult
+ * @description 푸시 알림 동의 플로우의 결과예요.
+ * @property {'newAgreement'} newAgreement - 이번에 새로 동의한 경우예요.
+ * @property {'alreadyAgreed'} alreadyAgreed - 이미 동의한 사용자인 경우예요.
+ * @property {'agreementRejected'} agreementRejected - 사용자가 동의를 거부한 경우예요.
+ */
+type NotificationAgreementResult = 'newAgreement' | 'alreadyAgreed' | 'agreementRejected';
+/**
+ * @property {string} templateCode - 알림 동의를 받을 스마트발송 캠패인의 템플릿 코드예요. 코드는 앱인토스 콘솔 > 미니앱 > 스마트발송에서 작성한 값을 입력해주세요.
+ * @property {(result: { type: NotificationAgreementResult }) => void} onEvent - 알림 동의 결과를 콜백으로 전달해요.
+ * @property {(error: unknown) => void | Promise<void>} onError - 알림 동의 요청 시 에러가 발생하면 콜백으로 전달해요.
+ */
+interface RequestNotificationAgreementOptions {
+    options: {
+        templateCode: string;
+    };
+    onEvent: (result: {
+        type: NotificationAgreementResult;
+    }) => void;
+    onError: (error: unknown) => void | Promise<void>;
+}
+/**
+ * @public
+ * @category 알림
+ * @name requestNotificationAgreement
+ * @description 알림 동의 화면을 요청하고, 동의 결과를 콜백으로 전달해요.
+ * @param {RequestNotificationAgreementOptions} params - 템플릿 코드와 콜백이에요.
+ * @returns {() => void} 앱브릿지 콜백을 해제하는 함수예요.
+ *
+ * @example
+ * ```ts
+ * import { requestNotificationAgreement } from '@apps-in-toss/framework';
+ *
+ * const cleanup = requestNotificationAgreement({
+ *   options: { templateCode: 'test-template-code' },
+ *   onEvent: (result) => {
+ *     console.log(result);
+ *     cleanup();
+ *   },
+ *   onError: (error) => {
+ *     console.error(error);
+ *     cleanup();
+ *   },
+ * });
+ * ```
+ */
+declare function requestNotificationAgreement(params: RequestNotificationAgreementOptions): () => void;
+
+/**
+ * @public
+ * @category 토스페이
+ * @name RequestTossPayPaysBillingOptions
+ * @description 토스페이 정기결제창을 띄울 때 필요한 옵션이에요.
+ * @property {string} wrappedToken 정기결제 래핑 토큰이에요.
+ */
+interface RequestTossPayPaysBillingOptions {
+    /**
+     * 정기결제 래핑 토큰이에요.
+     */
+    wrappedToken: string;
+}
+/**
+ * @public
+ * @category 토스페이
+ * @name RequestTossPayPaysBillingResult
+ * @description 토스페이 정기결제창에서 사용자가 인증에 성공했는지 여부예요.
+ * @property {boolean} success 인증이 성공했는지 여부예요.
+ * @property {string} [reason] 인증이 실패했을 경우의 이유예요.
+ */
+interface RequestTossPayPaysBillingResult {
+    /**
+     * 인증이 성공했는지 여부예요.
+     */
+    success: boolean;
+    /**
+     * 인증이 실패했을 경우의 이유예요.
+     */
+    reason?: string;
+}
+/**
+ * @public
+ * @category 토스페이
+ * @name requestTossPayPaysBilling
+ * @description 토스페이 정기결제창을 띄우고, 사용자 인증을 수행해요. 인증이 완료되면 성공 여부를 반환해요.
+ *
+ * 이 함수는 결제창을 통해 사용자 인증만 해요. 실제 결제 처리는 인증 성공 후 서버에서 별도로 해야 해요.
+ *
+ * @property {() => boolean} isSupported 현재 앱 버전이 이 기능을 지원하는지 확인하는 함수예요.
+ * @param {RequestTossPayPaysBillingOptions} options 정기결제창을 띄울 때 필요한 옵션이에요.
+ * @returns {Promise<RequestTossPayPaysBillingResult>} 인증 성공 여부를 포함한 결과를 반환해요.
+ *
+ * @example
+ *
+ * ### 토스페이 정기결제창 띄우고 인증 처리하기
+ *
+ * ```tsx
+ * import { TossPay } from '@apps-in-toss/framework';
+ *
+ * async function handleBilling() {
+ *   try {
+ *     // 실제 구현 시 정기결제 생성 역할을 하는 API 엔드포인트로 대체해주세요.
+ *     const { wrappedToken } = await fetch('/my-api/billing/create').then(res => res.json());
+ *
+ *     const { success, reason } = await TossPay.requestTossPayPaysBilling({ wrappedToken });
+ *
+ *     if (success) {
+ *       // 실제 구현 시 정기결제를 실행하는 API 엔드포인트로 대체해주세요.
+ *       await fetch('/my-api/billing/execute', {
+ *         method: 'POST',
+ *         body: JSON.stringify({ wrappedToken }),
+ *         headers: { 'Content-Type': 'application/json' },
+ *       });
+ *     } else {
+ *       console.log('인증 실패:', reason);
+ *     }
+ *   } catch (error) {
+ *     console.error('정기결제 인증 중 오류가 발생했어요:', error);
+ *   }
+ * }
+ * ```
+ */
+declare function requestTossPayPaysBilling(options: {
+    params: RequestTossPayPaysBillingOptions;
+}): Promise<RequestTossPayPaysBillingResult | undefined>;
+declare namespace requestTossPayPaysBilling {
+    var isSupported: () => boolean;
+}
+
 interface SaveBase64DataParams {
     data: string;
     fileName: string;
@@ -1101,6 +1232,7 @@ interface AsyncMethodsMap {
         referrer: 'DEFAULT' | 'SANDBOX';
     }>;
     checkoutPayment: (params: CheckoutPaymentOptions) => Promise<CheckoutPaymentResult>;
+    requestTossPayPaysBilling: (params: RequestTossPayPaysBillingOptions) => Promise<RequestTossPayPaysBillingResult>;
     setDeviceOrientation: (params: {
         type: 'portrait' | 'landscape';
     }) => Promise<void>;
@@ -1153,6 +1285,7 @@ interface AsyncMethodsMap {
     requestMiniAppReview: (params: {
         title: string;
     }) => Promise<void>;
+    requestNotificationAgreement: (params: RequestNotificationAgreementOptions) => Promise<void>;
 }
 /**
  * Sync Methods Map
@@ -2864,9 +2997,11 @@ declare namespace requestReview {
  * @name TossPay
  * @description 토스페이 결제 관련 함수를 모아둔 객체예요.
  * @property {typeof checkoutPayment} [checkoutPayment] 토스페이 결제를 인증하는 함수예요. 자세한 내용은 [checkoutPayment](/react-native/reference/native-modules/토스페이/checkoutPayment)를 참고하세요.
+ * @property {typeof requestTossPayPaysBilling} [requestTossPayPaysBilling] 토스페이 정기결제를 인증하는 함수예요. 자세한 내용은 [requestTossPayPaysBilling](/react-native/reference/native-modules/토스페이/requestTossPayPaysBilling)를 참고하세요.
  */
 declare const TossPay: {
     checkoutPayment: typeof checkoutPayment;
+    requestTossPayPaysBilling: typeof requestTossPayPaysBilling;
 };
 
 /**
@@ -3315,4 +3450,4 @@ declare const INTERNAL__module: {
     tossCoreEventLog: typeof tossCoreEventLog;
 };
 
-export { type AppsInTossSignTossCertParams, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type ContactsViralParams, type CreateSubscriptionPurchaseOrderOptions, type EventLogParams, type GameCenterGameProfileResponse, type GetAnonymousKeyResponse, type GetAnonymousKeySuccessResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardErrorResponse, type GrantPromotionRewardErrorResult, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type GrantPromotionRewardResponse, type GrantPromotionRewardSuccessResponse, type HapticFeedbackType, IAP, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapCreateSubscriptionPurchaseOrderResult, type IapProductListItem, type IapSubscriptionInfoResult, type NetworkStatus, type NonConsumableProductListItem, type Primitive, type SaveBase64DataParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, type SubscriptionProductListItem, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionReward, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, requestReview, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };
+export { type AppsInTossSignTossCertParams, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type ContactsViralParams, type CreateSubscriptionPurchaseOrderOptions, type EventLogParams, type GameCenterGameProfileResponse, type GetAnonymousKeyResponse, type GetAnonymousKeySuccessResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardErrorResponse, type GrantPromotionRewardErrorResult, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type GrantPromotionRewardResponse, type GrantPromotionRewardSuccessResponse, type HapticFeedbackType, IAP, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapCreateSubscriptionPurchaseOrderResult, type IapProductListItem, type IapSubscriptionInfoResult, type NetworkStatus, type NonConsumableProductListItem, type NotificationAgreementResult, type Primitive, type RequestNotificationAgreementOptions, type RequestTossPayPaysBillingOptions, type RequestTossPayPaysBillingResult, type SaveBase64DataParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, type SubscriptionProductListItem, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionReward, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestNotificationAgreement, requestOneTimePurchase, requestReview, requestTossPayPaysBilling, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.d.ts

@@ -902,6 +902,137 @@ declare const IAP: {
     getSubscriptionInfo: typeof getSubscriptionInfo;
 };
 
+/**
+ * @public
+ * @category 알림
+ * @name NotificationAgreementResult
+ * @description 푸시 알림 동의 플로우의 결과예요.
+ * @property {'newAgreement'} newAgreement - 이번에 새로 동의한 경우예요.
+ * @property {'alreadyAgreed'} alreadyAgreed - 이미 동의한 사용자인 경우예요.
+ * @property {'agreementRejected'} agreementRejected - 사용자가 동의를 거부한 경우예요.
+ */
+type NotificationAgreementResult = 'newAgreement' | 'alreadyAgreed' | 'agreementRejected';
+/**
+ * @property {string} templateCode - 알림 동의를 받을 스마트발송 캠패인의 템플릿 코드예요. 코드는 앱인토스 콘솔 > 미니앱 > 스마트발송에서 작성한 값을 입력해주세요.
+ * @property {(result: { type: NotificationAgreementResult }) => void} onEvent - 알림 동의 결과를 콜백으로 전달해요.
+ * @property {(error: unknown) => void | Promise<void>} onError - 알림 동의 요청 시 에러가 발생하면 콜백으로 전달해요.
+ */
+interface RequestNotificationAgreementOptions {
+    options: {
+        templateCode: string;
+    };
+    onEvent: (result: {
+        type: NotificationAgreementResult;
+    }) => void;
+    onError: (error: unknown) => void | Promise<void>;
+}
+/**
+ * @public
+ * @category 알림
+ * @name requestNotificationAgreement
+ * @description 알림 동의 화면을 요청하고, 동의 결과를 콜백으로 전달해요.
+ * @param {RequestNotificationAgreementOptions} params - 템플릿 코드와 콜백이에요.
+ * @returns {() => void} 앱브릿지 콜백을 해제하는 함수예요.
+ *
+ * @example
+ * ```ts
+ * import { requestNotificationAgreement } from '@apps-in-toss/framework';
+ *
+ * const cleanup = requestNotificationAgreement({
+ *   options: { templateCode: 'test-template-code' },
+ *   onEvent: (result) => {
+ *     console.log(result);
+ *     cleanup();
+ *   },
+ *   onError: (error) => {
+ *     console.error(error);
+ *     cleanup();
+ *   },
+ * });
+ * ```
+ */
+declare function requestNotificationAgreement(params: RequestNotificationAgreementOptions): () => void;
+
+/**
+ * @public
+ * @category 토스페이
+ * @name RequestTossPayPaysBillingOptions
+ * @description 토스페이 정기결제창을 띄울 때 필요한 옵션이에요.
+ * @property {string} wrappedToken 정기결제 래핑 토큰이에요.
+ */
+interface RequestTossPayPaysBillingOptions {
+    /**
+     * 정기결제 래핑 토큰이에요.
+     */
+    wrappedToken: string;
+}
+/**
+ * @public
+ * @category 토스페이
+ * @name RequestTossPayPaysBillingResult
+ * @description 토스페이 정기결제창에서 사용자가 인증에 성공했는지 여부예요.
+ * @property {boolean} success 인증이 성공했는지 여부예요.
+ * @property {string} [reason] 인증이 실패했을 경우의 이유예요.
+ */
+interface RequestTossPayPaysBillingResult {
+    /**
+     * 인증이 성공했는지 여부예요.
+     */
+    success: boolean;
+    /**
+     * 인증이 실패했을 경우의 이유예요.
+     */
+    reason?: string;
+}
+/**
+ * @public
+ * @category 토스페이
+ * @name requestTossPayPaysBilling
+ * @description 토스페이 정기결제창을 띄우고, 사용자 인증을 수행해요. 인증이 완료되면 성공 여부를 반환해요.
+ *
+ * 이 함수는 결제창을 통해 사용자 인증만 해요. 실제 결제 처리는 인증 성공 후 서버에서 별도로 해야 해요.
+ *
+ * @property {() => boolean} isSupported 현재 앱 버전이 이 기능을 지원하는지 확인하는 함수예요.
+ * @param {RequestTossPayPaysBillingOptions} options 정기결제창을 띄울 때 필요한 옵션이에요.
+ * @returns {Promise<RequestTossPayPaysBillingResult>} 인증 성공 여부를 포함한 결과를 반환해요.
+ *
+ * @example
+ *
+ * ### 토스페이 정기결제창 띄우고 인증 처리하기
+ *
+ * ```tsx
+ * import { TossPay } from '@apps-in-toss/framework';
+ *
+ * async function handleBilling() {
+ *   try {
+ *     // 실제 구현 시 정기결제 생성 역할을 하는 API 엔드포인트로 대체해주세요.
+ *     const { wrappedToken } = await fetch('/my-api/billing/create').then(res => res.json());
+ *
+ *     const { success, reason } = await TossPay.requestTossPayPaysBilling({ wrappedToken });
+ *
+ *     if (success) {
+ *       // 실제 구현 시 정기결제를 실행하는 API 엔드포인트로 대체해주세요.
+ *       await fetch('/my-api/billing/execute', {
+ *         method: 'POST',
+ *         body: JSON.stringify({ wrappedToken }),
+ *         headers: { 'Content-Type': 'application/json' },
+ *       });
+ *     } else {
+ *       console.log('인증 실패:', reason);
+ *     }
+ *   } catch (error) {
+ *     console.error('정기결제 인증 중 오류가 발생했어요:', error);
+ *   }
+ * }
+ * ```
+ */
+declare function requestTossPayPaysBilling(options: {
+    params: RequestTossPayPaysBillingOptions;
+}): Promise<RequestTossPayPaysBillingResult | undefined>;
+declare namespace requestTossPayPaysBilling {
+    var isSupported: () => boolean;
+}
+
 interface SaveBase64DataParams {
     data: string;
     fileName: string;
@@ -1101,6 +1232,7 @@ interface AsyncMethodsMap {
         referrer: 'DEFAULT' | 'SANDBOX';
     }>;
     checkoutPayment: (params: CheckoutPaymentOptions) => Promise<CheckoutPaymentResult>;
+    requestTossPayPaysBilling: (params: RequestTossPayPaysBillingOptions) => Promise<RequestTossPayPaysBillingResult>;
     setDeviceOrientation: (params: {
         type: 'portrait' | 'landscape';
     }) => Promise<void>;
@@ -1153,6 +1285,7 @@ interface AsyncMethodsMap {
     requestMiniAppReview: (params: {
         title: string;
     }) => Promise<void>;
+    requestNotificationAgreement: (params: RequestNotificationAgreementOptions) => Promise<void>;
 }
 /**
  * Sync Methods Map
@@ -2864,9 +2997,11 @@ declare namespace requestReview {
  * @name TossPay
  * @description 토스페이 결제 관련 함수를 모아둔 객체예요.
  * @property {typeof checkoutPayment} [checkoutPayment] 토스페이 결제를 인증하는 함수예요. 자세한 내용은 [checkoutPayment](/react-native/reference/native-modules/토스페이/checkoutPayment)를 참고하세요.
+ * @property {typeof requestTossPayPaysBilling} [requestTossPayPaysBilling] 토스페이 정기결제를 인증하는 함수예요. 자세한 내용은 [requestTossPayPaysBilling](/react-native/reference/native-modules/토스페이/requestTossPayPaysBilling)를 참고하세요.
  */
 declare const TossPay: {
     checkoutPayment: typeof checkoutPayment;
+    requestTossPayPaysBilling: typeof requestTossPayPaysBilling;
 };
 
 /**
@@ -3315,4 +3450,4 @@ declare const INTERNAL__module: {
     tossCoreEventLog: typeof tossCoreEventLog;
 };
 
-export { type AppsInTossSignTossCertParams, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type ContactsViralParams, type CreateSubscriptionPurchaseOrderOptions, type EventLogParams, type GameCenterGameProfileResponse, type GetAnonymousKeyResponse, type GetAnonymousKeySuccessResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardErrorResponse, type GrantPromotionRewardErrorResult, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type GrantPromotionRewardResponse, type GrantPromotionRewardSuccessResponse, type HapticFeedbackType, IAP, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapCreateSubscriptionPurchaseOrderResult, type IapProductListItem, type IapSubscriptionInfoResult, type NetworkStatus, type NonConsumableProductListItem, type Primitive, type SaveBase64DataParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, type SubscriptionProductListItem, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionReward, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, requestReview, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };
+export { type AppsInTossSignTossCertParams, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type ContactsViralParams, type CreateSubscriptionPurchaseOrderOptions, type EventLogParams, type GameCenterGameProfileResponse, type GetAnonymousKeyResponse, type GetAnonymousKeySuccessResponse, type GetUserKeyForGameErrorResponse, type GetUserKeyForGameResponse, type GetUserKeyForGameSuccessResponse, GoogleAdMob, type GrantPromotionRewardErrorResponse, type GrantPromotionRewardErrorResult, type GrantPromotionRewardForGameErrorResponse, type GrantPromotionRewardForGameErrorResult, type GrantPromotionRewardForGameResponse, type GrantPromotionRewardForGameSuccessResponse, type GrantPromotionRewardResponse, type GrantPromotionRewardSuccessResponse, type HapticFeedbackType, IAP, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapCreateSubscriptionPurchaseOrderResult, type IapProductListItem, type IapSubscriptionInfoResult, type NetworkStatus, type NonConsumableProductListItem, type NotificationAgreementResult, type Primitive, type RequestNotificationAgreementOptions, type RequestTossPayPaysBillingOptions, type RequestTossPayPaysBillingResult, type SaveBase64DataParams, Storage, type SubmitGameCenterLeaderBoardScoreResponse, type SubscriptionProductListItem, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, appsInTossSignTossCert, checkoutPayment, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getAnonymousKey, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getGroupId, getIsTossLoginIntegratedService, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getServerTime, getTossAppVersion, getTossShareLink, getUserKeyForGame, grantPromotionReward, grantPromotionRewardForGame, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestNotificationAgreement, requestOneTimePurchase, requestReview, requestTossPayPaysBilling, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.js

@@ -411,6 +411,17 @@ async function checkoutPayment(options) {
   return safePostMessage("checkoutPayment", options.params);
 }
 
+// src/MiniAppModule/native-modules/requestTossPayPaysBilling.ts
+var MIN_VERSION = { android: "5.256.0", ios: "5.256.0" };
+async function requestTossPayPaysBilling(options) {
+  if (!requestTossPayPaysBilling.isSupported()) {
+    console.warn("requestTossPayPaysBilling is not supported in this app version");
+    return;
+  }
+  return safePostMessage("requestTossPayPaysBilling", options.params);
+}
+requestTossPayPaysBilling.isSupported = () => isMinVersionSupported(MIN_VERSION);
+
 // src/MiniAppModule/native-modules/appLogin.ts
 async function appLogin() {
   return safePostMessage("appLogin", {});
@@ -981,7 +992,7 @@ async function getServerTime() {
 getServerTime.isSupported = () => isMinVersionSupported(GET_SERVER_TIME_MIN_VERSION);
 
 // src/MiniAppModule/native-modules/requestReview.ts
-var MIN_VERSION = { android: "5.253.0", ios: "5.253.0" };
+var MIN_VERSION2 = { android: "5.253.0", ios: "5.253.0" };
 async function requestReview() {
   const isSupported = requestReview.isSupported();
   if (!isSupported) {
@@ -993,11 +1004,33 @@ async function requestReview() {
   }
   return safePostMessage("requestMiniAppReview", { title: brandDisplayName });
 }
-requestReview.isSupported = () => isMinVersionSupported(MIN_VERSION);
+requestReview.isSupported = () => isMinVersionSupported(MIN_VERSION2);
+
+// src/MiniAppModule/native-modules/requestNotificationAgreement.ts
+import { noop as noop3 } from "es-toolkit";
+var MIN_VERSION3 = { android: "5.255.0", ios: "5.255.0" };
+function isRequestNotificationAgreementSupported() {
+  return isMinVersionSupported(MIN_VERSION3);
+}
+function requestNotificationAgreement(params) {
+  if (!isRequestNotificationAgreementSupported()) {
+    return noop3;
+  }
+  const { options, onEvent, onError } = params;
+  return INTERNAL__appBridgeHandler.invokeAppBridgeMethod("requestNotificationAgreement", options, {
+    onSuccess: (result) => {
+      onEvent({ type: result.agreementResult });
+    },
+    onError: (error) => {
+      onError(error);
+    }
+  });
+}
 
 // src/MiniAppModule/native-modules/index.ts
 var TossPay = {
-  checkoutPayment
+  checkoutPayment,
+  requestTossPayPaysBilling
 };
 var GoogleAdMob = {
   loadAppsInTossAdMob,
@@ -1152,8 +1185,10 @@ export {
   openGameCenterLeaderboard,
   openURL2 as openURL,
   processProductGrant,
+  requestNotificationAgreement,
   requestOneTimePurchase,
   requestReview,
+  requestTossPayPaysBilling,
   safePostMessage,
   safeSyncPostMessage,
   saveBase64Data,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/native-modules",
   "type": "module",
-  "version": "2.4.7",
+  "version": "2.5.0",
   "description": "Native Modules for Apps In Toss",
   "scripts": {
     "typecheck": "tsc --noEmit",
@@ -29,8 +29,8 @@
   ],
   "devDependencies": {
     "@babel/runtime": "^7",
-    "@granite-js/native": "1.0.18",
-    "@granite-js/react-native": "1.0.18",
+    "@granite-js/native": "1.0.20",
+    "@granite-js/react-native": "1.0.20",
     "@types/react": "19.2.3",
     "dts-bundle-generator": "^9.5.1",
     "esbuild": "0.25.5",
@@ -42,8 +42,8 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@apps-in-toss/types": "2.4.7",
-    "brick-module": "0.5.0",
+    "@apps-in-toss/types": "2.5.0",
+    "brick-module": "0.5.2",
     "es-toolkit": "^1.39.3"
   },
   "peerDependencies": {

package/src/MiniAppModule/native-modules/index.ts

@@ -13,6 +13,11 @@ import {
 } from './ads/googleAdMobV2';
 // TossPay
 import { checkoutPayment, type CheckoutPaymentOptions, type CheckoutPaymentResult } from './checkoutPayment';
+import {
+  requestTossPayPaysBilling,
+  type RequestTossPayPaysBillingOptions,
+  type RequestTossPayPaysBillingResult,
+} from './requestTossPayPaysBilling';
 
 export * from './appLogin';
 export * from './eventLog';
@@ -48,10 +53,13 @@ export * from './getGroupId';
 export * from './shareWithScheme';
 export * from './getServerTime';
 export * from './requestReview';
+export * from './requestNotificationAgreement';
 
 export type {
   CheckoutPaymentOptions,
   CheckoutPaymentResult,
+  RequestTossPayPaysBillingOptions,
+  RequestTossPayPaysBillingResult,
   LoadAdMobParams,
   LoadAdMobOptions,
   LoadAdMobEvent,
@@ -67,12 +75,15 @@ export type {
  * @name TossPay
  * @description 토스페이 결제 관련 함수를 모아둔 객체예요.
  * @property {typeof checkoutPayment} [checkoutPayment] 토스페이 결제를 인증하는 함수예요. 자세한 내용은 [checkoutPayment](/react-native/reference/native-modules/토스페이/checkoutPayment)를 참고하세요.
+ * @property {typeof requestTossPayPaysBilling} [requestTossPayPaysBilling] 토스페이 정기결제를 인증하는 함수예요. 자세한 내용은 [requestTossPayPaysBilling](/react-native/reference/native-modules/토스페이/requestTossPayPaysBilling)를 참고하세요.
  */
 export const TossPay = {
   checkoutPayment,
+  requestTossPayPaysBilling,
 };
 
 export * from './checkoutPayment';
+export * from './requestTossPayPaysBilling';
 
 /**
  * @public

package/src/MiniAppModule/native-modules/requestNotificationAgreement.ts

@@ -0,0 +1,73 @@
+import { noop } from 'es-toolkit';
+import { isMinVersionSupported } from './isMinVersionSupported';
+import { INTERNAL__appBridgeHandler } from '../native-event-emitter/internal/appBridge';
+
+const MIN_VERSION = { android: '5.255.0', ios: '5.255.0' } as const;
+
+function isRequestNotificationAgreementSupported() {
+  return isMinVersionSupported(MIN_VERSION);
+}
+
+/**
+ * @public
+ * @category 알림
+ * @name NotificationAgreementResult
+ * @description 푸시 알림 동의 플로우의 결과예요.
+ * @property {'newAgreement'} newAgreement - 이번에 새로 동의한 경우예요.
+ * @property {'alreadyAgreed'} alreadyAgreed - 이미 동의한 사용자인 경우예요.
+ * @property {'agreementRejected'} agreementRejected - 사용자가 동의를 거부한 경우예요.
+ */
+export type NotificationAgreementResult = 'newAgreement' | 'alreadyAgreed' | 'agreementRejected';
+
+/**
+ * @property {string} templateCode - 알림 동의를 받을 스마트발송 캠패인의 템플릿 코드예요. 코드는 앱인토스 콘솔 > 미니앱 > 스마트발송에서 작성한 값을 입력해주세요.
+ * @property {(result: { type: NotificationAgreementResult }) => void} onEvent - 알림 동의 결과를 콜백으로 전달해요.
+ * @property {(error: unknown) => void | Promise<void>} onError - 알림 동의 요청 시 에러가 발생하면 콜백으로 전달해요.
+ */
+export interface RequestNotificationAgreementOptions {
+  options: { templateCode: string };
+  onEvent: (result: { type: NotificationAgreementResult }) => void;
+  onError: (error: unknown) => void | Promise<void>;
+}
+
+/**
+ * @public
+ * @category 알림
+ * @name requestNotificationAgreement
+ * @description 알림 동의 화면을 요청하고, 동의 결과를 콜백으로 전달해요.
+ * @param {RequestNotificationAgreementOptions} params - 템플릿 코드와 콜백이에요.
+ * @returns {() => void} 앱브릿지 콜백을 해제하는 함수예요.
+ *
+ * @example
+ * ```ts
+ * import { requestNotificationAgreement } from '@apps-in-toss/framework';
+ *
+ * const cleanup = requestNotificationAgreement({
+ *   options: { templateCode: 'test-template-code' },
+ *   onEvent: (result) => {
+ *     console.log(result);
+ *     cleanup();
+ *   },
+ *   onError: (error) => {
+ *     console.error(error);
+ *     cleanup();
+ *   },
+ * });
+ * ```
+ */
+export function requestNotificationAgreement(params: RequestNotificationAgreementOptions): () => void {
+  if (!isRequestNotificationAgreementSupported()) {
+    return noop;
+  }
+
+  const { options, onEvent, onError } = params;
+
+  return INTERNAL__appBridgeHandler.invokeAppBridgeMethod('requestNotificationAgreement', options, {
+    onSuccess: (result: { agreementResult: NotificationAgreementResult }) => {
+      onEvent({ type: result.agreementResult });
+    },
+    onError: (error: unknown) => {
+      onError(error);
+    },
+  });
+}

package/src/MiniAppModule/native-modules/requestTossPayPaysBilling.ts

@@ -0,0 +1,92 @@
+import { isMinVersionSupported } from './isMinVersionSupported';
+import { safePostMessage } from '../../natives';
+
+const MIN_VERSION = { android: '5.256.0', ios: '5.256.0' } as const;
+
+/**
+ * @public
+ * @category 토스페이
+ * @name RequestTossPayPaysBillingOptions
+ * @description 토스페이 정기결제창을 띄울 때 필요한 옵션이에요.
+ * @property {string} wrappedToken 정기결제 래핑 토큰이에요.
+ */
+export interface RequestTossPayPaysBillingOptions {
+  /**
+   * 정기결제 래핑 토큰이에요.
+   */
+  wrappedToken: string;
+}
+
+/**
+ * @public
+ * @category 토스페이
+ * @name RequestTossPayPaysBillingResult
+ * @description 토스페이 정기결제창에서 사용자가 인증에 성공했는지 여부예요.
+ * @property {boolean} success 인증이 성공했는지 여부예요.
+ * @property {string} [reason] 인증이 실패했을 경우의 이유예요.
+ */
+export interface RequestTossPayPaysBillingResult {
+  /**
+   * 인증이 성공했는지 여부예요.
+   */
+  success: boolean;
+
+  /**
+   * 인증이 실패했을 경우의 이유예요.
+   */
+  reason?: string;
+}
+
+/**
+ * @public
+ * @category 토스페이
+ * @name requestTossPayPaysBilling
+ * @description 토스페이 정기결제창을 띄우고, 사용자 인증을 수행해요. 인증이 완료되면 성공 여부를 반환해요.
+ *
+ * 이 함수는 결제창을 통해 사용자 인증만 해요. 실제 결제 처리는 인증 성공 후 서버에서 별도로 해야 해요.
+ *
+ * @property {() => boolean} isSupported 현재 앱 버전이 이 기능을 지원하는지 확인하는 함수예요.
+ * @param {RequestTossPayPaysBillingOptions} options 정기결제창을 띄울 때 필요한 옵션이에요.
+ * @returns {Promise<RequestTossPayPaysBillingResult>} 인증 성공 여부를 포함한 결과를 반환해요.
+ *
+ * @example
+ *
+ * ### 토스페이 정기결제창 띄우고 인증 처리하기
+ *
+ * ```tsx
+ * import { TossPay } from '@apps-in-toss/framework';
+ *
+ * async function handleBilling() {
+ *   try {
+ *     // 실제 구현 시 정기결제 생성 역할을 하는 API 엔드포인트로 대체해주세요.
+ *     const { wrappedToken } = await fetch('/my-api/billing/create').then(res => res.json());
+ *
+ *     const { success, reason } = await TossPay.requestTossPayPaysBilling({ wrappedToken });
+ *
+ *     if (success) {
+ *       // 실제 구현 시 정기결제를 실행하는 API 엔드포인트로 대체해주세요.
+ *       await fetch('/my-api/billing/execute', {
+ *         method: 'POST',
+ *         body: JSON.stringify({ wrappedToken }),
+ *         headers: { 'Content-Type': 'application/json' },
+ *       });
+ *     } else {
+ *       console.log('인증 실패:', reason);
+ *     }
+ *   } catch (error) {
+ *     console.error('정기결제 인증 중 오류가 발생했어요:', error);
+ *   }
+ * }
+ * ```
+ */
+export async function requestTossPayPaysBilling(options: {
+  params: RequestTossPayPaysBillingOptions;
+}): Promise<RequestTossPayPaysBillingResult | undefined> {
+  if (!requestTossPayPaysBilling.isSupported()) {
+    console.warn('requestTossPayPaysBilling is not supported in this app version');
+    return;
+  }
+
+  return safePostMessage('requestTossPayPaysBilling', options.params);
+}
+requestTossPayPaysBilling.isSupported = () => isMinVersionSupported(MIN_VERSION);

package/src/MiniAppModule/postMessage.ts

@@ -14,6 +14,11 @@ import type { GameCenterGameProfileResponse } from './native-modules/getGameCent
 import type { GetUserKeyForGameResponse } from './native-modules/getUserKeyForGame';
 import type { GrantPromotionRewardForGameResponse } from './native-modules/grantPromotionRewardForGame';
 import type { IapCreateOneTimePurchaseOrderResult, IapSubscriptionInfoResult } from './native-modules/iap';
+import type { RequestNotificationAgreementOptions } from './native-modules/requestNotificationAgreement';
+import type {
+  RequestTossPayPaysBillingOptions,
+  RequestTossPayPaysBillingResult,
+} from './native-modules/requestTossPayPaysBilling';
 import type { SaveBase64DataParams } from './native-modules/saveBase64Data';
 import type { SubmitGameCenterLeaderBoardScoreResponse } from './native-modules/submitGameCenterLeaderBoardScore';
 import { MiniAppModule } from '../spec/MiniAppModule.brick';
@@ -66,6 +71,7 @@ export interface AsyncMethodsMap {
     params: CompatiblePlaceholderArgument
   ) => Promise<{ authorizationCode: string; referrer: 'DEFAULT' | 'SANDBOX' }>;
   checkoutPayment: (params: CheckoutPaymentOptions) => Promise<CheckoutPaymentResult>;
+  requestTossPayPaysBilling: (params: RequestTossPayPaysBillingOptions) => Promise<RequestTossPayPaysBillingResult>;
   setDeviceOrientation: (params: { type: 'portrait' | 'landscape' }) => Promise<void>;
   saveBase64Data: (params: SaveBase64DataParams) => Promise<void>;
   appsInTossSignTossCert: (params: AppsInTossSignTossCertParams) => Promise<void>;
@@ -82,7 +88,7 @@ export interface AsyncMethodsMap {
     score: string;
   }) => Promise<SubmitGameCenterLeaderBoardScoreResponse | undefined>;
 
-  // INTERNAL__appBridgeHandler methods (9)
+  // INTERNAL__appBridgeHandler methods (10)
   requestOneTimePurchase: (params: { sku: string }) => Promise<void>;
   contactsViral: (params: { moduleId: string }) => Promise<void>;
   getMiniAppsSupportContact: (params: object) => Promise<void>;
@@ -97,6 +103,7 @@ export interface AsyncMethodsMap {
   getServerTime: (params: CompatiblePlaceholderArgument) => Promise<{ serverTime: number }>;
   shareWithScheme: (params: { schemeURL: string }) => Promise<void>;
   requestMiniAppReview: (params: { title: string }) => Promise<void>;
+  requestNotificationAgreement: (params: RequestNotificationAgreementOptions) => Promise<void>;
 }
 
 /**

package/src/async-bridges.ts

@@ -23,6 +23,7 @@ export * from './MiniAppModule/native-modules/eventLog';
 export * from './MiniAppModule/native-modules/getTossShareLink';
 export * from './MiniAppModule/native-modules/setDeviceOrientation';
 export * from './MiniAppModule/native-modules/checkoutPayment';
+export * from './MiniAppModule/native-modules/requestTossPayPaysBilling';
 export * from './MiniAppModule/native-modules/saveBase64Data';
 export * from './MiniAppModule/native-modules/appsInTossSignTossCert';
 export * from './MiniAppModule/native-modules/getGameCenterGameProfile';