查詢退貨/取消訂單記錄

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