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

taobao.refund.status.get (查询退款状态)

根据主订单或者子订单id查询退款状态,入参传入主订单或者子订单号1.如果当传入子订单时,返回子订单最后一笔退款单的状态,如果子订单申请退款退款返回空list.2.如果传传入主订单,则返回主订单下所有子订单的最后一笔退款单状态,如果对应的子订单没有生成退款单,则对应子订单对应数据返回。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
query_param RefundQueryByOrderIdRequest 必须 入参对象
  • └ biz_order_id
  • Number
  • 必须
  • 123123123
  • 订单号

响应参数

名称 类型 示例值 描述
result_package ResultSet {} 出参对象
  • result_list
  • QueryRefundStatusResponse []
  • {[]}
  • 数组对象
  • └ refund_id
  • Number
  • 83477
  • 退款单id
  • └ tid
  • Number
  • 2231884277
  • 淘宝交易单号
  • └ oid
  • Number
  • 2231884277
  • 子订单号
  • └ modified
  • String
  • 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(退款成功)
  • └ error_code
  • String
  • FAILED
  • 错误码,没有表示无异常
  • └ error_msg
  • String
  • 失败
  • 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
RefundStatusGetRequest req = new RefundStatusGetRequest();
RefundStatusGetRequest.RefundQueryByOrderIdRequest obj1 = new RefundStatusGetRequest.RefundQueryByOrderIdRequest();
obj1.setBizOrderId(123123123L);
req.setQueryParam(obj1);
RefundStatusGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<refund_status_get_response>
    <result_package>
        <result_list>
            <query_refund_status_response>
                <refund_id>83477</refund_id>
                <tid>2231884277</tid>
                <oid>2231884277</oid>
                <modified>2000-01-01 00:00:00</modified>
                <status>SUCCESS</status>
            </query_refund_status_response>
        </result_list>
        <error_code>FAILED</error_code>
        <error_msg>失败</error_msg>
    </result_package>
</refund_status_get_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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部