네이버페이 관련 API
네이버페이에서 지원하는 기능을 제공합니다.
(주문형-네이버페이) 네이버페이 주문환불 API
post/payments/{imp_uid}/naver/cancel(주문형-네이버페이) 네이버페이 상품주문들을 환불처리합니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래건(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 환불처리할 수 있습니다. 시도된 상품주문 중 환불처리에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래건(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 환불처리할 수 있습니다. 시도된 상품주문 중 환불처리에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
(주문형-네이버페이) 구매자의 환불요청 승인처리 API
post/payments/{imp_uid}/naver/approve-cancel네이버페이 주문형 구매자가 환불요청한 상품주문들을 환불승인처리합니다. 상품발주처리 중 구매자의 환불요청이 있는 경우, 최종 환불처리를 위해서는 판매자의 승인이 필요하므로 본 API 를 사용하셔야 합니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래고유번호(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 환불승인처리할 수 있습니다. 시도된 상품주문 중 환불승인처리에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래고유번호(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 환불승인처리할 수 있습니다. 시도된 상품주문 중 환불승인처리에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
(주문형-네이버페이) 상품주문 발송처리 API
post/payments/{imp_uid}/naver/ship(주문형-네이버페이) 네이버페이 상품주문들을 발송처리합니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래건(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 발송처리할 수 있습니다. 시도된 상품주문 중 발송처리에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래건(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 발송처리할 수 있습니다. 시도된 상품주문 중 발송처리에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
(주문형-네이버페이) 교환승인된 상품 재발송처리 API
post/payments/{imp_uid}/naver/ship-exchanged(주문형-네이버페이) 네이버페이 교환승인된 상품주문들을 재발송처리합니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래건(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 재발송처리할 수 있습니다. 시도된 상품주문 중 재발송처리에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래건(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 재발송처리할 수 있습니다. 시도된 상품주문 중 재발송처리에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
(주문형-네이버페이) 교환승인된 상품 수거완료처리 API
post/payments/{imp_uid}/naver/collect-exchanged(주문형-네이버페이) 네이버페이 교환승인된 상품주문들을 수거완료처리합니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래건(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 수거완료처리할 수 있습니다. 시도된 상품주문 중 수거완료처리에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래건(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 수거완료처리할 수 있습니다. 시도된 상품주문 중 수거완료처리에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
(주문형-네이버페이) 상품발주처리 API
post/payments/{imp_uid}/naver/place(주문형-네이버페이) 네이버페이 상품주문들을 발주처리합니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래건(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 발주처리할 수 있습니다. 시도된 상품주문 중 발주처리에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래건(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 발주처리할 수 있습니다. 시도된 상품주문 중 발주처리에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
(주문형-네이버페이) 상품반품요청 API
post/payments/{imp_uid}/naver/request-return(주문형-네이버페이) 네이버페이 상품주문들을 반품요청합니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래건(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 반품요청할 수 있습니다. 시도된 상품주문 중 반품요청에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래건(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 반품요청할 수 있습니다. 시도된 상품주문 중 반품요청에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
(주문형-네이버페이) 상품 반품승인 처리 API
post/payments/{imp_uid}/naver/approve-return(주문형-네이버페이) 네이버페이 상품주문들을 반품승인처리합니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래건(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 반품승인 처리할 수 있습니다. 반품시 배송비 제외, 혹은 추가 청구액이 필요한 경우 반품보류 처리(POST 반품요청상품 반품보류 처리 API) 사용합니다.
시도된 상품주문 중 반품승인 처리에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래건(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 반품승인 처리할 수 있습니다. 반품시 배송비 제외, 혹은 추가 청구액이 필요한 경우 반품보류 처리(POST 반품요청상품 반품보류 처리 API) 사용합니다.
시도된 상품주문 중 반품승인 처리에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
(주문형-네이버페이) 상품 반품거절 처리 API
post/payments/{imp_uid}/naver/reject-return(주문형-네이버페이) 네이버페이 반품요청 상품주문들을 반품거절처리합니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래건(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 반품거절 처리할 수 있습니다. 시도된 상품주문 중 반품거절 처리에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래건(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 반품거절 처리할 수 있습니다. 시도된 상품주문 중 반품거절 처리에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
(주문형-네이버페이) 상품 반품보류 처리 API
post/payments/{imp_uid}/naver/withhold-return(주문형-네이버페이) 반품요청 상품주문들을 반품보류처리합니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래건(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 반품보류 처리할 수 있습니다. 시도된 상품주문 중 반품보류 처리에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래건(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 반품보류 처리할 수 있습니다. 시도된 상품주문 중 반품보류 처리에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
(주문형-네이버페이) 반품보류상품 반품보류해제 처리 API
post/payments/{imp_uid}/naver/resolve-return(주문형-네이버페이) 반품보류 상품주문들을 반품보류해제처리합니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래건(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 반품보류해제 처리할 수 있습니다. 시도된 상품주문 중 반품보류해제 처리에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
주문상품의 종류가 여러 개인 경우, 한 건의 포트원 거래건(imp_uid)에 여러 개의 네이버페이 상품주문이 존재하며 일부 또는 전체를 반품보류해제 처리할 수 있습니다. 시도된 상품주문 중 반품보류해제 처리에 성공한 상품주문에 대한 최종 정보만 제공됩니다.
(결제형-네이버페이) 네이버페이 포인트 적립 API
post/payments/{imp_uid}/naver/point(결제형-네이버페이) 네이버페이 포인트 적립 API
(결제형-네이버페이) 에스크로 주문 확정 API
post/payments/{imp_uid}/naver/confirm(결제형-네이버페이) 에스크로 주문 확정
(주문형-네이버페이) 포트원 거래고유번호 기준 네이버페이 상품주문 조회 API
get/payments/{imp_uid}/naver/product-orders(주문형-네이버페이) 포트원 거래번호 기준으로 네이버페이 상품주문 목록을 조회합니다. (배열 반환)
네이버페이의 경우 주문하는 상품의 종류별로 주문번호(product_order_id)를 관리합니다. 포트원 거래건 당 1개 이상의 네이버페이 상품주문이 연결되므로, 포트원 거래고유번호(imp_uid)에 매핑된 1개 이상의 네이버페이 상품주문번호(product_order_id) 및 상세 내역을 조회할 수 있습니다.
네이버페이의 경우 주문하는 상품의 종류별로 주문번호(product_order_id)를 관리합니다. 포트원 거래건 당 1개 이상의 네이버페이 상품주문이 연결되므로, 포트원 거래고유번호(imp_uid)에 매핑된 1개 이상의 네이버페이 상품주문번호(product_order_id) 및 상세 내역을 조회할 수 있습니다.
응답 안내
product_order_status
- PAYMENT_WAITING : 입금 대기
- PAYED : 결제 완료
- DELIVERING : 배송 중
- DELIVERED : 배송 완료
- PURCHASE_DECIDED : 구매 확정
- EXCHANGED : 교환 완료
- CANCELED : 취소 완료
- RETURNED : 반품 완료
- CANCELED_BY_NOPAYMENT : 미입금 취소
claim_type
- CANCEL : 취소
- RETURN : 반품
- EXCHANGE : 교환
- PURCHASE_DECISION_HOLDBACK : 구매 확정 보류
- ADMIN_CANCEL : 직권 취소
claim_status
[ claim_type : CANCEL 일 때 ]
- CANCEL_REQUEST : 취소 요청
- CANCELING : 취소 처리 중
- CANCEL_DONE : 취소 처리 완료
- CANCEL_REJECT : 취소 철회
[ claim_type : RETURN 일 때 ]
- RETURN_REQUEST : 반품 요청
- COLLECTING : 수거 처리 중
- COLLECT_DONE : 수거 완료
- RETURN_DONE : 반품 완료
- RETURN_REJECT : 반품 철회
[ claim_type : EXCHANGE 일 때 ]
- EXCHANGE_REQUEST : 교환 요청
- COLLECTING : 수거 처리 중
- COLLECT_DONE : 수거 완료(교환)
- EXCHANGE_REDELIVERING : 교환 재배송 중
- EXCHANGE_DONE : 교환 완료
- EXCHANGE_REJECT : 교환 거부
[ claim_type : PURCHASE_DECISION_HOLDBACK 일 때 ]
- PURCHASE_DECISION_HOLDBACK : 구매 확정 보류
- PURCHASE_DECISION_HOLDBACK_REDELIVERING : 구매 확정 보류 재배송 중
- PURCHASE_DECISION_REQUEST : 구매 확정 요청
- PURCHASE_DECISION_HOLDBACK_RELEASE : 구매 확정 보류 해제
[ claim_type : ADMIN_CANCEL 일 때 ]
- ADMIN_CANCELING : 직권 취소 중
- ADMIN_CANCEL_DONE : 직권 취소 완료
(주문형-네이버페이) 네이버페이 상품주문번호로 상품주문 상세 조회 API
get/naver/product-orders/{product_order_id}(주문형-네이버페이) 네이버페이 상품주문번호 기준 네이버페이 상품주문을 조회합니다. (단건 반환)
네이버페이 상품주문번호(product_order_id)를 통해 해당되는 상품주문정보 단건을 조회할 수 있습니다.
네이버페이 상품주문번호(product_order_id)를 통해 해당되는 상품주문정보 단건을 조회할 수 있습니다.
product_order_status
- PAYMENT_WAITING : 입금 대기
- PAYED : 결제 완료
- DELIVERING : 배송 중
- DELIVERED : 배송 완료
- PURCHASE_DECIDED : 구매 확정
- EXCHANGED : 교환 완료
- CANCELED : 취소 완료
- RETURNED : 반품 완료
- CANCELED_BY_NOPAYMENT : 미입금 취소
claim_type
- CANCEL : 취소
- RETURN : 반품
- EXCHANGE : 교환
- PURCHASE_DECISION_HOLDBACK : 구매 확정 보류
- ADMIN_CANCEL : 직권 취소
claim_status
[ claim_type : CANCEL 일 때 ]
- CANCEL_REQUEST : 취소 요청
- CANCELING : 취소 처리 중
- CANCEL_DONE : 취소 처리 완료
- CANCEL_REJECT : 취소 철회
[ claim_type : RETURN 일 때 ]
- RETURN_REQUEST : 반품 요청
- COLLECTING : 수거 처리 중
- COLLECT_DONE : 수거 완료
- RETURN_DONE : 반품 완료
- RETURN_REJECT : 반품 철회
[ claim_type : EXCHANGE 일 때 ]
- EXCHANGE_REQUEST : 교환 요청
- COLLECTING : 수거 처리 중
- COLLECT_DONE : 수거 완료(교환)
- EXCHANGE_REDELIVERING : 교환 재배송 중
- EXCHANGE_DONE : 교환 완료
- EXCHANGE_REJECT : 교환 거부
[ claim_type : PURCHASE_DECISION_HOLDBACK 일 때 ]
- PURCHASE_DECISION_HOLDBACK : 구매 확정 보류
- PURCHASE_DECISION_HOLDBACK_REDELIVERING : 구매 확정 보류 재배송 중
- PURCHASE_DECISION_REQUEST : 구매 확정 요청
- PURCHASE_DECISION_HOLDBACK_RELEASE : 구매 확정 보류 해제
[ claim_type : ADMIN_CANCEL 일 때 ]
- ADMIN_CANCELING : 직권 취소 중
- ADMIN_CANCEL_DONE : 직권 취소 완료
(주문형-네이버페이) 네이버페이 구매평 조회 API
get/naver/reviews(주문형-네이버페이) 네이버페이 구매평 조회 API
(결제형-네이버페이) 현금영수증 발급 가용액 조회 API
get/payments/{imp_uid}/naver/cash-amount(결제형-네이버페이) 현금영수증 발급 가용액 조회 API
타입 정의
API 요청/응답의 각 필드에서 사용되는 타입 정의들을 확인할 수 있습니다
NaverAddress: { base, detail, postcode, ... }
NaverCashAmountAnnotation: { amount_total, amount_by_npoint, amount_by_primary, ... }
NaverCashAmountResponse: { code, message, response }
NaverOrderer: { name, id, tel }
NaverProductOrderAnnotation: { product_order_id, product_order_status, claim_type, ... }
NaverProductOrderArrayResponse: { code, message, response }
NaverProductOrderResponse: { code, message, response }
NaverReviewAnnotation: { review_id, score, title, ... }
NaverReviewsResponse: { code, message, response }
ResponseAnnotation: { code, message }