卖家同意退款

卖家同意退款,支持批量退款,只允许子账号操作。淘宝退款一次最多能退20笔,总金额不超过6000元;天猫退款一次最多能退30笔,总金额不超过10000元。

1.请求参数:

请求URL:

POST https://open.fw199.com/gateway/taobao/refund/agree

参数名 类型 说明 示例
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