---
title: "(주문형-네이버페이) 포트원 거래고유번호 기준 네이버페이 상품주문 조회 API"
method: GET
path: "/payments/{imp_uid}/naver/product-orders"
tags: ["naver"]
---

# (주문형-네이버페이) 포트원 거래고유번호 기준 네이버페이 상품주문 조회 API

`GET /payments/{imp_uid}/naver/product-orders`

## Request

- Base URL: `https://api.iamport.kr`
- URL: `https://api.iamport.kr/payments/{imp_uid}/naver/product-orders`
- Auth: none declared
- TypeScript: <https://skmtc.dev/iamport/apis/rest-api/docs/payments/:imp_uid/naver/product-orders/get.ts> (a function with typed inputs; its response is checked against the schema)

(주문형-네이버페이) 포트원 거래번호 기준으로 네이버페이 상품주문 목록을 조회합니다. (배열 반환)<br><br>
     네이버페이의 경우 주문하는 상품의 종류별로 주문번호(product_order_id)를 관리합니다. 포트원 거래건 당 1개 이상의 네이버페이 상품주문이 연결되므로,
     포트원 거래고유번호(imp_uid)에 매핑된 1개 이상의 네이버페이 상품주문번호(product_order_id) 및 상세 내역을 조회할 수 있습니다.<br><br>
     <h3>응답 안내</h3>
     <h4>product_order_status</h4><ul>
     <li>PAYMENT_WAITING : 입금 대기</li>
     <li>PAYED : 결제 완료</li>
     <li>DELIVERING : 배송 중</li>
     <li>DELIVERED : 배송 완료</li>
     <li>PURCHASE_DECIDED : 구매 확정</li>
     <li>EXCHANGED : 교환 완료</li>
     <li>CANCELED : 취소 완료</li>
     <li>RETURNED : 반품 완료</li>
     <li>CANCELED_BY_NOPAYMENT : 미입금 취소</li> </ul>
     <h4>claim_type</h4><ul>
     <li>CANCEL : 취소</li>
     <li>RETURN : 반품</li>
     <li>EXCHANGE : 교환</li>
     <li>PURCHASE_DECISION_HOLDBACK : 구매 확정 보류</li>
     <li>ADMIN_CANCEL : 직권 취소</li></ul>
     <h4>claim_status</h4><h4>[ claim_type : CANCEL 일 때 ]</h4><ul>
     <li>CANCEL_REQUEST : 취소 요청</li><li>CANCELING : 취소 처리 중</li>
     <li>CANCEL_DONE : 취소 처리 완료</li><li>CANCEL_REJECT : 취소 철회</li></ul>
     <h4>[ claim_type : RETURN 일 때 ]</h4>
     <ul><li>RETURN_REQUEST : 반품 요청</li><li>COLLECTING : 수거 처리 중</li><li>COLLECT_DONE : 수거 완료</li><li>RETURN_DONE : 반품 완료</li><li>RETURN_REJECT : 반품 철회</li></ul>
     <h4>[ claim_type : EXCHANGE 일 때 ]</h4>
     <ul><li>EXCHANGE_REQUEST : 교환 요청</li>
     <li>COLLECTING : 수거 처리 중</li>
     <li>COLLECT_DONE : 수거 완료(교환)</li>
     <li>EXCHANGE_REDELIVERING : 교환 재배송 중</li>
     <li>EXCHANGE_DONE : 교환 완료</li>
     <li>EXCHANGE_REJECT : 교환 거부</li></ul>
     <h4>[ claim_type : PURCHASE_DECISION_HOLDBACK 일 때 ]</h4>
     <ul><li>PURCHASE_DECISION_HOLDBACK : 구매 확정 보류</li>
     <li>PURCHASE_DECISION_HOLDBACK_REDELIVERING : 구매 확정 보류 재배송 중</li>
     <li>PURCHASE_DECISION_REQUEST : 구매 확정 요청</li>
     <li>PURCHASE_DECISION_HOLDBACK_RELEASE : 구매 확정 보류 해제</li></ul>
     <h4>[ claim_type : ADMIN_CANCEL 일 때 ]</h4>
     <ul><li>ADMIN_CANCELING : 직권 취소 중</li><li>ADMIN_CANCEL_DONE : 직권 취소 완료</li></ul>

## Path parameters

- `imp_uid` string, required

## Response `200`

네이버페이 상품주문 조회 성공

- NaverProductOrderArrayResponse: 네이버페이 상품주문 상세정보. 바로 아래 NaverProductOrder structure를 확인하세요
  - `code` integer: 0이면 정상적인 조회, 0아닌 값이면 message를 확인해봐야 합니다
  - `message` string: code값이 0이 아닐 때, '존재하지 않는 결제정보입니다'와 같은 오류 메세지를 포함합니다
  - `response` NaverProductOrderAnnotation[]
    - `product_order_id` string, required: 네이버페이 상품주문번호
    - `product_order_status` string, required: 네이버페이 상품주문상태
    - `claim_type` string: 네이버페이 상품주문관련 클레임 타입(취소/교환/환불 등 클레임에 대한 유형)
    - `claim_status` string: 네이버페이 상품주문관련 클레임에 대한 처리 상태(취소/교환/환불 등 클레임에 대해 처리 진행 상태)
    - `product_id` string, required: 네이버페이 상품주문의 상품 고유번호
    - `product_name` string, required: 네이버페이 상품주문의 상품명
    - `product_option_id` string, required: 네이버페이 상품주문의 상품옵션 고유번호
    - `product_option_name` string, required: 네이버페이 상품주문의 상품옵션명
    - `product_amount` integer: 네이버페이 개별상품 주문금액
    - `delivery_amount` integer: 네이버페이 개별상품 배송비
    - `quantity` integer, required: 네이버페이 상품주문의 상품 수량
    - `orderer` NaverOrderer
      - `name` string, required: 주문자 이름
      - `id` string, required: 주문자 마스킹된 네이버 아이디
      - `tel` string, required: 주문자 연락처
    - `shipping_address` NaverAddress
      - `base` string, required: 기본 주소
      - `detail` string: 상세 주소
      - `postcode` string, required: 우편번호
      - `tel1` string, required: 연락처1
      - `tel2` string: 연락처2
      - `name` string, required: 대상 이름
    - `shipping_memo` string: 네이버페이 상품주문별 배송메모
    - `shipping_due` integer: 네이버페이 상품주문별 배송기한 Unix Timestamp
    - `individual_code` string: 네이버페이 주문자의 개인통고유부호

## Other responses

- `401`: 인증 Token이 전달되지 않았거나 유효하지 않은 경우
- `404`: imp_uid에 해당되는 거래건을 찾을 수 없거나 접근 권한이 없는 계정인 경우

---

[API](https://skmtc.dev/iamport/apis/rest-api.md) - [All operations](https://skmtc.dev/iamport/apis/rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/iamport/apis/rest-api/revisions/006dfffdec43?raw)