文档中心 电商接口 商品退款

商品退款

1.功能说明

针对未进入商家已备货状态的订单下商品(商品级别,非订单级别)进行退货退款(如果已备货,则无法退款)。发货状态,通过调用查询买家订单详情接口获取

2.接口调用说明

请求URL

https://openapi.guanaitong.tech/commerce/order/refundApply

正式环境和测试环境的域名请见通用协议

HTTPS请求方式

POST

输入参数说明

(1)公共参数

发送请求是必须传入公共参数,详见公共参数

(2)私有参数

参数名称 是否必须 参数类型 长度限制 描述
shop_order_detail_id Long [] 购买商品明细ID,通过调用查询买家订单详情接口获取
customer_claim_no Integer [1-99999999] 客户退款请求的申诉单ID,做记录和查问题时使用,可重复
refund_num Integer [] 商品件数
refund_amount BigDecimal [0.01~99999999.99] 退款金额,总金额,多件商品时是单价x件数,小数点后两位
请求示例
POST /commerce/order/refundApply HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
cache-control: no-cache

access_token=48b3b588d536ef9082223f8368a17140&sign=39c4b425ce9aaba0ff9ae2bc8fa82837b4c294d9
&shop_order_detail_id=112&timestamp=1573784826&customer_claim_no=1928212&refund_num=1&refund_amount=10.00
                    
返回参数说明
参数名称 描述
code 返回码。详见错误代码
msg 如果错误,返回错误信息。
data 返回退款的账单编号
正确返回示例
{
	"code": 0,
	"data": "K102122",
	"msg": "OK"
}
                    
错误返回示例
{"code":1000210002,"data":null,"msg":"sign check failed!"}