跳转到内容
返回官网

拒绝退款

卖家拒绝单笔退款(包含退款和退款退货)交易,要求如下:

  1. 传入的refund_id和相应的tid, oid必须匹配

  2. 如果一笔订单只有一笔子订单,则tid必须与oid相同

  3. 只有卖家才能执行拒绝退款操作

  4. 以下三种情况不能退款:卖家未发货;7天无理由退换货;网游订单

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/taobao/refund/refuse

参数名类型说明示例
appidString合作伙伴AppIduwkahf@jfs92
timestampString当前时间戳
tb_seller_nickString淘宝卖家店铺登录账号,非店铺名称kingdo
refund_idNumber必填,退款单号123456
refuse_messageString必填, 拒绝退款时的说明信息,长度2-200kingdo
refuse_proofString非必填, base64编码的图片
refund_phaseString非必填,可选值为:售中:onsale,售后:aftersale,但天猫退款为必填项。
refund_versionString非必填, 退款版本号,但天猫退款为必填项。
refuse_reason_idString非必填,拒绝原因编号,会提供用户拒绝原因列表供选择
sysidString代表不同的应用,具体请咨询客服,否则接口会调用失败100
signString接口签名如何计算生成见示例代码

二、请求示例代码

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、检查下退款的阶段是否正确