@apps-in-toss/native-modules 1.1.3 → 1.2.0

package/dist/index.cjs

@@ -47,7 +47,7 @@ __export(index_exports, {
   getNetworkStatus: () => getNetworkStatus,
   getOperationalEnvironment: () => getOperationalEnvironment,
   getPlatformOS: () => getPlatformOS,
-  getSchemeUri: () => getSchemeUri,
+  getSchemeUri: () => getSchemeUri2,
   getTossAppVersion: () => getTossAppVersion,
   getTossShareLink: () => getTossShareLink,
   iapCreateOneTimePurchaseOrder: () => iapCreateOneTimePurchaseOrder,
@@ -480,16 +480,33 @@ showAdMobRewardedAd.isSupported = createIsSupported();
 
 // src/AppsInTossModule/native-modules/ads/googleAdMobV2.ts
 var import_es_toolkit2 = require("es-toolkit");
+
+// src/utils/getReferrer.ts
+var import_react_native9 = require("@granite-js/react-native");
+function getReferrer() {
+  try {
+    return new URL((0, import_react_native9.getSchemeUri)()).searchParams.get("referrer");
+  } catch {
+    return null;
+  }
+}
+
+// src/AppsInTossModule/native-modules/ads/googleAdMobV2.ts
 function loadAppsInTossAdMob(params) {
   if (!loadAppsInTossAdMob.isSupported()) {
     params.onError(new Error(UNSUPPORTED_ERROR_MESSAGE2));
     return import_es_toolkit2.noop;
   }
   const { onEvent, onError, options } = params;
-  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod("loadAppsInTossAdmob", options, {
-    onSuccess: (result) => onEvent({ type: "loaded", data: result }),
-    onError
-  });
+  const referrer = getReferrer();
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
+    "loadAppsInTossAdmob",
+    { ...options, referrer },
+    {
+      onSuccess: (result) => onEvent({ type: "loaded", data: result }),
+      onError
+    }
+  );
   return unregisterCallbacks;
 }
 function showAppsInTossAdMob(params) {
@@ -498,28 +515,33 @@ function showAppsInTossAdMob(params) {
     return import_es_toolkit2.noop;
   }
   const { onEvent, onError, options } = params;
-  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod("showAppsInTossAdmob", options, {
-    onAdClicked: () => {
-      onEvent({ type: "clicked" });
-    },
-    onAdDismissed: () => {
-      onEvent({ type: "dismissed" });
-    },
-    onAdFailedToShow: () => {
-      onEvent({ type: "failedToShow" });
-    },
-    onAdImpression: () => {
-      onEvent({ type: "impression" });
-    },
-    onAdShow: () => {
-      onEvent({ type: "show" });
-    },
-    onUserEarnedReward: (data) => {
-      onEvent({ type: "userEarnedReward", data });
-    },
-    onSuccess: () => onEvent({ type: "requested" }),
-    onError
-  });
+  const referrer = getReferrer();
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
+    "showAppsInTossAdmob",
+    { ...options, referrer },
+    {
+      onAdClicked: () => {
+        onEvent({ type: "clicked" });
+      },
+      onAdDismissed: () => {
+        onEvent({ type: "dismissed" });
+      },
+      onAdFailedToShow: () => {
+        onEvent({ type: "failedToShow" });
+      },
+      onAdImpression: () => {
+        onEvent({ type: "impression" });
+      },
+      onAdShow: () => {
+        onEvent({ type: "show" });
+      },
+      onUserEarnedReward: (data) => {
+        onEvent({ type: "userEarnedReward", data });
+      },
+      onSuccess: () => onEvent({ type: "requested" }),
+      onError
+    }
+  );
   return unregisterCallbacks;
 }
 var ANDROID_GOOGLE_AD_MOB_SUPPORTED_VERSION2 = "5.227.0";
@@ -749,7 +771,7 @@ function createOneTimePurchaseOrder(params) {
     return import_es_toolkit3.noop;
   }
   const isProcessProductGrantSupported = isMinVersionSupported({
-    android: "5.230.0",
+    android: "5.231.1",
     ios: "5.230.0"
   });
   const { options, onEvent, onError } = params;
@@ -797,9 +819,31 @@ async function getProductItemList() {
   }
   return AppsInTossModule.iapGetProductItemList({});
 }
+async function getPendingOrders() {
+  const isSupported = isMinVersionSupported({
+    android: "5.231.0",
+    ios: "5.231.0"
+  });
+  if (!isSupported) {
+    return;
+  }
+  return AppsInTossModule.getPendingOrders({});
+}
+async function getCompletedOrRefundedOrders(params) {
+  const isSupported = isMinVersionSupported({
+    android: "5.231.0",
+    ios: "5.231.0"
+  });
+  if (!isSupported) {
+    return;
+  }
+  return AppsInTossModule.getCompletedOrRefundedOrders(params ?? { key: null });
+}
 var IAP = {
   createOneTimePurchaseOrder,
-  getProductItemList
+  getProductItemList,
+  getPendingOrders,
+  getCompletedOrRefundedOrders
 };
 
 // src/AppsInTossModule/native-modules/saveBase64Data.ts
