@apps-in-toss/native-modules 0.0.0-dev.1758103372343 → 0.0.0-dev.1758275837494

package/dist/index.cjs

@@ -50,11 +50,14 @@ __export(index_exports, {
   getSchemeUri: () => getSchemeUri,
   getTossAppVersion: () => getTossAppVersion,
   getTossShareLink: () => getTossShareLink,
+  iapCreateOneTimePurchaseOrder: () => iapCreateOneTimePurchaseOrder,
   isMinVersionSupported: () => isMinVersionSupported,
   onVisibilityChangedByTransparentServiceWeb: () => onVisibilityChangedByTransparentServiceWeb,
   openCamera: () => openCamera,
   openGameCenterLeaderboard: () => openGameCenterLeaderboard,
   openURL: () => openURL2,
+  processProductGrant: () => processProductGrant,
+  requestOneTimePurchase: () => requestOneTimePurchase,
   saveBase64Data: () => saveBase64Data,
   setClipboardText: () => setClipboardText,
   setDeviceOrientation: () => setDeviceOrientation,
@@ -709,15 +712,80 @@ async function getTossShareLink(path) {
 }
 
 // src/AppsInTossModule/native-modules/iap.ts
-async function createOneTimePurchaseOrder(params) {
-  const isSupported = isMinVersionSupported({
+var import_es_toolkit3 = require("es-toolkit");
+function iapCreateOneTimePurchaseOrder(params) {
+  const sku = params.sku ?? params.productId;
+  return AppsInTossModule.iapCreateOneTimePurchaseOrder({ productId: sku });
+}
+function processProductGrant(params) {
+  return AppsInTossModule.processProductGrant({ orderId: params.orderId, isProductGranted: params.isProductGranted });
+}
+function requestOneTimePurchase(params) {
+  const { options, onEvent, onError } = params;
+  const sku = options.sku ?? options.productId;
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
+    "requestOneTimePurchase",
+    { sku },
+    {
+      onPurchased: (params2) => {
+        onEvent({ type: "purchased", data: params2 });
+      },
+      onSuccess: (result) => {
+        onEvent({ type: "success", data: result });
+      },
+      onError: (error) => {
+        onError(error);
+      }
+    }
+  );
+  return unregisterCallbacks;
+}
+function createOneTimePurchaseOrder(params) {
+  const isIAPSupported = isMinVersionSupported({
     android: "5.219.0",
     ios: "5.219.0"
   });
-  if (!isSupported) {
-    return;
+  if (!isIAPSupported) {
+    return import_es_toolkit3.noop;
+  }
+  const isProcessProductGrantSupported = isMinVersionSupported({
+    android: "5.230.0",
+    ios: "5.230.0"
+  });
+  const { options, onEvent, onError } = params;
+  const sku = options.sku ?? options.productId;
+  if (!isProcessProductGrantSupported) {
+    const v1 = () => {
+      AppsInTossModule.iapCreateOneTimePurchaseOrder({ productId: sku }).then((response) => {
+        Promise.resolve(options.processProductGrant({ orderId: response.orderId })).then(() => {
+          onEvent({ type: "success", data: response });
+        }).catch((error) => {
+          onError(error);
+        });
+      }).catch((error) => {
+        onError(error);
+      });
+      return import_es_toolkit3.noop;
+    };
+    return v1();
   }
-  return AppsInTossModule.iapCreateOneTimePurchaseOrder(params);
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
+    "requestOneTimePurchase",
+    { sku },
+    {
+      onPurchased: async (params2) => {
+        const isProductGranted = await options.processProductGrant(params2);
+        await AppsInTossModule.processProductGrant({ orderId: params2.orderId, isProductGranted });
+      },
+      onSuccess: (result) => {
+        onEvent({ type: "success", data: result });
+      },
+      onError: (error) => {
+        onError(error);
+      }
+    }
+  );
+  return unregisterCallbacks;
 }
 async function getProductItemList() {
   const isSupported = isMinVersionSupported({
@@ -1005,11 +1073,14 @@ var INTERNAL__module = {
   getSchemeUri,
   getTossAppVersion,
   getTossShareLink,
+  iapCreateOneTimePurchaseOrder,
   isMinVersionSupported,
   onVisibilityChangedByTransparentServiceWeb,
   openCamera,
   openGameCenterLeaderboard,
   openURL,
+  processProductGrant,
+  requestOneTimePurchase,
   saveBase64Data,
   setClipboardText,
   setDeviceOrientation,

package/dist/index.d.cts

@@ -1411,16 +1411,16 @@ type GameCenterGameProfileResponse = {
  */
 declare function getGameCenterGameProfile(): Promise<GameCenterGameProfileResponse | undefined>;
 
-/**
- * @public
- * @category 인앱결제
- * @name IapCreateOneTimePurchaseOrderOptions
- * @description 인앱결제 1건을 요청할 때 필요한 정보예요.
- * @property {string} productId - 주문할 상품의 ID예요.
- */
-interface IapCreateOneTimePurchaseOrderOptions {
+type Sku = {
+    /**
+     * @deprecated `productId`는 더 이상 사용하지 않아요. 대신 `sku`를 사용해요.
+     */
     productId: string;
-}
+    sku?: string;
+} | {
+    productId?: never;
+    sku: string;
+};
 /**
  * @public
  * @category 인앱결제
@@ -1443,15 +1443,54 @@ interface IapCreateOneTimePurchaseOrderResult {
     fraction: number;
     miniAppIconUrl: string | null;
 }
+interface SuccessEvent {
+    type: 'success';
+    data: IapCreateOneTimePurchaseOrderResult;
+}
+interface PurchasedEvent {
+    type: 'purchased';
+    data: {
+        orderId: string;
+    };
+}
+/**
+ * @public
+ * @category 인앱결제
+ * @name IapCreateOneTimePurchaseOrderOptions
+ * @property {Sku} options - 결제할 상품의 정보예요.
+ * @property {string} options.sku - 주문할 상품의 고유 ID예요.
+ * @property {(params: { orderId: string }) => boolean | Promise<boolean>} processProductGrant - 주문이 만들어진 뒤 실제로 상품을 지급할 때 호출해요. `orderId`를 받아서 지급 성공 여부를 `true` 또는 `Promise<true>`로 반환해요. 지급에 실패하면 `false`를 반환해요.
+ * @property {(event: SuccessEvent) => void | Promise<void>} onEvent - 결제가 성공했을 때 호출해요. `event.type`이 `'success'`이고, `event.data`에 `IapCreateOneTimePurchaseOrderResult`가 들어 있어요.
+ * @property {(error: unknown) => void | Promise<void>} onError - 결제 과정에서 에러가 발생했을 때 호출해요. 에러 객체를 받아서 로깅하거나 복구 절차를 실행할 수 있어요.
+ */
+interface IapCreateOneTimePurchaseOrderOptions {
+    options: Sku & {
+        processProductGrant: (params: {
+            orderId: string;
+        }) => boolean | Promise<boolean>;
+    };
+    onEvent: (event: SuccessEvent) => void | Promise<void>;
+    onError: (error: unknown) => void | Promise<void>;
+}
+interface IapRequestOneTimePurchaseOptions {
+    options: Sku;
+    onEvent: (event: PurchasedEvent | SuccessEvent) => void | Promise<void>;
+    onError: (error: unknown) => void | Promise<void>;
+}
+declare function iapCreateOneTimePurchaseOrder(params: Sku): Promise<IapCreateOneTimePurchaseOrderResult>;
+declare function processProductGrant(params: {
+    orderId: string;
+    isProductGranted: boolean;
+}): Promise<void>;
+declare function requestOneTimePurchase(params: IapRequestOneTimePurchaseOptions): () => void;
 /**
  * @public
  * @category 인앱결제
- * @name iapCreateOneTimePurchaseOrder
+ * @name createOneTimePurchaseOrder
  * @description
  * 특정 인앱결제 주문서 페이지로 이동해요. 사용자가 상품 구매 버튼을 누르는 상황 등에 사용할 수 있어요. 사용자의 결제는 이동한 페이지에서 진행돼요. 만약 결제 중에 에러가 발생하면 에러 유형에 따라 에러 페이지로 이동해요.
  * @param {IapCreateOneTimePurchaseOrderOptions} params - 인앱결제를 생성할 때 필요한 정보예요.
- * @param {string} params.productId - 주문할 상품의 ID예요.
- * @returns {Promise<IapCreateOneTimePurchaseOrderResult | undefined>} 결제에 성공하면 결제 결과 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 인앱결제를 실행할 수 없어서 `undefined`를 반환해요.
+ * @returns {() => void} 앱브릿지 cleanup 함수를 반환해요. 인앱결제 기능이 끝나면 반드시 이 함수를 호출해서 리소스를 해제해야 해요.
  *
  * @throw {code: "INVALID_PRODUCT_ID"} - 유효하지 않은 상품 ID이거나, 해당 상품이 존재하지 않을 때 발생해요.
  * @throw {code: "PAYMENT_PENDING"} - 사용자가 요청한 결제가 아직 승인을 기다리고 있을 때 발생해요.
@@ -1463,6 +1502,7 @@ interface IapCreateOneTimePurchaseOrderResult {
  * @throw {code: "INTERNAL_ERROR"} - 서버 내부 문제로 요청을 처리할 수 없을 때 발생해요.
  * @throw {code: "KOREAN_ACCOUNT_ONLY"} - iOS 환경에서 사용자의 계정이 한국 계정이 아닐 때 발생해요.
  * @throw {code: "USER_CANCELED"} - 사용자가 결제를 완료하지 않고 주문서 페이지를 이탈했을 때 발생해요.
+ * @throw {code: "PRODUCT_NOT_GRANTED_BY_PARTNER"} - 파트너사의 상품 지급이 실패했을 때 발생해요.
  *
  * @example
  * ### 특정 인앱결제 주문서 페이지로 이동하기
@@ -1470,28 +1510,39 @@ interface IapCreateOneTimePurchaseOrderResult {
  * ```tsx
  * import { IAP } from "@apps-in-toss/web-framework";
  * import { Button } from "@toss-design-system/react-native";
+ * import { useCallback } from "react";
  *
  * interface Props {
- *   productId: string;
+ *   sku: string;
  * }
  *
- * function IapCreateOneTimePurchaseOrderButton({ productId }: Props) {
- *   async function handleClick() {
- *     try {
- *       await IAP.createOneTimePurchaseOrder({
- *         productId,
- *       });
- *       console.error("인앱결제에 성공했어요");
- *     } catch (error) {
- *       console.error('인앱결제에 실패했어요:', error);
- *     }
- *   }
+ * function IapCreateOneTimePurchaseOrderButton({ sku }: Props) {
+ *   const handleClick = useCallback(async () => {
+ *
+ *     const cleanup = await IAP.createOneTimePurchaseOrder({
+ *       options: {
+ *        sku,
+ *        processProductGrant: ({ orderId }) => {
+ *         // 상품 지급 로직 작성
+ *          return true; // 상품 지급 여부
+ *        }
+ *        },
+ *       onEvent: (event) => {
+ *         console.log(event);
+ *       },
+ *       onError: (error) => {
+ *         console.error(error);
+ *       },
+ *     });
+ *
+ *     return cleanup;
+ *   }, []);
  *
  *   return <Button onClick={handleClick}>구매하기</Button>;
  * }
  * ```
  */
-declare function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrderOptions): Promise<IapCreateOneTimePurchaseOrderResult | undefined>;
+declare function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrderOptions): () => void;
 /**
  * @public
  * @category 인앱결제
@@ -1513,7 +1564,7 @@ interface IapProductListItem {
 /**
  * @public
  * @category 인앱결제
- * @name iapGetProductItemList
+ * @name getProductItemList
  * @description 인앱결제로 구매할 수 있는 상품 목록을 가져와요. 상품 목록 화면에 진입할 때 호출해요.
  * @returns {Promise<{ products: IapProductListItem[] } | undefined>} 상품 목록을 포함한 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 `undefined`를 반환해요.
  *
@@ -1761,10 +1812,24 @@ interface Spec extends TurboModule {
     }) => Promise<void>;
     saveBase64Data: (params: SaveBase64DataParams) => Promise<void>;
     /** IAP */
-    iapCreateOneTimePurchaseOrder: (params: IapCreateOneTimePurchaseOrderOptions) => Promise<IapCreateOneTimePurchaseOrderResult>;
     iapGetProductItemList: (arg: CompatiblePlaceholderArgument) => Promise<{
         products: IapProductListItem[];
     }>;
+    /** @deprecated `requestOneTimePurchase`를 사용해주세요. */
+    iapCreateOneTimePurchaseOrder: (params: {
+        productId: string;
+    }) => Promise<IapCreateOneTimePurchaseOrderResult>;
+    requestOneTimePurchase: (params: {
+        sku: string;
+    }, fallbacks: {
+        onPurchased: (params: {
+            orderId: string;
+        }) => void;
+    }) => () => void;
+    processProductGrant: (params: {
+        orderId: string;
+        isProductGranted: boolean;
+    }) => Promise<void>;
     getGameCenterGameProfile: (params: CompatiblePlaceholderArgument) => Promise<GameCenterGameProfileResponse>;
     submitGameCenterLeaderBoardScore: (params: {
         score: string;
@@ -3183,4 +3248,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, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };
+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 };

package/dist/index.d.ts

@@ -1411,16 +1411,16 @@ type GameCenterGameProfileResponse = {
  */
 declare function getGameCenterGameProfile(): Promise<GameCenterGameProfileResponse | undefined>;
 
-/**
- * @public
- * @category 인앱결제
- * @name IapCreateOneTimePurchaseOrderOptions
- * @description 인앱결제 1건을 요청할 때 필요한 정보예요.
- * @property {string} productId - 주문할 상품의 ID예요.
- */
-interface IapCreateOneTimePurchaseOrderOptions {
+type Sku = {
+    /**
+     * @deprecated `productId`는 더 이상 사용하지 않아요. 대신 `sku`를 사용해요.
+     */
     productId: string;
-}
+    sku?: string;
+} | {
+    productId?: never;
+    sku: string;
+};
 /**
  * @public
  * @category 인앱결제
@@ -1443,15 +1443,54 @@ interface IapCreateOneTimePurchaseOrderResult {
     fraction: number;
     miniAppIconUrl: string | null;
 }
+interface SuccessEvent {
+    type: 'success';
+    data: IapCreateOneTimePurchaseOrderResult;
+}
+interface PurchasedEvent {
+    type: 'purchased';
+    data: {
+        orderId: string;
+    };
+}
+/**
+ * @public
+ * @category 인앱결제
+ * @name IapCreateOneTimePurchaseOrderOptions
+ * @property {Sku} options - 결제할 상품의 정보예요.
+ * @property {string} options.sku - 주문할 상품의 고유 ID예요.
+ * @property {(params: { orderId: string }) => boolean | Promise<boolean>} processProductGrant - 주문이 만들어진 뒤 실제로 상품을 지급할 때 호출해요. `orderId`를 받아서 지급 성공 여부를 `true` 또는 `Promise<true>`로 반환해요. 지급에 실패하면 `false`를 반환해요.
+ * @property {(event: SuccessEvent) => void | Promise<void>} onEvent - 결제가 성공했을 때 호출해요. `event.type`이 `'success'`이고, `event.data`에 `IapCreateOneTimePurchaseOrderResult`가 들어 있어요.
+ * @property {(error: unknown) => void | Promise<void>} onError - 결제 과정에서 에러가 발생했을 때 호출해요. 에러 객체를 받아서 로깅하거나 복구 절차를 실행할 수 있어요.
+ */
+interface IapCreateOneTimePurchaseOrderOptions {
+    options: Sku & {
+        processProductGrant: (params: {
+            orderId: string;
+        }) => boolean | Promise<boolean>;
+    };
+    onEvent: (event: SuccessEvent) => void | Promise<void>;
+    onError: (error: unknown) => void | Promise<void>;
+}
+interface IapRequestOneTimePurchaseOptions {
+    options: Sku;
+    onEvent: (event: PurchasedEvent | SuccessEvent) => void | Promise<void>;
+    onError: (error: unknown) => void | Promise<void>;
+}
+declare function iapCreateOneTimePurchaseOrder(params: Sku): Promise<IapCreateOneTimePurchaseOrderResult>;
+declare function processProductGrant(params: {
+    orderId: string;
+    isProductGranted: boolean;
+}): Promise<void>;
+declare function requestOneTimePurchase(params: IapRequestOneTimePurchaseOptions): () => void;
 /**
  * @public
  * @category 인앱결제
- * @name iapCreateOneTimePurchaseOrder
+ * @name createOneTimePurchaseOrder
  * @description
  * 특정 인앱결제 주문서 페이지로 이동해요. 사용자가 상품 구매 버튼을 누르는 상황 등에 사용할 수 있어요. 사용자의 결제는 이동한 페이지에서 진행돼요. 만약 결제 중에 에러가 발생하면 에러 유형에 따라 에러 페이지로 이동해요.
  * @param {IapCreateOneTimePurchaseOrderOptions} params - 인앱결제를 생성할 때 필요한 정보예요.
- * @param {string} params.productId - 주문할 상품의 ID예요.
- * @returns {Promise<IapCreateOneTimePurchaseOrderResult | undefined>} 결제에 성공하면 결제 결과 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 인앱결제를 실행할 수 없어서 `undefined`를 반환해요.
+ * @returns {() => void} 앱브릿지 cleanup 함수를 반환해요. 인앱결제 기능이 끝나면 반드시 이 함수를 호출해서 리소스를 해제해야 해요.
  *
  * @throw {code: "INVALID_PRODUCT_ID"} - 유효하지 않은 상품 ID이거나, 해당 상품이 존재하지 않을 때 발생해요.
  * @throw {code: "PAYMENT_PENDING"} - 사용자가 요청한 결제가 아직 승인을 기다리고 있을 때 발생해요.
@@ -1463,6 +1502,7 @@ interface IapCreateOneTimePurchaseOrderResult {
  * @throw {code: "INTERNAL_ERROR"} - 서버 내부 문제로 요청을 처리할 수 없을 때 발생해요.
  * @throw {code: "KOREAN_ACCOUNT_ONLY"} - iOS 환경에서 사용자의 계정이 한국 계정이 아닐 때 발생해요.
  * @throw {code: "USER_CANCELED"} - 사용자가 결제를 완료하지 않고 주문서 페이지를 이탈했을 때 발생해요.
+ * @throw {code: "PRODUCT_NOT_GRANTED_BY_PARTNER"} - 파트너사의 상품 지급이 실패했을 때 발생해요.
  *
  * @example
  * ### 특정 인앱결제 주문서 페이지로 이동하기
@@ -1470,28 +1510,39 @@ interface IapCreateOneTimePurchaseOrderResult {
  * ```tsx
  * import { IAP } from "@apps-in-toss/web-framework";
  * import { Button } from "@toss-design-system/react-native";
+ * import { useCallback } from "react";
  *
  * interface Props {
- *   productId: string;
+ *   sku: string;
  * }
  *
- * function IapCreateOneTimePurchaseOrderButton({ productId }: Props) {
- *   async function handleClick() {
- *     try {
- *       await IAP.createOneTimePurchaseOrder({
- *         productId,
- *       });
- *       console.error("인앱결제에 성공했어요");
- *     } catch (error) {
- *       console.error('인앱결제에 실패했어요:', error);
- *     }
- *   }
+ * function IapCreateOneTimePurchaseOrderButton({ sku }: Props) {
+ *   const handleClick = useCallback(async () => {
+ *
+ *     const cleanup = await IAP.createOneTimePurchaseOrder({
+ *       options: {
+ *        sku,
+ *        processProductGrant: ({ orderId }) => {
+ *         // 상품 지급 로직 작성
+ *          return true; // 상품 지급 여부
+ *        }
+ *        },
+ *       onEvent: (event) => {
+ *         console.log(event);
+ *       },
+ *       onError: (error) => {
+ *         console.error(error);
+ *       },
+ *     });
+ *
+ *     return cleanup;
+ *   }, []);
  *
  *   return <Button onClick={handleClick}>구매하기</Button>;
  * }
  * ```
  */
-declare function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrderOptions): Promise<IapCreateOneTimePurchaseOrderResult | undefined>;
+declare function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrderOptions): () => void;
 /**
  * @public
  * @category 인앱결제
@@ -1513,7 +1564,7 @@ interface IapProductListItem {
 /**
  * @public
  * @category 인앱결제
- * @name iapGetProductItemList
+ * @name getProductItemList
  * @description 인앱결제로 구매할 수 있는 상품 목록을 가져와요. 상품 목록 화면에 진입할 때 호출해요.
  * @returns {Promise<{ products: IapProductListItem[] } | undefined>} 상품 목록을 포함한 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 `undefined`를 반환해요.
  *
@@ -1761,10 +1812,24 @@ interface Spec extends TurboModule {
     }) => Promise<void>;
     saveBase64Data: (params: SaveBase64DataParams) => Promise<void>;
     /** IAP */
-    iapCreateOneTimePurchaseOrder: (params: IapCreateOneTimePurchaseOrderOptions) => Promise<IapCreateOneTimePurchaseOrderResult>;
     iapGetProductItemList: (arg: CompatiblePlaceholderArgument) => Promise<{
         products: IapProductListItem[];
     }>;
+    /** @deprecated `requestOneTimePurchase`를 사용해주세요. */
+    iapCreateOneTimePurchaseOrder: (params: {
+        productId: string;
+    }) => Promise<IapCreateOneTimePurchaseOrderResult>;
+    requestOneTimePurchase: (params: {
+        sku: string;
+    }, fallbacks: {
+        onPurchased: (params: {
+            orderId: string;
+        }) => void;
+    }) => () => void;
+    processProductGrant: (params: {
+        orderId: string;
+        isProductGranted: boolean;
+    }) => Promise<void>;
     getGameCenterGameProfile: (params: CompatiblePlaceholderArgument) => Promise<GameCenterGameProfileResponse>;
     submitGameCenterLeaderBoardScore: (params: {
         score: string;
@@ -3183,4 +3248,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, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };
+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 };

package/dist/index.js

@@ -640,15 +640,80 @@ async function getTossShareLink(path) {
 }
 
 // src/AppsInTossModule/native-modules/iap.ts
-async function createOneTimePurchaseOrder(params) {
-  const isSupported = isMinVersionSupported({
+import { noop as noop3 } from "es-toolkit";
+function iapCreateOneTimePurchaseOrder(params) {
+  const sku = params.sku ?? params.productId;
+  return AppsInTossModule.iapCreateOneTimePurchaseOrder({ productId: sku });
+}
+function processProductGrant(params) {
+  return AppsInTossModule.processProductGrant({ orderId: params.orderId, isProductGranted: params.isProductGranted });
+}
+function requestOneTimePurchase(params) {
+  const { options, onEvent, onError } = params;
+  const sku = options.sku ?? options.productId;
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
+    "requestOneTimePurchase",
+    { sku },
+    {
+      onPurchased: (params2) => {
+        onEvent({ type: "purchased", data: params2 });
+      },
+      onSuccess: (result) => {
+        onEvent({ type: "success", data: result });
+      },
+      onError: (error) => {
+        onError(error);
+      }
+    }
+  );
+  return unregisterCallbacks;
+}
+function createOneTimePurchaseOrder(params) {
+  const isIAPSupported = isMinVersionSupported({
     android: "5.219.0",
     ios: "5.219.0"
   });
-  if (!isSupported) {
-    return;
+  if (!isIAPSupported) {
+    return noop3;
   }
-  return AppsInTossModule.iapCreateOneTimePurchaseOrder(params);
+  const isProcessProductGrantSupported = isMinVersionSupported({
+    android: "5.230.0",
+    ios: "5.230.0"
+  });
+  const { options, onEvent, onError } = params;
+  const sku = options.sku ?? options.productId;
+  if (!isProcessProductGrantSupported) {
+    const v1 = () => {
+      AppsInTossModule.iapCreateOneTimePurchaseOrder({ productId: sku }).then((response) => {
+        Promise.resolve(options.processProductGrant({ orderId: response.orderId })).then(() => {
+          onEvent({ type: "success", data: response });
+        }).catch((error) => {
+          onError(error);
+        });
+      }).catch((error) => {
+        onError(error);
+      });
+      return noop3;
+    };
+    return v1();
+  }
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
+    "requestOneTimePurchase",
+    { sku },
+    {
+      onPurchased: async (params2) => {
+        const isProductGranted = await options.processProductGrant(params2);
+        await AppsInTossModule.processProductGrant({ orderId: params2.orderId, isProductGranted });
+      },
+      onSuccess: (result) => {
+        onEvent({ type: "success", data: result });
+      },
+      onError: (error) => {
+        onError(error);
+      }
+    }
+  );
+  return unregisterCallbacks;
 }
 async function getProductItemList() {
   const isSupported = isMinVersionSupported({
@@ -935,11 +1000,14 @@ export {
   getSchemeUri,
   getTossAppVersion,
   getTossShareLink,
+  iapCreateOneTimePurchaseOrder,
   isMinVersionSupported,
   onVisibilityChangedByTransparentServiceWeb,
   openCamera,
   openGameCenterLeaderboard,
   openURL2 as openURL,
+  processProductGrant,
+  requestOneTimePurchase,
   saveBase64Data,
   setClipboardText,
   setDeviceOrientation,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/native-modules",
   "type": "module",
-  "version": "0.0.0-dev.1758103372343",
+  "version": "0.0.0-dev.1758275837494",
   "description": "Native Modules for Apps In Toss",
   "scripts": {
     "prepack": "yarn build",
@@ -43,7 +43,7 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@apps-in-toss/types": "^0.0.0-dev.1758103372343",
+    "@apps-in-toss/types": "^0.0.0-dev.1758275837494",
     "es-toolkit": "^1.39.3"
   },
   "peerDependencies": {
@@ -54,5 +54,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "dd32f2c8028913b7f866a3a099728410d783dcd6"
+  "gitHead": "b68a923a00c75af3ca66633e450370f20f025a34"
 }

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

@@ -15,11 +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 type {
-  IapCreateOneTimePurchaseOrderOptions,
-  IapCreateOneTimePurchaseOrderResult,
-  IapProductListItem,
-} from './iap';
+import { IapCreateOneTimePurchaseOrderResult, IapProductListItem } from './iap';
 import type { SaveBase64DataParams } from './saveBase64Data';
 import type { SubmitGameCenterLeaderBoardScoreResponse } from './submitGameCenterLeaderBoardScore';
 import type { ContactsViralParams } from '../native-event-emitter/contactsViral';
@@ -68,10 +64,15 @@ interface Spec extends __TurboModule {
   saveBase64Data: (params: SaveBase64DataParams) => Promise<void>;
 
   /** IAP */
-  iapCreateOneTimePurchaseOrder: (
-    params: IapCreateOneTimePurchaseOrderOptions
-  ) => Promise<IapCreateOneTimePurchaseOrderResult>;
   iapGetProductItemList: (arg: CompatiblePlaceholderArgument) => Promise<{ products: IapProductListItem[] }>;
+  /** @deprecated `requestOneTimePurchase`를 사용해주세요. */
+  iapCreateOneTimePurchaseOrder: (params: { productId: string }) => Promise<IapCreateOneTimePurchaseOrderResult>;
+  requestOneTimePurchase: (
+    params: { sku: string },
+    fallbacks: { onPurchased: (params: { orderId: string }) => void }
+  ) => () => void;
+  processProductGrant: (params: { orderId: string; isProductGranted: boolean }) => Promise<void>;
+
   getGameCenterGameProfile: (params: CompatiblePlaceholderArgument) => Promise<GameCenterGameProfileResponse>;
   submitGameCenterLeaderBoardScore: (params: { score: string }) => Promise<SubmitGameCenterLeaderBoardScoreResponse>;
 

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

@@ -1,16 +1,20 @@
+import { noop } from 'es-toolkit';
 import { AppsInTossModule } from './AppsInTossModule';
 import { isMinVersionSupported } from './isMinVersionSupported';
+import { INTERNAL__appBridgeHandler } from '../native-event-emitter/internal/appBridge';
 
-/**
- * @public
- * @category 인앱결제
- * @name IapCreateOneTimePurchaseOrderOptions
- * @description 인앱결제 1건을 요청할 때 필요한 정보예요.
- * @property {string} productId - 주문할 상품의 ID예요.
- */
-export interface IapCreateOneTimePurchaseOrderOptions {
-  productId: string;
-}
+type Sku =
+  | {
+      /**
+       * @deprecated `productId`는 더 이상 사용하지 않아요. 대신 `sku`를 사용해요.
+       */
+      productId: string;
+      sku?: string;
+    }
+  | {
+      productId?: never;
+      sku: string;
+    };
 
 /**
  * @public
@@ -35,15 +39,78 @@ export interface IapCreateOneTimePurchaseOrderResult {
   miniAppIconUrl: string | null;
 }
 
+interface SuccessEvent {
+  type: 'success';
+  data: IapCreateOneTimePurchaseOrderResult;
+}
+
+interface PurchasedEvent {
+  type: 'purchased';
+  data: { orderId: string };
+}
+
 /**
  * @public
  * @category 인앱결제
- * @name iapCreateOneTimePurchaseOrder
+ * @name IapCreateOneTimePurchaseOrderOptions
+ * @property {Sku} options - 결제할 상품의 정보예요.
+ * @property {string} options.sku - 주문할 상품의 고유 ID예요.
+ * @property {(params: { orderId: string }) => boolean | Promise<boolean>} processProductGrant - 주문이 만들어진 뒤 실제로 상품을 지급할 때 호출해요. `orderId`를 받아서 지급 성공 여부를 `true` 또는 `Promise<true>`로 반환해요. 지급에 실패하면 `false`를 반환해요.
+ * @property {(event: SuccessEvent) => void | Promise<void>} onEvent - 결제가 성공했을 때 호출해요. `event.type`이 `'success'`이고, `event.data`에 `IapCreateOneTimePurchaseOrderResult`가 들어 있어요.
+ * @property {(error: unknown) => void | Promise<void>} onError - 결제 과정에서 에러가 발생했을 때 호출해요. 에러 객체를 받아서 로깅하거나 복구 절차를 실행할 수 있어요.
+ */
+export interface IapCreateOneTimePurchaseOrderOptions {
+  options: Sku & { processProductGrant: (params: { orderId: string }) => boolean | Promise<boolean> };
+  onEvent: (event: SuccessEvent) => void | Promise<void>;
+  onError: (error: unknown) => void | Promise<void>;
+}
+
+interface IapRequestOneTimePurchaseOptions {
+  options: Sku;
+  onEvent: (event: PurchasedEvent | SuccessEvent) => void | Promise<void>;
+  onError: (error: unknown) => void | Promise<void>;
+}
+
+export function iapCreateOneTimePurchaseOrder(params: Sku) {
+  const sku = (params.sku ?? params.productId) as string;
+  return AppsInTossModule.iapCreateOneTimePurchaseOrder({ productId: sku });
+}
+
+export function processProductGrant(params: { orderId: string; isProductGranted: boolean }) {
+  return AppsInTossModule.processProductGrant({ orderId: params.orderId, isProductGranted: params.isProductGranted });
+}
+
+export function requestOneTimePurchase(params: IapRequestOneTimePurchaseOptions) {
+  const { options, onEvent, onError } = params;
+  const sku = (options.sku ?? options.productId) as string;
+
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
+    'requestOneTimePurchase',
+    { sku },
+    {
+      onPurchased: (params: { orderId: string }) => {
+        onEvent({ type: 'purchased', data: params });
+      },
+      onSuccess: (result: IapCreateOneTimePurchaseOrderResult) => {
+        onEvent({ type: 'success', data: result });
+      },
+      onError: (error: any) => {
+        onError(error);
+      },
+    }
+  );
+
+  return unregisterCallbacks;
+}
+
+/**
+ * @public
+ * @category 인앱결제
+ * @name createOneTimePurchaseOrder
  * @description
  * 특정 인앱결제 주문서 페이지로 이동해요. 사용자가 상품 구매 버튼을 누르는 상황 등에 사용할 수 있어요. 사용자의 결제는 이동한 페이지에서 진행돼요. 만약 결제 중에 에러가 발생하면 에러 유형에 따라 에러 페이지로 이동해요.
  * @param {IapCreateOneTimePurchaseOrderOptions} params - 인앱결제를 생성할 때 필요한 정보예요.
- * @param {string} params.productId - 주문할 상품의 ID예요.
- * @returns {Promise<IapCreateOneTimePurchaseOrderResult | undefined>} 결제에 성공하면 결제 결과 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 인앱결제를 실행할 수 없어서 `undefined`를 반환해요.
+ * @returns {() => void} 앱브릿지 cleanup 함수를 반환해요. 인앱결제 기능이 끝나면 반드시 이 함수를 호출해서 리소스를 해제해야 해요.
  *
  * @throw {code: "INVALID_PRODUCT_ID"} - 유효하지 않은 상품 ID이거나, 해당 상품이 존재하지 않을 때 발생해요.
  * @throw {code: "PAYMENT_PENDING"} - 사용자가 요청한 결제가 아직 승인을 기다리고 있을 때 발생해요.
@@ -55,6 +122,7 @@ export interface IapCreateOneTimePurchaseOrderResult {
  * @throw {code: "INTERNAL_ERROR"} - 서버 내부 문제로 요청을 처리할 수 없을 때 발생해요.
  * @throw {code: "KOREAN_ACCOUNT_ONLY"} - iOS 환경에서 사용자의 계정이 한국 계정이 아닐 때 발생해요.
  * @throw {code: "USER_CANCELED"} - 사용자가 결제를 완료하지 않고 주문서 페이지를 이탈했을 때 발생해요.
+ * @throw {code: "PRODUCT_NOT_GRANTED_BY_PARTNER"} - 파트너사의 상품 지급이 실패했을 때 발생해요.
  *
  * @example
  * ### 특정 인앱결제 주문서 페이지로 이동하기
@@ -62,38 +130,96 @@ export interface IapCreateOneTimePurchaseOrderResult {
  * ```tsx
  * import { IAP } from "@apps-in-toss/web-framework";
  * import { Button } from "@toss-design-system/react-native";
+ * import { useCallback } from "react";
  *
  * interface Props {
- *   productId: string;
+ *   sku: string;
  * }
  *
- * function IapCreateOneTimePurchaseOrderButton({ productId }: Props) {
- *   async function handleClick() {
- *     try {
- *       await IAP.createOneTimePurchaseOrder({
- *         productId,
- *       });
- *       console.error("인앱결제에 성공했어요");
- *     } catch (error) {
- *       console.error('인앱결제에 실패했어요:', error);
- *     }
- *   }
+ * function IapCreateOneTimePurchaseOrderButton({ sku }: Props) {
+ *   const handleClick = useCallback(async () => {
+ *
+ *     const cleanup = await IAP.createOneTimePurchaseOrder({
+ *       options: {
+ *        sku,
+ *        processProductGrant: ({ orderId }) => {
+ *         // 상품 지급 로직 작성
+ *          return true; // 상품 지급 여부
+ *        }
+ *        },
+ *       onEvent: (event) => {
+ *         console.log(event);
+ *       },
+ *       onError: (error) => {
+ *         console.error(error);
+ *       },
+ *     });
+ *
+ *     return cleanup;
+ *   }, []);
  *
  *   return <Button onClick={handleClick}>구매하기</Button>;
  * }
  * ```
  */
-async function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrderOptions) {
-  const isSupported = isMinVersionSupported({
+function createOneTimePurchaseOrder(params: IapCreateOneTimePurchaseOrderOptions) {
+  const isIAPSupported = isMinVersionSupported({
     android: '5.219.0',
     ios: '5.219.0',
   });
 
-  if (!isSupported) {
-    return;
+  if (!isIAPSupported) {
+    return noop;
+  }
+
+  const isProcessProductGrantSupported = isMinVersionSupported({
+    android: '5.230.0',
+    ios: '5.230.0',
+  });
+
+  const { options, onEvent, onError } = params;
+  const sku = (options.sku ?? options.productId) as string;
+
+  if (!isProcessProductGrantSupported) {
+    const v1 = () => {
+      AppsInTossModule.iapCreateOneTimePurchaseOrder({ productId: sku })
+        .then((response: IapCreateOneTimePurchaseOrderResult) => {
+          Promise.resolve(options.processProductGrant({ orderId: response.orderId }))
+            .then(() => {
+              onEvent({ type: 'success', data: response });
+            })
+            .catch((error: unknown) => {
+              onError(error);
+            });
+        })
+        .catch((error: unknown) => {
+          onError(error);
+        });
+
+      return noop;
+    };
+
+    return v1();
   }
 
-  return AppsInTossModule.iapCreateOneTimePurchaseOrder(params);
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod(
+    'requestOneTimePurchase',
+    { sku },
+    {
+      onPurchased: async (params: { orderId: string }) => {
+        const isProductGranted = await options.processProductGrant(params);
+        await AppsInTossModule.processProductGrant({ orderId: params.orderId, isProductGranted });
+      },
+      onSuccess: (result: IapCreateOneTimePurchaseOrderResult) => {
+        onEvent({ type: 'success', data: result });
+      },
+      onError: (error: unknown) => {
+        onError(error);
+      },
+    }
+  );
+
+  return unregisterCallbacks;
 }
 
 /**
@@ -118,7 +244,7 @@ export interface IapProductListItem {
 /**
  * @public
  * @category 인앱결제
- * @name iapGetProductItemList
+ * @name getProductItemList
  * @description 인앱결제로 구매할 수 있는 상품 목록을 가져와요. 상품 목록 화면에 진입할 때 호출해요.
  * @returns {Promise<{ products: IapProductListItem[] } | undefined>} 상품 목록을 포함한 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 `undefined`를 반환해요.
  *