---
title: "(주문형-네이버페이) 구매자의 환불요청 승인처리 API"
method: POST
path: "/payments/{imp_uid}/naver/approve-cancel"
tags: ["naver"]
---

# (주문형-네이버페이) 구매자의 환불요청 승인처리 API

`POST /payments/{imp_uid}/naver/approve-cancel`

## Request

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

네이버페이 주문형 구매자가 환불요청한 상품주문들을 환불승인처리합니다. 상품발주처리 중 구매자의 환불요청이 있는 경우, 최종 환불처리를 위해서는 판매자의 승인이 필요하므로 본 API 를 사용하셔야 합니다.<br>
             주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래고유번호(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 환불승인처리할 수 있습니다.
             시도된 상품주문 중 <b>환불승인처리에 성공한 상품주문</b>에 대한 최종 정보만 제공됩니다.

## Path parameters

- `imp_uid` string, required

## Request body `application/x-www-form-urlencoded`

- object

## 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

- `207`: 일부주문 환불승인성공 & 일부주문 환불승인실패<br>포트원에서 네이버페이에 환불승인요청시 product_order_id 개별로 환불승인요청이 진행되어야 합니다. 일부 건만 성공하는 경우 207 응답이 내려갑니다. (모두 성공인 경우 200응답 / 모두 실패인 경우 500응답)
- `401`: 인증 Token이 전달되지 않았거나 유효하지 않은 경우
- `404`: imp_uid에 해당되는 거래건을 찾을 수 없거나 접근 권한이 없는 계정인 경우
- `500`: 모든주문 환불승인실패

---

[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)