IAP.getPendingOrders

기능 설명

대기 중인 주문 목록을 가져와요. 아직 결제가 완료되지 않은 주문을 확인할 수 있어요.

토스앱 Android 5.234.0, iOS 5.231.0 이상에서 사용할 수 있어요. 미지원 버전에서 호출하면 UNSUPPORTED_APP_VERSION 에러가 발생해요.

타입

IAP.getPendingOrders(): Promise<{ orders: Array<{ orderId: string; sku: string; paymentCompletedDate: string }> }>;

Params

없음

Response

{
  orders: Array<{
    orderId: string;
    sku: string;
    paymentCompletedDate: string;
  }>;
}

에러

에러 코드는 catch한 에러의 error.code 값이에요.

코드	설명
UNSUPPORTED_APP_VERSION	실행 중인 토스앱 버전이 이 기능을 지원하지 않으면 호출 즉시 발생해요. IAP.getPendingOrders.isSupported()로 사전 확인하고, 발생 시 error.message(업데이트 안내 문구)를 사용자에게 보여주세요.

예시 코드

import { IAP } from "@apps-in-toss/web-framework";

try {
  const pendingOrders = await IAP.getPendingOrders();
  console.log(pendingOrders.orders);
} catch (error) {
  console.error(error);
}