latestOpenAPI 3.0.12026-08-1092443.0 KB

57a25c0addc6

주문

주문 내역 조회

커서 기반 페이지네이션을 사용하여 주문 내역을 조회합니다.

조회 조건

  • 조회 범위는 최대 31일까지 조회 가능합니다
  • status 파라미터를 생략하면 전체 주문 상태를 조회합니다
  • limit은 최소 1, 최대 50까지 설정 가능하며, 범위를 벗어나면 자동으로 50으로 조정됩니다

페이지네이션

  • 첫 페이지 조회 시 nextCursor를 생략합니다
  • 다음 페이지 조회 시 응답으로 받은 nextCursor 값을 그대로 전달합니다
  • 응답의 nextCursor가 null이면 마지막 페이지입니다
get/api/v3/shopping-fep/orders/v2

Query parameters

status'PAID' | 'CANCELED_PAYMENT' | 'PREPARING_PRODUCT' | 'DELIVERING' | 'DELIVERED' | 'CONFIRMED_ORDER'

조회용 주문 상품 상태 (생략 시 전체 조회)

startDatestring date required

조회 시작일자 (yyyy-MM-dd)

endDatestring date required

조회 종료일자 (yyyy-MM-dd). 조회 범위는 최대 31일

nextCursorstring

다음 페이지를 위한 커서 (직전 호출에서 받은 nextCursor를 그대로 전달)

limitinteger

페이지 사이즈 (기본값: 20, 최대 50)

partnerNamestring

연동 프로그램명 또는 자사 서비스명

Response

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

resultType'SUCCESS' | 'FAIL'

응답 결과 타입