@apps-in-toss/native-modules 2.1.1 → 2.2.0

package/dist/index.cjs

@@ -784,6 +784,16 @@ async function completeProductGrant(params) {
   }
   return safePostMessage("completeProductGrant", params.params);
 }
+async function getSubscriptionInfo(params) {
+  const isSupported = isMinVersionSupported({
+    android: "5.253.0",
+    ios: "5.250.0"
+  });
+  if (!isSupported) {
+    return;
+  }
+  return safePostMessage("getSubscriptionInfo", params);
+}
 function createSubscriptionPurchaseOrder(params) {
   const isSupported = isMinVersionSupported({
     android: "5.248.0",
@@ -818,7 +828,8 @@ var IAP = {
   getProductItemList,
   getPendingOrders,
   getCompletedOrRefundedOrders,
-  completeProductGrant
+  completeProductGrant,
+  getSubscriptionInfo
 };
 
 // src/MiniAppModule/native-modules/saveBase64Data.ts

package/dist/index.d.cts

@@ -741,6 +741,57 @@ declare function completeProductGrant(params: {
         orderId: string;
     };
 }): Promise<boolean | undefined>;
+/**
+ * @public
+ * @category 인앱결제
+ * @name IapSubscriptionInfoResult
+ * @description 구독 주문의 현재 상태 정보를 담은 객체예요.
+ * @property {number} catalogId 구독 상품의 식별자예요.
+ * @property {"ACTIVE" |"EXPIRED"|"IN_GRACE_PERIOD"|"ON_HOLD"|"PAUSED"|"REVOKED"} status 구독 상태를 나타내는 값이에요.
+ * @property {string | null} expiresAt 구독 만료 예정 시각이에요. 만료 정보가 없으면 `null`이에요.
+ * @property {boolean} isAutoRenew 구독 자동 갱신 여부예요.
+ * @property {string | null} gracePeriodExpiresAt 결제 유예 기간 만료 시각이에요. 유예 기간이 없으면 `null`이에요.
+ * @property {boolean} isAccessible 현재 구독 상품을 이용할 수 있는지 여부예요.
+ */
+interface IapSubscriptionInfoResult {
+    catalogId: number;
+    status: 'ACTIVE' | 'EXPIRED' | 'IN_GRACE_PERIOD' | 'ON_HOLD' | 'PAUSED' | 'REVOKED';
+    expiresAt: string | null;
+    isAutoRenew: boolean;
+    gracePeriodExpiresAt: string | null;
+    isAccessible: boolean;
+}
+/**
+ * @public
+ * @category 인앱결제
+ * @name getSubscriptionInfo
+ * @description 구독 주문의 현재 상태 정보를 가져와요.
+ * @param {{ params: { orderId: string } }} params 조회할 구독 주문 정보를 담은 객체예요.
+ * @param {string} params.orderId 주문의 고유 ID예요.
+ * @returns {Promise<{ subscription: IapSubscriptionInfoResult } | undefined>} 구독 상태 정보를 담은 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.253.0, iOS 5.250.0)보다 낮으면 `undefined`를 반환해요.
+ *
+ * @example
+ * ### 주문 ID로 구독 상태 조회하기
+ * ```typescript
+ * import { IAP } from '@apps-in-toss/framework';
+ *
+ * async function fetchSubscriptionInfo(orderId: string) {
+ *   try {
+ *     const response = await IAP.getSubscriptionInfo({ params: { orderId } });
+ *     return response?.subscription;
+ *   } catch (error) {
+ *     console.error(error);
+ *   }
+ * }
+ * ```
+ */
+declare function getSubscriptionInfo(params: {
+    params: {
+        orderId: string;
+    };
+}): Promise<{
+    subscription: IapSubscriptionInfoResult;
+} | undefined>;
 /**
  * @public
  * @category 인앱결제
@@ -835,6 +886,7 @@ declare function createSubscriptionPurchaseOrder(params: CreateSubscriptionPurch
  * @property {typeof getPendingOrders} [getPendingOrders] 대기 중인 주문 목록을 가져와요. 자세한 내용은 [getPendingOrders](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/getPendingOrders.htm) 문서를 참고하세요.
  * @property {typeof getCompletedOrRefundedOrders} [getCompletedOrRefundedOrders] 인앱결제로 구매하거나 환불한 주문 목록을 가져와요. 자세한 내용은 [getCompletedOrRefundedOrders](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/getCompletedOrRefundedOrders.html) 문서를 참고하세요.
  * @property {typeof completeProductGrant} [completeProductGrant] 상품 지급 처리를 완료했다는 메시지를 앱에 전달해요. 자세한 내용은 [completeProductGrant](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/completeProductGrant.html) 문서를 참고하세요.
+ * @property {typeof getSubscriptionInfo} [getSubscriptionInfo] 구독 주문의 현재 상태 정보를 가져와요.
  */
 declare const IAP: {
     createOneTimePurchaseOrder: typeof createOneTimePurchaseOrder;
@@ -843,6 +895,7 @@ declare const IAP: {
     getPendingOrders: typeof getPendingOrders;
     getCompletedOrRefundedOrders: typeof getCompletedOrRefundedOrders;
     completeProductGrant: typeof completeProductGrant;
+    getSubscriptionInfo: typeof getSubscriptionInfo;
 };
 
 interface SaveBase64DataParams {
@@ -1024,6 +1077,13 @@ interface AsyncMethodsMap {
     completeProductGrant: (params: {
         orderId: string;
     }) => Promise<boolean>;
+    getSubscriptionInfo: (params: {
+        params: {
+            orderId: string;
+        };
+    }) => Promise<{
+        subscription: IapSubscriptionInfoResult;
+    }>;
     eventLog: (params: {
         log_name: string;
         log_type: string;
@@ -3233,4 +3293,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 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 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, 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, 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 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, 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, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.d.ts

@@ -741,6 +741,57 @@ declare function completeProductGrant(params: {
         orderId: string;
     };
 }): Promise<boolean | undefined>;
+/**
+ * @public
+ * @category 인앱결제
+ * @name IapSubscriptionInfoResult
+ * @description 구독 주문의 현재 상태 정보를 담은 객체예요.
+ * @property {number} catalogId 구독 상품의 식별자예요.
+ * @property {"ACTIVE" |"EXPIRED"|"IN_GRACE_PERIOD"|"ON_HOLD"|"PAUSED"|"REVOKED"} status 구독 상태를 나타내는 값이에요.
+ * @property {string | null} expiresAt 구독 만료 예정 시각이에요. 만료 정보가 없으면 `null`이에요.
+ * @property {boolean} isAutoRenew 구독 자동 갱신 여부예요.
+ * @property {string | null} gracePeriodExpiresAt 결제 유예 기간 만료 시각이에요. 유예 기간이 없으면 `null`이에요.
+ * @property {boolean} isAccessible 현재 구독 상품을 이용할 수 있는지 여부예요.
+ */
+interface IapSubscriptionInfoResult {
+    catalogId: number;
+    status: 'ACTIVE' | 'EXPIRED' | 'IN_GRACE_PERIOD' | 'ON_HOLD' | 'PAUSED' | 'REVOKED';
+    expiresAt: string | null;
+    isAutoRenew: boolean;
+    gracePeriodExpiresAt: string | null;
+    isAccessible: boolean;
+}
+/**
+ * @public
+ * @category 인앱결제
+ * @name getSubscriptionInfo
+ * @description 구독 주문의 현재 상태 정보를 가져와요.
+ * @param {{ params: { orderId: string } }} params 조회할 구독 주문 정보를 담은 객체예요.
+ * @param {string} params.orderId 주문의 고유 ID예요.
+ * @returns {Promise<{ subscription: IapSubscriptionInfoResult } | undefined>} 구독 상태 정보를 담은 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.253.0, iOS 5.250.0)보다 낮으면 `undefined`를 반환해요.
+ *
+ * @example
+ * ### 주문 ID로 구독 상태 조회하기
+ * ```typescript
+ * import { IAP } from '@apps-in-toss/framework';
+ *
+ * async function fetchSubscriptionInfo(orderId: string) {
+ *   try {
+ *     const response = await IAP.getSubscriptionInfo({ params: { orderId } });
+ *     return response?.subscription;
+ *   } catch (error) {
+ *     console.error(error);
+ *   }
+ * }
+ * ```
+ */
+declare function getSubscriptionInfo(params: {
+    params: {
+        orderId: string;
+    };
+}): Promise<{
+    subscription: IapSubscriptionInfoResult;
+} | undefined>;
 /**
  * @public
  * @category 인앱결제
@@ -835,6 +886,7 @@ declare function createSubscriptionPurchaseOrder(params: CreateSubscriptionPurch
  * @property {typeof getPendingOrders} [getPendingOrders] 대기 중인 주문 목록을 가져와요. 자세한 내용은 [getPendingOrders](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/getPendingOrders.htm) 문서를 참고하세요.
  * @property {typeof getCompletedOrRefundedOrders} [getCompletedOrRefundedOrders] 인앱결제로 구매하거나 환불한 주문 목록을 가져와요. 자세한 내용은 [getCompletedOrRefundedOrders](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/getCompletedOrRefundedOrders.html) 문서를 참고하세요.
  * @property {typeof completeProductGrant} [completeProductGrant] 상품 지급 처리를 완료했다는 메시지를 앱에 전달해요. 자세한 내용은 [completeProductGrant](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/completeProductGrant.html) 문서를 참고하세요.
+ * @property {typeof getSubscriptionInfo} [getSubscriptionInfo] 구독 주문의 현재 상태 정보를 가져와요.
  */
 declare const IAP: {
     createOneTimePurchaseOrder: typeof createOneTimePurchaseOrder;
@@ -843,6 +895,7 @@ declare const IAP: {
     getPendingOrders: typeof getPendingOrders;
     getCompletedOrRefundedOrders: typeof getCompletedOrRefundedOrders;
     completeProductGrant: typeof completeProductGrant;
+    getSubscriptionInfo: typeof getSubscriptionInfo;
 };
 
 interface SaveBase64DataParams {
@@ -1024,6 +1077,13 @@ interface AsyncMethodsMap {
     completeProductGrant: (params: {
         orderId: string;
     }) => Promise<boolean>;
+    getSubscriptionInfo: (params: {
+        params: {
+            orderId: string;
+        };
+    }) => Promise<{
+        subscription: IapSubscriptionInfoResult;
+    }>;
     eventLog: (params: {
         log_name: string;
         log_type: string;
@@ -3233,4 +3293,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 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 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, 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, 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 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, 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, safePostMessage, safeSyncPostMessage, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, shareWithScheme, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.js

@@ -705,6 +705,16 @@ async function completeProductGrant(params) {
   }
   return safePostMessage("completeProductGrant", params.params);
 }
+async function getSubscriptionInfo(params) {
+  const isSupported = isMinVersionSupported({
+    android: "5.253.0",
+    ios: "5.250.0"
+  });
+  if (!isSupported) {
+    return;
+  }
+  return safePostMessage("getSubscriptionInfo", params);
+}
 function createSubscriptionPurchaseOrder(params) {
   const isSupported = isMinVersionSupported({
     android: "5.248.0",
@@ -739,7 +749,8 @@ var IAP = {
   getProductItemList,
   getPendingOrders,
   getCompletedOrRefundedOrders,
-  completeProductGrant
+  completeProductGrant,
+  getSubscriptionInfo
 };
 
 // src/MiniAppModule/native-modules/saveBase64Data.ts

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/native-modules",
   "type": "module",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "description": "Native Modules for Apps In Toss",
   "scripts": {
     "typecheck": "tsc --noEmit",
@@ -42,7 +42,7 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@apps-in-toss/types": "2.1.1",
+    "@apps-in-toss/types": "2.2.0",
     "brick-module": "0.5.0",
     "es-toolkit": "^1.39.3"
   },

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

@@ -520,6 +520,66 @@ async function completeProductGrant(params: { params: { orderId: string } }) {
   return safePostMessage('completeProductGrant', params.params);
 }
 
+/**
+ * @public
+ * @category 인앱결제
+ * @name IapSubscriptionInfoResult
+ * @description 구독 주문의 현재 상태 정보를 담은 객체예요.
+ * @property {number} catalogId 구독 상품의 식별자예요.
+ * @property {"ACTIVE" |"EXPIRED"|"IN_GRACE_PERIOD"|"ON_HOLD"|"PAUSED"|"REVOKED"} status 구독 상태를 나타내는 값이에요.
+ * @property {string | null} expiresAt 구독 만료 예정 시각이에요. 만료 정보가 없으면 `null`이에요.
+ * @property {boolean} isAutoRenew 구독 자동 갱신 여부예요.
+ * @property {string | null} gracePeriodExpiresAt 결제 유예 기간 만료 시각이에요. 유예 기간이 없으면 `null`이에요.
+ * @property {boolean} isAccessible 현재 구독 상품을 이용할 수 있는지 여부예요.
+ */
+export interface IapSubscriptionInfoResult {
+  catalogId: number;
+  status: 'ACTIVE' | 'EXPIRED' | 'IN_GRACE_PERIOD' | 'ON_HOLD' | 'PAUSED' | 'REVOKED';
+  expiresAt: string | null;
+  isAutoRenew: boolean;
+  gracePeriodExpiresAt: string | null;
+  isAccessible: boolean;
+}
+
+/**
+ * @public
+ * @category 인앱결제
+ * @name getSubscriptionInfo
+ * @description 구독 주문의 현재 상태 정보를 가져와요.
+ * @param {{ params: { orderId: string } }} params 조회할 구독 주문 정보를 담은 객체예요.
+ * @param {string} params.orderId 주문의 고유 ID예요.
+ * @returns {Promise<{ subscription: IapSubscriptionInfoResult } | undefined>} 구독 상태 정보를 담은 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.253.0, iOS 5.250.0)보다 낮으면 `undefined`를 반환해요.
+ *
+ * @example
+ * ### 주문 ID로 구독 상태 조회하기
+ * ```typescript
+ * import { IAP } from '@apps-in-toss/framework';
+ *
+ * async function fetchSubscriptionInfo(orderId: string) {
+ *   try {
+ *     const response = await IAP.getSubscriptionInfo({ params: { orderId } });
+ *     return response?.subscription;
+ *   } catch (error) {
+ *     console.error(error);
+ *   }
+ * }
+ * ```
+ */
+async function getSubscriptionInfo(params: {
+  params: { orderId: string };
+}): Promise<{ subscription: IapSubscriptionInfoResult } | undefined> {
+  const isSupported = isMinVersionSupported({
+    android: '5.253.0',
+    ios: '5.250.0',
+  });
+
+  if (!isSupported) {
+    return;
+  }
+
+  return safePostMessage('getSubscriptionInfo', params);
+}
+
 /**
  * @public
  * @category 인앱결제
@@ -646,6 +706,7 @@ function createSubscriptionPurchaseOrder(params: CreateSubscriptionPurchaseOrder
  * @property {typeof getPendingOrders} [getPendingOrders] 대기 중인 주문 목록을 가져와요. 자세한 내용은 [getPendingOrders](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/getPendingOrders.htm) 문서를 참고하세요.
  * @property {typeof getCompletedOrRefundedOrders} [getCompletedOrRefundedOrders] 인앱결제로 구매하거나 환불한 주문 목록을 가져와요. 자세한 내용은 [getCompletedOrRefundedOrders](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/getCompletedOrRefundedOrders.html) 문서를 참고하세요.
  * @property {typeof completeProductGrant} [completeProductGrant] 상품 지급 처리를 완료했다는 메시지를 앱에 전달해요. 자세한 내용은 [completeProductGrant](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/completeProductGrant.html) 문서를 참고하세요.
+ * @property {typeof getSubscriptionInfo} [getSubscriptionInfo] 구독 주문의 현재 상태 정보를 가져와요.
  */
 export const IAP = {
   createOneTimePurchaseOrder,
@@ -654,4 +715,5 @@ export const IAP = {
   getPendingOrders,
   getCompletedOrRefundedOrders,
   completeProductGrant,
+  getSubscriptionInfo,
 };

package/src/MiniAppModule/postMessage.ts

@@ -1,11 +1,11 @@
 import type {
   CompatiblePlaceholderArgument,
-  PermissionName,
-  PermissionAccess,
-  PermissionStatus,
-  ImageResponse,
   ContactResult,
+  ImageResponse,
   Location,
+  PermissionAccess,
+  PermissionName,
+  PermissionStatus,
 } from '@apps-in-toss/types';
 import { BrickModule } from 'brick-module';
 import type { AppsInTossSignTossCertParams } from './native-modules/appsInTossSignTossCert';
@@ -13,7 +13,7 @@ import type { CheckoutPaymentOptions, CheckoutPaymentResult } from './native-mod
 import type { GameCenterGameProfileResponse } from './native-modules/getGameCenterGameProfile';
 import type { GetUserKeyForGameResponse } from './native-modules/getUserKeyForGame';
 import type { GrantPromotionRewardForGameResponse } from './native-modules/grantPromotionRewardForGame';
-import type { IapCreateOneTimePurchaseOrderResult } from './native-modules/iap';
+import type { IapCreateOneTimePurchaseOrderResult, IapSubscriptionInfoResult } from './native-modules/iap';
 import type { SaveBase64DataParams } from './native-modules/saveBase64Data';
 import type { SubmitGameCenterLeaderBoardScoreResponse } from './native-modules/submitGameCenterLeaderBoardScore';
 import type { MiniAppModuleSpec } from '../spec/MiniAppModule.brick';
@@ -46,7 +46,7 @@ export interface AsyncMethodsMap {
   startUpdateLocation: (params: { accuracy: number; timeInterval: number; distanceInterval: number }) => Promise<void>;
   getCurrentLocation: (params: { accuracy: number }) => Promise<Location>;
 
-  // IAP (6)
+  // IAP (7)
   iapCreateOneTimePurchaseOrder: (params: { productId: string }) => Promise<IapCreateOneTimePurchaseOrderResult>;
   processProductGrant: (params: { orderId: string; isProductGranted: boolean }) => Promise<void>;
   iapGetProductItemList: (params: CompatiblePlaceholderArgument) => Promise<{ products: any[] }>;
@@ -55,6 +55,9 @@ export interface AsyncMethodsMap {
   ) => Promise<{ orders: Array<{ orderId: string; sku: string }> }>;
   getCompletedOrRefundedOrders: (params: { key?: string | null }) => Promise<any>;
   completeProductGrant: (params: { orderId: string }) => Promise<boolean>;
+  getSubscriptionInfo: (params: {
+    params: { orderId: string };
+  }) => Promise<{ subscription: IapSubscriptionInfoResult }>;
 
   // Other (9)
   eventLog: (params: { log_name: string; log_type: string; params: Record<string, string> }) => Promise<void>;