同意退款

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

一、请求参数

请求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	接口签名	如何计算生成见示例代码

二、请求示例代码

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);

    }

三、返回结果

三（一）、如果本次退款需要短信验证的话，接口会返回如下内容

{
    "code": 0,
    "message": "ok",
    "data": {
        "msg_code": "SEND_CODE_SUCC",   // 天猫/淘宝向店铺主账号发送了短信验证码。
        "request_id": "5ih9klzt2xux",
        "results": {
            "refund_mapping_result": [{
                "refund_id": "110045054952563058",
                "succ": true
            }]
        },
        "succ": true
    }
}

三（二）、退款成功

{
    "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会包含失败原因。 其他参数说明如下图

四、问题

Q: 调用接口报错 isv.invalid-permission:not_sub_user A: 提示“必须子账号操作”。退款业务规定卖家同意退款，只允许子账号操作，主账号无法操作退款。解决方案： 请先登录卖家中心–子账号管理中心，对主账号下的子账号赋予对应的应用操作权限等；再对该子账号进行用户授权，然后通过蜂巢重新授权，注意此时商家登录时，一定用刚获取权限的子账号登录。 如何主账号给子账号授权，请查看此文档