@@ -851,7 +895,7 @@ var Storage = {
 };
 
 // src/AppsInTossModule/native-modules/openGameCenterLeaderboard.ts
-var import_react_native9 = require("@granite-js/react-native");
+var import_react_native10 = require("@granite-js/react-native");
 
 // src/AppsInTossModule/constants.ts
 var GAME_CENTER_MIN_VERSION = {
@@ -871,7 +915,7 @@ async function openGameCenterLeaderboard() {
   const url = new URL("servicetoss://game-center/leaderboard?_navbar=hide");
   url.searchParams.set("appName", appName);
   url.searchParams.set("referrer", `appsintoss.${appName}`);
-  return (0, import_react_native9.openURL)(url.toString());
+  return (0, import_react_native10.openURL)(url.toString());
 }
 
 // src/AppsInTossModule/native-modules/getGameCenterGameProfile.ts
@@ -944,8 +988,8 @@ function onVisibilityChangedByTransparentServiceWeb(eventParams) {
 }
 
 // src/BedrockModule/native-modules/natives/BedrockModule.ts
-var import_react_native10 = require("react-native");
-var BedrockModule = import_react_native10.NativeModules.BedrockModule;
+var import_react_native11 = require("react-native");
+var BedrockModule = import_react_native11.NativeModules.BedrockModule;
 
 // src/BedrockModule/native-modules/natives/closeView.ts
 async function closeView() {
@@ -953,10 +997,10 @@ async function closeView() {
 }
 
 // src/BedrockModule/native-modules/natives/getLocale.ts
-var import_react_native11 = require("react-native");
+var import_react_native12 = require("react-native");
 function getLocale() {
   const locale = BedrockModule?.DeviceInfo?.locale ?? "ko-KR";
-  if (import_react_native11.Platform.OS === "android") {
+  if (import_react_native12.Platform.OS === "android") {
     return replaceUnderbarToHypen(locale);
   }
   return locale;
@@ -966,7 +1010,7 @@ function replaceUnderbarToHypen(locale) {
 }
 
 // src/BedrockModule/native-modules/natives/getSchemeUri.ts
-function getSchemeUri() {
+function getSchemeUri2() {
   return BedrockModule.schemeUri;
 }
 
@@ -1004,24 +1048,24 @@ async function setIosSwipeGestureEnabled(options) {
 }
 
 // src/BedrockModule/native-modules/natives/openURL.ts
-var import_react_native12 = require("react-native");
+var import_react_native13 = require("react-native");
 function openURL2(url) {
-  return import_react_native12.Linking.openURL(url);
+  return import_react_native13.Linking.openURL(url);
 }
 
 // src/BedrockModule/native-modules/natives/getPlatformOS.ts
-var import_react_native13 = require("react-native");
+var import_react_native14 = require("react-native");
 function getPlatformOS() {
-  return import_react_native13.Platform.OS;
+  return import_react_native14.Platform.OS;
 }
 
 // src/BedrockModule/native-modules/core/BedrockCoreModule.ts
-var import_react_native14 = require("react-native");
-var BedrockCoreModule = import_react_native14.NativeModules.BedrockCoreModule;
+var import_react_native15 = require("react-native");
+var BedrockCoreModule = import_react_native15.NativeModules.BedrockCoreModule;
 
 // src/AppsInTossModule/native-modules/tossCore.ts
-var import_react_native15 = require("react-native");
-var TossCoreModule = import_react_native15.NativeModules.TossCoreModule;
+var import_react_native16 = require("react-native");
+var TossCoreModule = import_react_native16.NativeModules.TossCoreModule;
 function tossCoreEventLog(params) {
   const supported = isMinVersionSupported({ ios: "5.210.0", android: "5.210.0" });
   const isSandbox = getOperationalEnvironment() === "sandbox";

package/dist/index.d.cts

@@ -1509,7 +1509,7 @@ declare function requestOneTimePurchase(params: IapRequestOneTimePurchaseOptions
  *
  * ```tsx
  * import { IAP } from "@apps-in-toss/web-framework";
- * import { Button } from "@toss-design-system/react-native";
+ * import { Button } from "@toss/tds-react-native";
  * import { useCallback } from "react";
  *
  * interface Props {
@@ -1548,7 +1548,7 @@ declare function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrde
  * @category 인앱결제
  * @name IapProductListItem
  * @description 인앱결제로 구매할 수 있는 상품 하나의 정보를 담은 객체예요. 상품 목록을 화면에 표시할 때 사용해요.
- * @property {string} sku - 상품의 고유 ID예요. [IAP.createOneTimePurchaseOrder](https://developers-apps-in-toss.toss.im/bedrock/reference/native-modules/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/createOneTimePurchaseOrder.html)를 호출할때 사용하는 `productId`와 동일한 값이에요.
+ * @property {string} sku - 상품의 고유 ID예요.
  * @property {string} displayName - 화면에 표시할 상품 이름이에요. 상품 이름은 앱인토스 콘솔에서 설정한 값이에요.
  * @property {string} displayAmount - 통화 단위가 포함된 가격 정보예요. 예를 들어 `1,000원`으로 가격과 통화가 함께 표시돼요.
  * @property {string} iconUrl - 상품 아이콘 이미지의 URL이에요. 아이콘은 앱인토스 콘솔에서 설정한 이미지예요.
@@ -1573,7 +1573,7 @@ interface IapProductListItem {
  *
  * ```tsx
  * import { IAP, IapProductListItem } from "@apps-in-toss/framework";
- * import { Button, List, ListRow } from "@toss-design-system/react-native";
+ * import { Button, List, ListRow } from "@toss/tds-react-native";
  * import { useEffect, useState } from "react";
  *
  * function IapProductList() {
@@ -1635,6 +1635,78 @@ interface IapProductListItem {
 declare function getProductItemList(): Promise<{
     products: IapProductListItem[];
 } | undefined>;
+/**
+ * @public
+ * @category 인앱결제
+ * @name getPendingOrders
+ * @description 대기 중인 주문 목록을 가져와요. 이 함수를 사용하면 결제가 아직 완료되지 않은 주문 정보를 확인할 수 있어요.
+ * @returns {Promise<{orderIds: string[]}}>} 대기 중인 주문ID 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+ *
+ * @example
+ * ### 대기 중인 주문 목록 가져오기
+ * ```typescript
+ * import { IAP } from '@apps-in-toss/framework';
+ *
+ * async function fetchOrders() {
+ *   try {
+ *     const pendingOrders = await IAP.getPendingOrders();
+ *     return pendingOrders;
+ *   } catch (error) {
+ *     console.error(error);
+ *   }
+ * }
+ * ```
+ */
+declare function getPendingOrders(): Promise<{
+    orderIds: string[];
+} | undefined>;
+/**
+ * @public
+ * @category 인앱결제
+ * @name CompletedOrRefundedOrdersResult
+ * @description 인앱결제로 구매하거나 환불한 주문 목록을 나타내는 객체예요. 페이지네이션 정보를 포함해요.
+ * @property {boolean} hasNext 다음 페이지가 있는지 여부예요. `true`면 더 많은 주문이 남아 있어요.
+ * @property {string | null} [nextKey] 다음 주문 목록을 조회할 때 사용할 키예요. 마지막 페이지라면 `null`이거나 생략될 수 있어요.
+ * @property {Array} orders 주문 정보를 담은 배열이에요. 각 요소는 하나의 주문을 나타내요.
+ * @property {string} orders[].orderId 주문의 고유 ID예요.
+ * @property {string} orders[].sku 주문 상품의 고유 ID예요.
+ * @property {'COMPLETED' | 'REFUNDED'} orders[].status 주문의 상태예요. 'COMPLETED'는 주문이 완료된 상태, 'REFUNDED'는 환불된 상태를 의미해요.
+ * @property {string} orders[].date 주문의 날짜 정보예요. ISO 8601 형식(YYYY-MM-DDTHH:mm:ss)을 사용해요. 예를 들어 "2025-09-22T00:00:00" 형식으로 제공돼요. 주문 상태가 `COMPLETED`라면 주문한 날짜를, `REFUNDED`라면 환불한 날짜를 나타내요.
+ */
+interface CompletedOrRefundedOrdersResult {
+    hasNext: boolean;
+    nextKey?: string | null;
+    orders: {
+        orderId: string;
+        sku: string;
+        status: 'COMPLETED' | 'REFUNDED';
+        date: string;
+    }[];
+}
+/**
+ * @public
+ * @category 인앱결제
+ * @name getCompletedOrRefundedOrders
+ * @description 인앱결제로 구매하거나 환불한 주문 목록을 가져와요.
+ * @returns {Promise<CompletedOrRefundedOrdersResult>} 페이지네이션을 포함한 주문 목록 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+ *
+ * @example
+ * ```typescript
+ * import { IAP } from "@apps-in-toss/framework";
+ *
+ * async function fetchOrders() {
+ *   try {
+ *     const response =  await IAP.getCompletedOrRefundedOrders();
+ *     return response;
+ *   } catch (error) {
+ *     console.error(error);
+ *   }
+ * }
+ * ```
+ */
+declare function getCompletedOrRefundedOrders(params?: {
+    key?: string | null;
+}): Promise<CompletedOrRefundedOrdersResult | undefined>;
 /**
  * @public
  * @category 인앱결제
@@ -1646,6 +1718,8 @@ declare function getProductItemList(): Promise<{
 declare const IAP: {
     createOneTimePurchaseOrder: typeof createOneTimePurchaseOrder;
     getProductItemList: typeof getProductItemList;
+    getPendingOrders: typeof getPendingOrders;
+    getCompletedOrRefundedOrders: typeof getCompletedOrRefundedOrders;
 };
 
 interface SaveBase64DataParams {
@@ -1830,6 +1904,12 @@ interface Spec extends TurboModule {
         orderId: string;
         isProductGranted: boolean;
     }) => Promise<void>;
+    getPendingOrders: (params: CompatiblePlaceholderArgument) => Promise<{
+        orderIds: string[];
+    }>;
+    getCompletedOrRefundedOrders: (params: {
+        key?: string | null;
+    }) => Promise<CompletedOrRefundedOrdersResult>;
     getGameCenterGameProfile: (params: CompatiblePlaceholderArgument) => Promise<GameCenterGameProfileResponse>;
     submitGameCenterLeaderBoardScore: (params: {
         score: string;
@@ -3248,4 +3328,4 @@ declare const INTERNAL__module: {
     tossCoreEventLog: typeof tossCoreEventLog;
 };
 
-export { AppsInTossModule, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type ContactsViralParams, type EventLogParams, type GameCenterGameProfileResponse, GoogleAdMob, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type LoadAdMobEvent, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobOptions, type LoadAdMobParams, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type NetworkStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobEvent, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobOptions, type ShowAdMobParams, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getTossAppVersion, getTossShareLink, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };
+export { AppsInTossModule, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ContactsViralParams, type EventLogParams, type GameCenterGameProfileResponse, GoogleAdMob, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type LoadAdMobEvent, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobOptions, type LoadAdMobParams, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type NetworkStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobEvent, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobOptions, type ShowAdMobParams, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getTossAppVersion, getTossShareLink, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.d.ts

@@ -1509,7 +1509,7 @@ declare function requestOneTimePurchase(params: IapRequestOneTimePurchaseOptions
  *
  * ```tsx
  * import { IAP } from "@apps-in-toss/web-framework";
- * import { Button } from "@toss-design-system/react-native";
+ * import { Button } from "@toss/tds-react-native";
  * import { useCallback } from "react";
  *
  * interface Props {
@@ -1548,7 +1548,7 @@ declare function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrde
  * @category 인앱결제
  * @name IapProductListItem
  * @description 인앱결제로 구매할 수 있는 상품 하나의 정보를 담은 객체예요. 상품 목록을 화면에 표시할 때 사용해요.
- * @property {string} sku - 상품의 고유 ID예요. [IAP.createOneTimePurchaseOrder](https://developers-apps-in-toss.toss.im/bedrock/reference/native-modules/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/createOneTimePurchaseOrder.html)를 호출할때 사용하는 `productId`와 동일한 값이에요.
+ * @property {string} sku - 상품의 고유 ID예요.
  * @property {string} displayName - 화면에 표시할 상품 이름이에요. 상품 이름은 앱인토스 콘솔에서 설정한 값이에요.
  * @property {string} displayAmount - 통화 단위가 포함된 가격 정보예요. 예를 들어 `1,000원`으로 가격과 통화가 함께 표시돼요.
  * @property {string} iconUrl - 상품 아이콘 이미지의 URL이에요. 아이콘은 앱인토스 콘솔에서 설정한 이미지예요.
@@ -1573,7 +1573,7 @@ interface IapProductListItem {
  *
  * ```tsx
  * import { IAP, IapProductListItem } from "@apps-in-toss/framework";
- * import { Button, List, ListRow } from "@toss-design-system/react-native";
+ * import { Button, List, ListRow } from "@toss/tds-react-native";
  * import { useEffect, useState } from "react";
  *
  * function IapProductList() {
@@ -1635,6 +1635,78 @@ interface IapProductListItem {
 declare function getProductItemList(): Promise<{
     products: IapProductListItem[];
 } | undefined>;
+/**
+ * @public
+ * @category 인앱결제
+ * @name getPendingOrders
+ * @description 대기 중인 주문 목록을 가져와요. 이 함수를 사용하면 결제가 아직 완료되지 않은 주문 정보를 확인할 수 있어요.
+ * @returns {Promise<{orderIds: string[]}}>} 대기 중인 주문ID 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+ *
+ * @example
+ * ### 대기 중인 주문 목록 가져오기
+ * ```typescript
+ * import { IAP } from '@apps-in-toss/framework';
+ *
+ * async function fetchOrders() {
+ *   try {
+ *     const pendingOrders = await IAP.getPendingOrders();
+ *     return pendingOrders;
+ *   } catch (error) {
+ *     console.error(error);
+ *   }
+ * }
+ * ```
+ */
+declare function getPendingOrders(): Promise<{
+    orderIds: string[];
+} | undefined>;
+/**
+ * @public
+ * @category 인앱결제
+ * @name CompletedOrRefundedOrdersResult
+ * @description 인앱결제로 구매하거나 환불한 주문 목록을 나타내는 객체예요. 페이지네이션 정보를 포함해요.
+ * @property {boolean} hasNext 다음 페이지가 있는지 여부예요. `true`면 더 많은 주문이 남아 있어요.
+ * @property {string | null} [nextKey] 다음 주문 목록을 조회할 때 사용할 키예요. 마지막 페이지라면 `null`이거나 생략될 수 있어요.
+ * @property {Array} orders 주문 정보를 담은 배열이에요. 각 요소는 하나의 주문을 나타내요.
+ * @property {string} orders[].orderId 주문의 고유 ID예요.
+ * @property {string} orders[].sku 주문 상품의 고유 ID예요.
+ * @property {'COMPLETED' | 'REFUNDED'} orders[].status 주문의 상태예요. 'COMPLETED'는 주문이 완료된 상태, 'REFUNDED'는 환불된 상태를 의미해요.
+ * @property {string} orders[].date 주문의 날짜 정보예요. ISO 8601 형식(YYYY-MM-DDTHH:mm:ss)을 사용해요. 예를 들어 "2025-09-22T00:00:00" 형식으로 제공돼요. 주문 상태가 `COMPLETED`라면 주문한 날짜를, `REFUNDED`라면 환불한 날짜를 나타내요.
+ */
+interface CompletedOrRefundedOrdersResult {
+    hasNext: boolean;
+    nextKey?: string | null;
+    orders: {
+        orderId: string;
+        sku: string;
+        status: 'COMPLETED' | 'REFUNDED';
+        date: string;
+    }[];
+}
+/**
+ * @public
+ * @category 인앱결제
+ * @name getCompletedOrRefundedOrders
+ * @description 인앱결제로 구매하거나 환불한 주문 목록을 가져와요.
+ * @returns {Promise<CompletedOrRefundedOrdersResult>} 페이지네이션을 포함한 주문 목록 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+ *
+ * @example
+ * ```typescript
+ * import { IAP } from "@apps-in-toss/framework";
+ *
+ * async function fetchOrders() {
+ *   try {
+ *     const response =  await IAP.getCompletedOrRefundedOrders();
+ *     return response;
+ *   } catch (error) {
+ *     console.error(error);
+ *   }
+ * }
+ * ```
+ */
+declare function getCompletedOrRefundedOrders(params?: {
+    key?: string | null;
+}): Promise<CompletedOrRefundedOrdersResult | undefined>;
 /**
  * @public
  * @category 인앱결제
@@ -1646,6 +1718,8 @@ declare function getProductItemList(): Promise<{
 declare const IAP: {
     createOneTimePurchaseOrder: typeof createOneTimePurchaseOrder;
     getProductItemList: typeof getProductItemList;
+    getPendingOrders: typeof getPendingOrders;
+    getCompletedOrRefundedOrders: typeof getCompletedOrRefundedOrders;
 };
 
 interface SaveBase64DataParams {
@@ -1830,6 +1904,12 @@ interface Spec extends TurboModule {
         orderId: string;
         isProductGranted: boolean;
     }) => Promise<void>;
+    getPendingOrders: (params: CompatiblePlaceholderArgument) => Promise<{
+        orderIds: string[];
+    }>;
+    getCompletedOrRefundedOrders: (params: {
+        key?: string | null;
+    }) => Promise<CompletedOrRefundedOrdersResult>;
     getGameCenterGameProfile: (params: CompatiblePlaceholderArgument) => Promise<GameCenterGameProfileResponse>;
     submitGameCenterLeaderBoardScore: (params: {
         score: string;
@@ -3248,4 +3328,4 @@ declare const INTERNAL__module: {
     tossCoreEventLog: typeof tossCoreEventLog;
 };
 
-export { AppsInTossModule, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type ContactsViralParams, type EventLogParams, type GameCenterGameProfileResponse, GoogleAdMob, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type LoadAdMobEvent, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobOptions, type LoadAdMobParams, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type NetworkStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobEvent, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobOptions, type ShowAdMobParams, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getTossAppVersion, getTossShareLink, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };
+export { AppsInTossModule, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type CompletedOrRefundedOrdersResult, type ContactsViralParams, type EventLogParams, type GameCenterGameProfileResponse, GoogleAdMob, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__appBridgeHandler, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type LoadAdMobEvent, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobOptions, type LoadAdMobParams, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type NetworkStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobEvent, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobOptions, type ShowAdMobParams, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getTossAppVersion, getTossShareLink, iapCreateOneTimePurchaseOrder, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, processProductGrant, requestOneTimePurchase, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };

package/dist/index.js

@@ -408,16 +408,33 @@ showAdMobRewardedAd.isSupported = createIsSupported();
 
 // src/AppsInTossModule/native-modules/ads/googleAdMobV2.ts
 import { noop as noop2 } from "es-toolkit";
+
+// src/utils/getReferrer.ts
+import { getSchemeUri } from "@granite-js/react-native";
+function getReferrer() {
+  try {
+    return new URL(getSchemeUri()).searchParams.get("referrer");
+  } catch {
+    return null;
+  }
+}
+
+// src/AppsInTossModule/native-modules/ads/googleAdMobV2.ts
 function loadAppsInTossAdMob(params) {
   if (!loadAppsInTossAdMob.isSupported()) {
     params.onError(new Error(UNSUPPORTED_ERROR_MESSAGE2));
     return noop2;
   }
   const { onEvent, onError, options } = params;
-  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod("loadAppsInTossAdmob", options, {
-    onSuccess: (result) => onEvent({ type: "loaded", data: result }),
-    onError
-  });
+  const referrer = getReferrer();
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
+    "loadAppsInTossAdmob",
+    { ...options, referrer },
+    {
+      onSuccess: (result) => onEvent({ type: "loaded", data: result }),
+      onError
+    }
+  );
   return unregisterCallbacks;
 }
 function showAppsInTossAdMob(params) {
@@ -426,28 +443,33 @@ function showAppsInTossAdMob(params) {
     return noop2;
   }
   const { onEvent, onError, options } = params;
-  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod("showAppsInTossAdmob", options, {
-    onAdClicked: () => {
-      onEvent({ type: "clicked" });
-    },
-    onAdDismissed: () => {
-      onEvent({ type: "dismissed" });
-    },
-    onAdFailedToShow: () => {
-      onEvent({ type: "failedToShow" });
-    },
-    onAdImpression: () => {
-      onEvent({ type: "impression" });
-    },
-    onAdShow: () => {
-      onEvent({ type: "show" });
-    },
-    onUserEarnedReward: (data) => {
-      onEvent({ type: "userEarnedReward", data });
-    },
-    onSuccess: () => onEvent({ type: "requested" }),
-    onError
-  });
+  const referrer = getReferrer();
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
+    "showAppsInTossAdmob",
+    { ...options, referrer },
+    {
+      onAdClicked: () => {
+        onEvent({ type: "clicked" });
+      },
+      onAdDismissed: () => {
+        onEvent({ type: "dismissed" });
+      },
+      onAdFailedToShow: () => {
+        onEvent({ type: "failedToShow" });
+      },
+      onAdImpression: () => {
+        onEvent({ type: "impression" });
+      },
+      onAdShow: () => {
+        onEvent({ type: "show" });
+      },
+      onUserEarnedReward: (data) => {
+        onEvent({ type: "userEarnedReward", data });
+      },
+      onSuccess: () => onEvent({ type: "requested" }),
+      onError
+    }
+  );
   return unregisterCallbacks;
 }
 var ANDROID_GOOGLE_AD_MOB_SUPPORTED_VERSION2 = "5.227.0";
@@ -677,7 +699,7 @@ function createOneTimePurchaseOrder(params) {
     return noop3;
   }
   const isProcessProductGrantSupported = isMinVersionSupported({
-    android: "5.230.0",
+    android: "5.231.1",
     ios: "5.230.0"
   });
   const { options, onEvent, onError } = params;
@@ -725,9 +747,31 @@ async function getProductItemList() {
   }
   return AppsInTossModule.iapGetProductItemList({});
 }
+async function getPendingOrders() {
+  const isSupported = isMinVersionSupported({
+    android: "5.231.0",
+    ios: "5.231.0"
+  });
+  if (!isSupported) {
+    return;
+  }
+  return AppsInTossModule.getPendingOrders({});
+}
+async function getCompletedOrRefundedOrders(params) {
+  const isSupported = isMinVersionSupported({
+    android: "5.231.0",
+    ios: "5.231.0"
+  });
+  if (!isSupported) {
+    return;
+  }
+  return AppsInTossModule.getCompletedOrRefundedOrders(params ?? { key: null });
+}
 var IAP = {
   createOneTimePurchaseOrder,
-  getProductItemList
+  getProductItemList,
+  getPendingOrders,
+  getCompletedOrRefundedOrders
 };
 
 // src/AppsInTossModule/native-modules/saveBase64Data.ts
@@ -894,7 +938,7 @@ function replaceUnderbarToHypen(locale) {
 }
 
 // src/BedrockModule/native-modules/natives/getSchemeUri.ts
-function getSchemeUri() {
+function getSchemeUri2() {
   return BedrockModule.schemeUri;
 }
 
@@ -997,7 +1041,7 @@ export {
   getNetworkStatus,
   getOperationalEnvironment,
   getPlatformOS,
-  getSchemeUri,
+  getSchemeUri2 as getSchemeUri,
   getTossAppVersion,
   getTossShareLink,
   iapCreateOneTimePurchaseOrder,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/native-modules",
   "type": "module",
-  "version": "1.1.3",
+  "version": "1.2.0",
   "description": "Native Modules for Apps In Toss",
   "scripts": {
     "prepack": "yarn build",
@@ -43,7 +43,7 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@apps-in-toss/types": "^1.1.3",
+    "@apps-in-toss/types": "^1.2.0",
     "es-toolkit": "^1.39.3"
   },
   "peerDependencies": {
@@ -54,5 +54,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "0c80b4a0b49ec85f9f042909c7e9762c25425573"
+  "gitHead": "f567520ba5a18de1fcddb329fb70d432cf10af85"
 }

package/src/AppsInTossModule/native-modules/AppsInTossModule.ts

@@ -15,7 +15,7 @@ import type {
 import { TurboModuleRegistry, type TurboModule as __TurboModule } from 'react-native';
 import type { CheckoutPaymentOptions, CheckoutPaymentResult } from './checkoutPayment';
 import type { GameCenterGameProfileResponse } from './getGameCenterGameProfile';
-import { IapCreateOneTimePurchaseOrderResult, IapProductListItem } from './iap';
+import { IapCreateOneTimePurchaseOrderResult, IapProductListItem, CompletedOrRefundedOrdersResult } from './iap';
 import type { SaveBase64DataParams } from './saveBase64Data';
 import type { SubmitGameCenterLeaderBoardScoreResponse } from './submitGameCenterLeaderBoardScore';
 import type { ContactsViralParams } from '../native-event-emitter/contactsViral';
@@ -72,6 +72,8 @@ interface Spec extends __TurboModule {
     fallbacks: { onPurchased: (params: { orderId: string }) => void }
   ) => () => void;
   processProductGrant: (params: { orderId: string; isProductGranted: boolean }) => Promise<void>;
+  getPendingOrders: (params: CompatiblePlaceholderArgument) => Promise<{ orderIds: string[] }>;
+  getCompletedOrRefundedOrders: (params: { key?: string | null }) => Promise<CompletedOrRefundedOrdersResult>;
 
   getGameCenterGameProfile: (params: CompatiblePlaceholderArgument) => Promise<GameCenterGameProfileResponse>;
   submitGameCenterLeaderBoardScore: (params: { score: string }) => Promise<SubmitGameCenterLeaderBoardScoreResponse>;

package/src/AppsInTossModule/native-modules/ads/googleAdMobV2.ts

@@ -1,5 +1,6 @@
 import { noop } from 'es-toolkit';
 import type { AdMobFullScreenEvent, AdMobHandlerParams, AdMobLoadResult, AdUserEarnedReward } from './types';
+import { getReferrer } from '../../../utils/getReferrer';
 import { INTERNAL__appBridgeHandler } from '../../native-event-emitter/internal/appBridge';
 import { getOperationalEnvironment } from '../getOperationalEnvironment';
 import { isMinVersionSupported } from '../isMinVersionSupported';
@@ -155,11 +156,16 @@ export function loadAppsInTossAdMob(params: LoadAdMobParams) {
   }
 
   const { onEvent, onError, options } = params;
+  const referrer = getReferrer();
 
-  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod('loadAppsInTossAdmob', options, {
-    onSuccess: (result) => onEvent({ type: 'loaded', data: result }),
-    onError,
-  });
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
+    'loadAppsInTossAdmob',
+    { ...options, referrer },
+    {
+      onSuccess: (result) => onEvent({ type: 'loaded', data: result }),
+      onError,
+    }
+  );
 
   return unregisterCallbacks;
 }
@@ -312,29 +318,34 @@ export function showAppsInTossAdMob(params: ShowAdMobParams) {
   }
 
   const { onEvent, onError, options } = params;
+  const referrer = getReferrer();
 
-  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod('showAppsInTossAdmob', options, {
-    onAdClicked: () => {
-      onEvent({ type: 'clicked' });
-    },
-    onAdDismissed: () => {
-      onEvent({ type: 'dismissed' });
-    },
-    onAdFailedToShow: () => {
-      onEvent({ type: 'failedToShow' });
-    },
-    onAdImpression: () => {
-      onEvent({ type: 'impression' });
-    },
-    onAdShow: () => {
-      onEvent({ type: 'show' });
-    },
-    onUserEarnedReward: (data: { unitType: string; unitAmount: number }) => {
-      onEvent({ type: 'userEarnedReward', data });
-    },
-    onSuccess: () => onEvent({ type: 'requested' }),
-    onError,
-  });
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
+    'showAppsInTossAdmob',
+    { ...options, referrer },
+    {
+      onAdClicked: () => {
+        onEvent({ type: 'clicked' });
+      },
+      onAdDismissed: () => {
+        onEvent({ type: 'dismissed' });
+      },
+      onAdFailedToShow: () => {
+        onEvent({ type: 'failedToShow' });
+      },
+      onAdImpression: () => {
+        onEvent({ type: 'impression' });
+      },
+      onAdShow: () => {
+        onEvent({ type: 'show' });
+      },
+      onUserEarnedReward: (data: { unitType: string; unitAmount: number }) => {
+        onEvent({ type: 'userEarnedReward', data });
+      },
+      onSuccess: () => onEvent({ type: 'requested' }),
+      onError,
+    }
+  );
 
   return unregisterCallbacks;
 }

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

@@ -129,7 +129,7 @@ export function requestOneTimePurchase(params: IapRequestOneTimePurchaseOptions)
  *
  * ```tsx
  * import { IAP } from "@apps-in-toss/web-framework";
- * import { Button } from "@toss-design-system/react-native";
+ * import { Button } from "@toss/tds-react-native";
  * import { useCallback } from "react";
  *
  * interface Props {
@@ -173,7 +173,7 @@ function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrderOptions
   }
 
   const isProcessProductGrantSupported = isMinVersionSupported({
-    android: '5.230.0',
+    android: '5.231.1',
     ios: '5.230.0',
   });
 
@@ -227,7 +227,7 @@ function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrderOptions
  * @category 인앱결제
  * @name IapProductListItem
  * @description 인앱결제로 구매할 수 있는 상품 하나의 정보를 담은 객체예요. 상품 목록을 화면에 표시할 때 사용해요.
- * @property {string} sku - 상품의 고유 ID예요. [IAP.createOneTimePurchaseOrder](https://developers-apps-in-toss.toss.im/bedrock/reference/native-modules/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/createOneTimePurchaseOrder.html)를 호출할때 사용하는 `productId`와 동일한 값이에요.
+ * @property {string} sku - 상품의 고유 ID예요.
  * @property {string} displayName - 화면에 표시할 상품 이름이에요. 상품 이름은 앱인토스 콘솔에서 설정한 값이에요.
  * @property {string} displayAmount - 통화 단위가 포함된 가격 정보예요. 예를 들어 `1,000원`으로 가격과 통화가 함께 표시돼요.
  * @property {string} iconUrl - 상품 아이콘 이미지의 URL이에요. 아이콘은 앱인토스 콘솔에서 설정한 이미지예요.
@@ -253,7 +253,7 @@ export interface IapProductListItem {
  *
  * ```tsx
  * import { IAP, IapProductListItem } from "@apps-in-toss/framework";
- * import { Button, List, ListRow } from "@toss-design-system/react-native";
+ * import { Button, List, ListRow } from "@toss/tds-react-native";
  * import { useEffect, useState } from "react";
  *
  * function IapProductList() {
@@ -325,6 +325,94 @@ async function getProductItemList() {
   return AppsInTossModule.iapGetProductItemList({});
 }
 
+/**
+ * @public
+ * @category 인앱결제
+ * @name getPendingOrders
+ * @description 대기 중인 주문 목록을 가져와요. 이 함수를 사용하면 결제가 아직 완료되지 않은 주문 정보를 확인할 수 있어요.
+ * @returns {Promise<{orderIds: string[]}}>} 대기 중인 주문ID 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+ *
+ * @example
+ * ### 대기 중인 주문 목록 가져오기
+ * ```typescript
+ * import { IAP } from '@apps-in-toss/framework';
+ *
+ * async function fetchOrders() {
+ *   try {
+ *     const pendingOrders = await IAP.getPendingOrders();
+ *     return pendingOrders;
+ *   } catch (error) {
+ *     console.error(error);
+ *   }
+ * }
+ * ```
+ */
+async function getPendingOrders() {
+  const isSupported = isMinVersionSupported({
+    android: '5.231.0',
+    ios: '5.231.0',
+  });
+
+  if (!isSupported) {
+    return;
+  }
+
+  return AppsInTossModule.getPendingOrders({});
+}
+
+/**
+ * @public
+ * @category 인앱결제
+ * @name CompletedOrRefundedOrdersResult
+ * @description 인앱결제로 구매하거나 환불한 주문 목록을 나타내는 객체예요. 페이지네이션 정보를 포함해요.
+ * @property {boolean} hasNext 다음 페이지가 있는지 여부예요. `true`면 더 많은 주문이 남아 있어요.
+ * @property {string | null} [nextKey] 다음 주문 목록을 조회할 때 사용할 키예요. 마지막 페이지라면 `null`이거나 생략될 수 있어요.
+ * @property {Array} orders 주문 정보를 담은 배열이에요. 각 요소는 하나의 주문을 나타내요.
+ * @property {string} orders[].orderId 주문의 고유 ID예요.
+ * @property {string} orders[].sku 주문 상품의 고유 ID예요.
+ * @property {'COMPLETED' | 'REFUNDED'} orders[].status 주문의 상태예요. 'COMPLETED'는 주문이 완료된 상태, 'REFUNDED'는 환불된 상태를 의미해요.
+ * @property {string} orders[].date 주문의 날짜 정보예요. ISO 8601 형식(YYYY-MM-DDTHH:mm:ss)을 사용해요. 예를 들어 "2025-09-22T00:00:00" 형식으로 제공돼요. 주문 상태가 `COMPLETED`라면 주문한 날짜를, `REFUNDED`라면 환불한 날짜를 나타내요.
+ */
+export interface CompletedOrRefundedOrdersResult {
+  hasNext: boolean;
+  nextKey?: string | null;
+  orders: { orderId: string; sku: string; status: 'COMPLETED' | 'REFUNDED'; date: string }[];
+}
+
+/**
+ * @public
+ * @category 인앱결제
+ * @name getCompletedOrRefundedOrders
+ * @description 인앱결제로 구매하거나 환불한 주문 목록을 가져와요.
+ * @returns {Promise<CompletedOrRefundedOrdersResult>} 페이지네이션을 포함한 주문 목록 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.231.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+ *
+ * @example
+ * ```typescript
+ * import { IAP } from "@apps-in-toss/framework";
+ *
+ * async function fetchOrders() {
+ *   try {
+ *     const response =  await IAP.getCompletedOrRefundedOrders();
+ *     return response;
+ *   } catch (error) {
+ *     console.error(error);
+ *   }
+ * }
+ * ```
+ */
+async function getCompletedOrRefundedOrders(params?: { key?: string | null }) {
+  const isSupported = isMinVersionSupported({
+    android: '5.231.0',
+    ios: '5.231.0',
+  });
+
+  if (!isSupported) {
+    return;
+  }
+
+  return AppsInTossModule.getCompletedOrRefundedOrders(params ?? { key: null });
+}
+
 /**
  * @public
  * @category 인앱결제
@@ -336,4 +424,6 @@ async function getProductItemList() {
 export const IAP = {
   createOneTimePurchaseOrder,
   getProductItemList,
+  getPendingOrders,
+  getCompletedOrRefundedOrders,
 };

package/src/utils/getReferrer.ts

@@ -0,0 +1,9 @@
+import { getSchemeUri } from '@granite-js/react-native';
+
+export function getReferrer() {
+  try {
+    return new URL(getSchemeUri()).searchParams.get('referrer');
+  } catch {
+    return null;
+  }
+}