대기 중인 목록 가져오기

지원환경: React NativeReact Native SDKv1.4.2WebViewWebView SDKv1.4.2

실행환경: Toss AppiOSv5.231.0Androidv5.235.0Sandbox AppiOS2025-10-28Android2025-10-22

getPendingOrders

getPendingOrders 는 결제는 완료되었지만 상품이 아직 지급되지 않은 주문 목록을 가져오는 함수예요.
조회된 주문 정보를 확인하여 사용자에게 상품을 지급하세요.
createOneTimePurchaseOrder 함수 호출 후 결과를 받지 못한 경우에도 해당 주문을 조회할 수 있어요.

앱 버전이 최소 지원 버전(안드로이드 5.234.0, iOS 5.231.0)보다 낮으면 undefined를 반환해요.

시그니처

function getPendingOrders(): Promise<{ orders: Order[] } | undefined>;

반환값

• Promise<{ orders: Order[] } | undefined>
  

  대기 중인 주문 목록(orders)을 포함한 객체를 반환해요.
  앱 버전이 최소 지원 버전(안드로이드 5.234.0, iOS 5.231.0)보다 낮으면 undefined를 반환해요.

반환 객체 프로퍼티

interface Order {
  orderId: string;
  sku: string;
}

• orders필수 · Order[]
  

  대기 중인 주문의 배열이에요. 대기 중인 주문이 없으면 빈 배열을 반환해요.

• orders[].orderId필수 · string
  

  주문의 고유 ID 예요.

• orders[].sku필수 · string
  

  주문 상품의 고유 ID 예요.

sku 필드가 추가되었어요

SDK 1.4.2 버전에서 sku 필드가 추가되었어요.
해당 필드는 안드로이드 5.234.0 이상, iOS 5.231.0 이상 에서만 반환돼요.

예제

React

import { IAP } from '@apps-in-toss/web-framework';
async function fetchOrders() {
  try {
    const pendingOrders = await IAP.getPendingOrders();
    return pendingOrders;
  } catch (error) {
    console.error(error);
  }
}

ReactNative

import { IAP } from '@apps-in-toss/framework';
async function fetchOrders() {
 try {
   const pendingOrders = await IAP.getPendingOrders();
   return pendingOrders;
 } catch (error) {
   console.error(error);
 }
}