Lingxing
切换旧版

订单退款

POST/basicOpen/openapi/salesOrder/refundOrder

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/openapi/salesOrder/refundOrderHTTPSPOST1

请求参数

sidnumber必填
店铺id
amazonOrderIdstring必填
亚马逊订单ID
purchaseDateLocalstring必填
订购时间
dataarray<object>
隐藏子属性
orderItemIdstring必填
商品行id
asinstring必填
asin
sellerSkustring必填
msku
titlestring必填
商品名称
quantityOrderednumber必填
下单数量
quantityShippednumber必填
到货数量
reasonstring必填
退款原因
CustomerReturn
GeneralAdjustment
asinUrlstring
asinUrl
smallImageUrlstring
商品图片
unitPriceIconstring
商品单价货币符号
unitPriceAmountnumber
单价
itemListarray<object>
退款费用项目列表
隐藏子属性
typestring必填
费用类型
namestring
费用名称
currencyCodestring必填
货币编码
iconstring
货币符号
amountnumber
金额
refundedPricestring
已申请退款金额
returnAmountstring必填
本次申请退款金额
itemRefundTotalstring必填

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/openapi/salesOrder/refundOrder?access_token=value&sign=value&timestamp=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "sid": 17,
    "amazonOrderId": "111-4279745-7077814",
    "purchaseDateLocal": "2025-10-24 20:17:13",
    "data": [{
        "orderItemId": "542711111546",
        "asin": "B081111CF",
        "sellerSku": "1704111123",
        "title": "xxxxxxxxxxx",
        "quantityOrdered": 1,
        "quantityShipped": 1,
        "reason": "Other",
        "asinUrl": "https://www.amazon.com/dp/B11111",
        "smallImageUrl": "",
        "unitPriceIcon": "$",
        "unitPriceAmount": 192.78,
        "itemList": [{
            "type": "Principal",
            "name": "商品",
            "currencyCode": "USD",
            "icon": "$",
            "amount": 192.78,
            "refundedPrice": "0.00",
            "returnAmount": "1999"
        }],
        "itemRefundTotal": "208.68"
    }]
}'

返回结果

codenumber必填
状态码，0成功
示例 0
messagestring必填
提示信息
示例 success
error_detailsarray<any>必填
错误信息
示例 []
request_idstring必填
请求链路id
示例 1ad812bb5273462c9d2077107ff7cd99.1757412110374
response_timestring必填
响应时间
示例 2025-09-09 18:01:52
dataobject

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "1ad812bb5273462c9d2077107ff7cd99.1757412110374",
    "response_time": "2025-09-09 18:01:52",
    "data": null
}

附加说明

1）：亚马逊API限制：如同一订单存在多个商品，退款无法仅退某个商品，如需按比例退款，请自行分配每个商品退款比例。 2）：type枚举类如下： Principal 商品 Tax 商品税 Shipping 配送费 ShippingTax 配送税 GiftWrap 包装费 GiftWrapTax 包装税 COD 货到付款 ReturnShipping 退货优惠 RestockingFee 重新入库费 RestockingFeeTax 重新入库税