拒绝退款
卖家拒绝单笔退款(包含退款和退款退货)交易,要求如下:
-
传入的refund_id和相应的tid, oid必须匹配
-
如果一笔订单只有一笔子订单,则tid必须与oid相同
-
只有卖家才能执行拒绝退款操作
-
以下三种情况不能退款:卖家未发货;7天无理由退换货;网游订单
一、请求参数
请求URL:
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
| appid | String | 合作伙伴AppId | uwkahf@jfs92 |
| timestamp | String | 当前时间戳 | |
| tb_seller_nick | String | 淘宝卖家店铺登录账号,非店铺名称 | kingdo |
| refund_id | Number | 必填,退款单号 | 123456 |
| refuse_message | String | 必填, 拒绝退款时的说明信息,长度2-200 | kingdo |
| refuse_proof | String | 非必填, base64编码的图片 | |
| refund_phase | String | 非必填,可选值为:售中:onsale,售后:aftersale,但天猫退款为必填项。 | |
| refund_version | String | 非必填, 退款版本号,但天猫退款为必填项。 | |
| refuse_reason_id | String | 非必填,拒绝原因编号,会提供用户拒绝原因列表供选择 | |
| sysid | String | 代表不同的应用,具体请咨询客服,否则接口会调用失败 | 100 |
| sign | String | 接口签名 | 如何计算生成见示例代码 |
二、请求示例代码
Java
@Test public void taoBaoRefundRefuse() 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); data.put("refund_id", "110056431137563058"); data.put("refuse_message", "这个是绝好的东西,一定要尝试");
// 拒绝退款时的退款凭证,一般是卖家拒绝退款时使用的发货凭证,最大长度130000字节,支持的图片格式:GIF, JPG, PNG。 天猫退款为必填项。 // String base64ImageLogo = Utils.getBase64ImageFromBinary("/Users/miller/MyDocument/aaa.jpg"); // data.put("refuse_proof", base64ImageLogo); // data.put("sysid", "103"); // 签名 data.put("sign", Utils.Sign(data,Config.AppSecret)); // 调用服务API doHttpRequest(Config.TaoBaoRefundRefuseUrl ,data); }三、返回结果
{ "code": 0, "message": "ok", "data": { "is_success": true, // 拒绝退款操作是否成功 "refund": { "modified": "2021-04-19 23:42:09", // 更新时间。格式:yyyy-MM-dd HH:mm:ss "refund_id": "110056431137563058", // 退款单号 "status": "SELLER_REFUSE_BUYER" // 退款状态。可选值WAIT_SELLER_AGREE(买家已经申请退款,等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款,等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货,等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功)
}, "request_id": "55o5l56d3jfp" }}说明: code为0表示成功,非0为失败,message会包含失败原因。 其他参数说明如下图
四、问题
Q:调用拒绝退款出现以下异常 Invalid arguments:refuse_proof。 A: 请检查如下: 1、入参 refuse_proof 的文件类型不合法,退款凭证 refuse_proof 参数支持的文件类型只有 gif,jpg,png 这几种。 2、refuse_proof 的长度不能大于130000字节
Q: rp2退款服务不可用 1、调退款接口报服务不可用的提示,通常情况下稍等重试即可。 2、如果使用主账号调接口会报该错误,top接口不支持主账户操作同意退款,是子账号操作。 3、检查下退款的阶段是否正确