查詢退貨/取消訂單記錄

API 適用的买方用户區域：韓國、台灣

您可根據受理日期查詢退貨/取消申請記錄。 

傳送商品前，請務必透過【退貨申請陣列查詢】確認是否有商品受理了“申請停止發貨”。 

您可根據searchType=timeframe 設定以分鐘/天為單位進行查詢。 

查詢在已付款階段被取消的訂單時，除orderId引數外，還須使用cancelType=CANCEL引數。 

         請下載以下資料，確認各退貨訂單的退貨原因(reasonCode)。 

[下載] 換貨/退貨/取消原因程式碼   

您可將查詢週期設定為最長31天。資料量大時，查詢可能會出現超時錯誤，因此我們建議您將週期設定得越短越好。 

顧客申請停止發貨時（在商品準備階段受理退貨申請時），可在RU（申請停止發貨）和UC（申請退貨）狀態下檢視。 

路徑

GET

/v2/providers/openapi/apis/api/v6/vendors/{vendorId}/returnRequests

例子

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v6/vendors/vendorid/returnRequests?createdAtFrom=2025-07-24&createdAtTo=2025-07-24&cancelType=CANCEL

請求 header 除 Authorization 和 X-Requested-By 之外需要額外添加：

X-MARKET: TW

路徑引數

查詢引數

請求體例子

無 

返回訊息

返回訊息例子

{
   "code": 200,
   "message": "OK",
   "data": [
       {
           "receiptId": 50229613,
           "orderId": 28000008707838,
           "paymentId": 28000009486604,
           "receiptType": "RETURN",
           "receiptStatus": "RETURNS_UNCHECKED",
           "createdAt": "2025-01-15T14:17:13.973885-08:00",
           "modifiedAt": "2025-01-15T14:17:13.973885-08:00",
           "requesterName": "구*숙",
           "requesterPhoneNumber": "+1(555)444-1234",
           "requesterRealPhoneNumber": null,
           "requesterAddress": "서울특별시 송파구 송파대로 570 (신천동)",
           "requesterAddressDetail": "Tower 730",
           "requesterZipCode": "05510",
           "cancelReasonCategory1": "고객변심",
           "cancelReasonCategory2": "단순변심(사유없음)",
           "cancelReason": "",
           "cancelCountSum": 1,
           "returnDeliveryId": 20234047,
           "returnDeliveryType": "연동택배",
           "releaseStopStatus": "처리(이미출고)",
           "enclosePrice": {
               "currencyCode": "KRW",
               "units": 0,
               "nanos": 0
           },
           "faultByType": "CUSTOMER",
           "preRefund": false,
           "completeConfirmDate": "",
           "completeConfirmType": "UNDEFINED",
           "returnItems": [
               {
                   "vendorItemPackageId": 0,
                   "vendorItemPackageName": "스파오(SPAO) (#)시원하고 편안한 캉캉 롱스커트",
                   "vendorItemId": 3187044096,
                   "vendorItemName": "스파오(SPAO) (#)시원하고 편안한 캉캉 롱스커트, (19)Black, S",
                   "purchaseCount": 1,
                   "cancelCount": 1,
                   "shipmentBoxId": 123456789012345678,
                   "sellerProductId": 57623797,
                   "sellerProductName": "스파오 (#)시원하고 편안한 캉캉 롱스커트,(19)Black S",
                   "releaseStatus": "S",
                   "cancelCompleteUser": "l******"
               }
           ],
           "returnDeliveryDtos": [
               {
                   "deliveryCompanyCode": "CJGLS",
                   "deliveryInvoiceNo": "*******"
               }
           ],
           "reasonCode": "CHANGEMIND",
           "reasonCodeText": "필요 없어짐 (단순 변심)",
           "returnShippingCharge": {
               "currencyCode": "KRW",
               "units": -3000,
               "nanos": 0
           }
       }
   ]

 nextToken: ""
}

錯誤程式碼

介面名稱

GET_RETURN_REQUEST_BY_QUERY