文档中心 > API类目 > 淘宝退款API

taobao.refund.refuse (卖家拒绝退款)

卖家拒绝单笔退款(包含退款和退款退货)交易,要求如下: 1. 传入的refund_id和相应的tid, oid必须匹配 2. 如果一笔订单只有一笔子订单,则tid必须与oid相同 3. 只有卖家才能执行拒绝退款操作 4. 以下三种情况不能退款:卖家未发货;7天无理由退换货;网游订单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
refund_id Number 必须 123456 退款单号
refuse_message String 必须 拒绝退款说明
  • 最大长度:200
  • 拒绝退款时的说明信息,长度2-200
    refuse_proof byte[] 可选 我是被上传的文件内容 拒绝退款时的退款凭证,一般是卖家拒绝退款时使用的发货凭证,最大长度130000字节,支持的图片格式:GIF, JPG, PNG。天猫退款为必填项。
    支持的文件类型:gif,jpg,png
    refund_phase String 可选 onsale 可选值为:售中:onsale,售后:aftersale,天猫退款为必填项。
    refund_version Number 可选 1409278100627 退款版本号,天猫退款为必填项。
    refuse_reason_id Number 可选 999 拒绝原因编号,会提供用户拒绝原因列表供选择

    响应参数

    名称 类型 示例值 描述
    refund Refund 拒绝退款成功后,会返回Refund数据结构中的refund_id, status, modified字段
    • └ refund_id
    • String
    • 83477
    • 退款单号
    • └ modified
    • Date
    • 2000-01-01 00:00:00
    • 更新时间。格式:yyyy-MM-dd HH:mm:ss
    • └ status
    • String
    • SUCCESS
    • 退款状态。可选值WAIT_SELLER_AGREE(买家已经申请退款,等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款,等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货,等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功)
    is_success Boolean true 拒绝退款操作是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    RefundRefuseRequest req = new RefundRefuseRequest();
    req.setRefundId(123456L);
    req.setRefuseMessage("拒绝退款说明");
    req.setTid(123456L);
    req.setOid(123456L);
    req.setRefuseProof(new FileItem("/tmp/file.txt"));
    req.setRefundPhase("onsale");
    req.setRefundVersion(1409278100627L);
    req.setRefuseReasonId(999L);
    RefundRefuseResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <refund_refuse_response>
        <refund>
        </refund>
        <is_success>true</is_success>
    </refund_refuse_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案
    isv.parameters-mismatch refund_id与传入的tid或oid不一致 请确认传入的tid与oid是refund_id对应的退款记录所对应的交易的tid与oid
    isv.invalid-parameter:refuse_message 入参中的refuse_message不合法, refuse_message的长度范围为:2-200非空字符 核对入参的refuse_message是否满足要求
    isv.invalid-parameter:refuse_proof 入参中的refuse_proof不合法, refuse_proof的长度不能大于130000字节 核对入参中的refuse_proof是否满足要求
    isv.invalid-permission 不合适的权限 必须是此退款的卖家才能执行拒绝退款操作 请确认当前用户是否为该笔退款记录的卖家
    isv.invalid-permission:refund_status is invalid or refund is out of date 拒绝退款操作已过有效操作期,退款记录的状态当前不能执行拒绝退款操作 确认退款记录是否处于可执行拒绝退款的状态
    isv.invalid-permission:order.status cann't be 'WAIT_SELLER_SEND_GOODS' 卖家未发货,不能拒绝退款 未发货状态,卖家不能拒绝退款
    isv.invalid-permissiion:refund cann't be refused 买家需要退货或7天无理由退换货的订单不能拒绝退款 买家需要退货或7天无理由退换货的订单不能拒绝退款
    isv.invalid-parameter 非法参数 网游订单不能拒绝退款
    isv.trade-is-tmall-order 不支持拒绝天猫退款单 天猫退款退货业务请申请http://open.taobao.com/api/api_cat_detail.htm?spm=0.0.0.0.5dANAJ&cat_id=20418&category_id=102
    isv.invalid-permission:order.status cannt be WAIT_SELLER_SEND_GOODS 卖家未发货,不能拒绝退款 卖家未发货,不能拒绝退款
    isv.refund-refunse-failed 拒绝退款操作失败 判断退款单状态是否允许拒绝退款,如退款单已经关闭等不允许操作
    isp.refund-service-unavailable 拒绝退货服务不可用 适当重试
    isv.invalid-picture-file
    isv.trade-not-exist
    isv.refund-query-limit

    API工具

    如何获得此API

    FAQ

    返回
    顶部