卖家同意退款
卖家同意退款,支持批量退款,只允许子账号操作。淘宝退款一次最多能退20笔,总金额不超过6000元;天猫退款一次最多能退30笔,总金额不超过10000元。
1.请求参数:
请求URL:
参数名 | 类型 | 说明 | 示例 |
---|---|---|---|
appid | String | 合作伙伴AppId | uwkahf@jfs92 |
timestamp | String | 当前时间戳 | |
tb_seller_nick | String | 淘宝卖家店铺登录账号,非店铺名称 | kingdo |
code | String | 非必填, 短信验证码,如果退款金额达到一定的数量,后端会返回调用失败,并同时往卖家的手机发送一条短信验证码。接下来用收到的短信验证码再次发起API调用即可完成退款操作。 | |
refund_infos | String | 必填,退款信息,格式: refund_id|amount|version|phase”,其中refund_id为退款编号,amount为退款金额(以分为单位),version为退款最后更新时间(时间戳格式),phase为退款阶段(可选值为:onsale, aftersale,天猫退款必值,淘宝退款不需要传),多个退款以半角逗号分隔。 | 43234234|20000|1409294148714,3123123|12000|1409294148715 |
sysid | String | 代表不同的应用,具体请咨询客服,否则接口会调用失败 | 100 |
sign | String | 接口签名 | 如何计算生成见示例代码 |
2. 请求示例代码(Java)
@Test
public void taoBaoRefundAgree() throws Exception {
String tb_seller_nick = Config.TBSellerNick ;
//业务参数
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("tb_seller_nick", tb_seller_nick);
// 短信验证码,如果退款金额达到一定的数量,后端会返回调用失败,并同时往卖家的手机发送一条短信验证码。接下来用收到的短信验证码再次发起API调用即可完成退款操作。
data.put("code", "840002");
// 退款信息,格式:refund_id|amount|version|phase,其中refund_id为退款编号,amount为退款金额(以分为单位),
// version为退款最后更新时间(时间戳格式),phase为退款阶段(可选值为:onsale, aftersale,天猫退款必值,淘宝退款不需要传),多个退款以半角逗号分隔。
data.put("refund_infos", "110045054952563058|4800|1618830739396");
// data.put("sysid", "103");
// 签名
data.put("sign", Utils.Sign(data,Config.AppSecret));
// 调用服务API
doHttpRequest(Config.TaoBaoRefundAgreeUrl ,data);
}
3. 返回结果如下:
3.1 如果本次退款需要短信验证的话,接口会返回如下内容
{
"code": 0,
"message": "ok",
"data": {
"msg_code": "SEND_CODE_SUCC", // 天猫/淘宝向店铺主账号发送了短信验证码。
"request_id": "5ih9klzt2xux",
"results": {
"refund_mapping_result": [{
"refund_id": "110045054952563058",
"succ": true
}]
},
"succ": true
}
}
3.2 退款成功
{
"code": 0,
"message": "ok",
"data": {
"msg_code": "OP_SUCC",
"request_id": "saccfgswqwp4",
"results": {
"refund_mapping_result": [{
"message": "succ",
"refund_id": "110045054952563058",
"succ": true
}]
},
"succ": true
}
}
说明: code为0表示成功,非0为失败,message会包含失败原因。 其他参数说明如下图
4. 问题
Q: 调用接口报错 isv.invalid-permission:not_sub_user
A: 提示“必须子账号操作”。退款业务规定卖家同意退款,只允许子账号操作,主账号无法操作退款。解决方案:
请先登录卖家中心–子账号管理中心,对主账号下的子账号赋予对应的应用操作权限等;再对该子账号进行用户授权,然后通过蜂巢重新授权,注意此时商家登录时,一定用刚获取权限的子账号登录。
如何主账号给子账号授权,请查看此文档
文档更新时间: 2023-11-15 15:58 作者:admin