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

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,15 +325,145 @@ 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 인앱결제
+ * @name completeProductGrant
+ * @description 상품 지급 처리를 완료했다는 메시지를 앱에 전달해요. 이 함수를 사용하면 결제가 완료된 주문의 상품 지급이 정상적으로 완료되었음을 알릴 수 있어요.
+ * @param {{ params: { orderId: string } }} params 결제가 완료된 주문 정보를 담은 객체예요.
+ * @param {string} params.orderId 주문의 고유 ID예요. 상품 지급을 완료할 주문을 지정할 때 사용해요.
+ * @returns {Promise<boolean>} 상품 지급이 완료됐는지 여부를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.233.0, iOS 5.233.0)보다 낮으면 `undefined`를 반환해요.
+ *
+ * @example
+ * ### 결제를 성공한 뒤 상품을 지급하는 예시
+ * ```typescript
+ * import { IAP } from '@apps-in-toss/framework';
+ *
+ * async function handleGrantProduct(orderId: string) {
+ *   try {
+ *     await IAP.completeProductGrant({ params: { orderId } });
+ *   } catch (error) {
+ *     console.error(error);
+ *   }
+ * }
+ * ```
+ */
+async function completeProductGrant(params: { params: { orderId: string } }) {
+  const isSupported = isMinVersionSupported({
+    android: '5.233.0',
+    ios: '5.233.0',
+  });
+
+  if (!isSupported) {
+    return;
+  }
+
+  return AppsInTossModule.completeProductGrant(params);
+}
+
 /**
  * @public
  * @category 인앱결제
  * @name IAP
  * @description 인앱결제 관련 기능을 모은 객체예요. 단건 인앱결제 주문서 이동과 상품 목록 조회 기능을 제공해요.
- * @property {typeof createOneTimePurchaseOrder} [createOneTimePurchaseOrder] 특정 인앱결제 주문서 페이지로 이동해요. 자세한 내용은 [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/getProductItemList.html) 문서를 참고하세요.
- * @property {typeof getProductItemList} [getProductItemList] 인앱결제로 구매할 수 있는 상품 목록을 가져와요. 자세한 내용은 [getProductItemList](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) 문서를 참고하세요.
+ * @property {typeof createOneTimePurchaseOrder} [createOneTimePurchaseOrder] 특정 인앱결제 주문서 페이지로 이동해요. 자세한 내용은 [createOneTimePurchaseOrder](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/createOneTimePurchaseOrder.html) 문서를 참고하세요.
+ * @property {typeof getProductItemList} [getProductItemList] 인앱결제로 구매할 수 있는 상품 목록을 가져와요. 자세한 내용은 [getProductItemList](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/getProductItemList.html) 문서를 참고하세요.
+ * @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) 문서를 참고하세요.
  */
 export const IAP = {
   createOneTimePurchaseOrder,
   getProductItemList,
+  getPendingOrders,
+  getCompletedOrRefundedOrders,
+  completeProductGrant,
 };

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

@@ -54,6 +54,7 @@ export * from './openGameCenterLeaderboard';
 export * from './getGameCenterGameProfile';
 export * from './submitGameCenterLeaderBoardScore';
 export * from '../native-event-emitter/contactsViral';
+export * from './appsInTossSignTossCert';
 
 export type {
   LoadAdMobInterstitialAdEvent,

package/src/async-bridges.ts

@@ -24,6 +24,7 @@ export * from './AppsInTossModule/native-modules/getTossShareLink';
 export * from './AppsInTossModule/native-modules/setDeviceOrientation';
 export * from './AppsInTossModule/native-modules/checkoutPayment';
 export * from './AppsInTossModule/native-modules/saveBase64Data';
+export * from './AppsInTossModule/native-modules/appsInTossSignTossCert';
 export * from './AppsInTossModule/native-modules/getGameCenterGameProfile';
 export * from './AppsInTossModule/native-modules/openGameCenterLeaderboard';
 export * from './AppsInTossModule/native-modules/submitGameCenterLeaderBoardScore';

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;
+  }
+}