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

tmall.dispute.receive.get (天猫逆向纠纷查询)

展示商家所有退款信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
status String 可选 WAIT_SELLER_AGREE 退款状态,默认查询所有退款状态的数据,除了默认值外每次只能查询一种状态。WAIT_SELLER_AGREE(买家已经申请退款,等待卖家同意);WAIT_BUYER_RETURN_GOODS(卖家已经同意退款,等待买家退货);WAIT_SELLER_CONFIRM_GOODS(买家已经退货,等待卖家确认收货);CLOSED(退款关闭); SUCCESS(退款成功);SELLER_REFUSE_BUYER(卖家拒绝退款);WAIT_BUYER_CONFIRM_REDO_SEND_GOODS(等待买家确认重新邮寄的货物);WAIT_SELLER_CONFIRM_RETURN_ADDRESS(等待卖家确认退货地址);WAIT_SELLER_CONSIGN_GOOGDS(卖家确认收货,等待卖家发货);EXCHANGE_TRANSFORM_TO_REFUND(换货关闭,转退货退款);EXCHANGE_WAIT_BUYER_CONFIRM_GOODS(卖家已发货,等待买家确认收货);POST_FEE_DISPUTE_WAIT_ACTIVATE(邮费单已创建,待激活)
page_size Number 可选 20
  • 默认值:20
  • 每页条数。取值范围:大于零的整数; 默认值:20;最大值:100
    use_has_next Boolean 可选 true 是否启用has_next的分页方式,如果指定true,则返回的结果中不包含总记录数,但是会新增一个是否存在下一页的的字段,通过此种方式获取增量退款,接口调用成功率在原有的基础上有所提升。
    type String 可选 fixed
  • 默认值:fixed
  • 交易类型列表,一次查询多种类型可用半角逗号分隔,默认同时查询guarantee_trade, auto_delivery这两种类型的数据,查看可选值
    refund_id Number 可选 10000000000 逆向纠纷单号id
    page_no Number 可选 1
  • 默认值:1
  • 页码。取值范围:大于零的整数; 默认值:1
    buyer_nick String 可选 卡卡 买家昵称
    start_modified Date 可选 2000-01-01 00:00:00 查询修改时间开始。格式: yyyy-MM-dd HH:mm:ss
    end_modified Date 可选 2000-01-01 00:00:00 查询修改时间结束。格式: yyyy-MM-dd HH:mm:ss
    fields String [] 必须 refund_id, alipay_no, tid, buyer_nick, seller_nick, status, created, modified, order_status, refund_fee, good_status, show_return_logistic, show_exchange_logistic, time_out, oid, refund_version, title, num, dispute_request, reason, desc
  • 最大列表长度:100
  • 需要返回的字段。目前支持有:refund_id, alipay_no, tid, buyer_nick, seller_nick, status, created, modified, order_status, refund_fee, good_status, show_return_logistic(展现买家退货的物流信息), show_exchange_logistic(展现换货的物流信息), time_out, oid, refund_version, title, num, dispute_request, reason, desc
    buyer_open_uid String 可选 AXSDSDSDsdadSDDD 买家openId

    响应参数

    名称 类型 示例值 描述
    result ResultSet result
    • └ page_results
    • Number
    • 10
    • 当前页面的纠纷单数量
    • └ total_results
    • Number
    • 100
    • 所有符合查询条件的纠纷单数量
    • └ has_next
    • Boolean
    • true
    • 是否还有下一页
    • └ error_code
    • String
    • ERROR
    • 错误码
    • └ error_msg
    • String
    • NULL
    • 错误信息
    • results
    • Dispute []
    • results
    • └ address
    • String
    • 北京市海淀区西土城路十号
    • 卖家收货地址
    • └ alipay_no
    • String
    • 222222222
    • 支付宝单号
    • └ attribute
    • String
    • {}
    • 纠纷单上的各项属性
    • └ biz_order_id
    • String
    • 111111111111
    • 正向交易单号
    • └ buyer_address
    • String
    • 浙江省杭州市余杭区瓶窑镇
    • 买家收货地址(换货)
    • └ buyer_logistic_name
    • String
    • 顺丰快递
    • 买家发货物流公司(换货)
    • └ buyer_logistic_no
    • String
    • 234567432
    • 买家发货物流单号(换货)
    • └ buyer_name
    • String
    • 卡卡
    • 买家收货人姓名(换货)
    • └ buyer_phone
    • String
    • 13344445555
    • 买家联系方式(换货)
    • └ company_name
    • String
    • 顺丰快递
    • 卖家发货物流单号
    • └ created
    • Date
    • 2000-01-01 00:00:00
    • 纠纷单创建时间
    • └ desc
    • String
    • 纠纷说明
    • └ dispute_request
    • String
    • 换货
    • 纠纷类型,常见的有:仅退款、退货退款、换货
    • └ good_return_time
    • Date
    • 2000-01-01 00:00:00
    • 买家退货时间
    • └ good_status
    • String
    • 货物状态。可选值BUYER_NOT_RECEIVED (买家未收到货) BUYER_RECEIVED (买家已收到货) BUYER_RETURNED_GOODS (买家已退货)
    • 货物状态
    • └ has_good_return
    • Boolean
    • true
    • 买家是否需要退货。可选值:true(是),false(否)
    • └ modified
    • Date
    • 2000-01-01 00:00:00
    • 纠纷单修改时间
    • └ num
    • Number
    • 1
    • 买家购买数量
    • └ oid
    • Number
    • 222221331232132
    • 子订单号。如果是单笔交易oid会等于tid
    • └ order_status
    • String
    • BUYER_RECEIVED
    • 退款对应的订单交易状态。可选值TRADE_NO_CREATE_PAY(没有创建支付宝交易) WAIT_BUYER_PAY(等待买家付款) WAIT_SELLER_SEND_GOODS(等待卖家发货,即:买家已付款) WAIT_BUYER_CONFIRM_GOODS(等待买家确认收货,即:卖家已发货) TRADE_BUYER_SIGNED(买家已签收,货到付款专用) TRADE_FINISHED(交易成功) TRADE_CLOSED(交易关闭) TRADE_CLOSED_BY_TAOBAO(交易被淘宝关闭) ALL_WAIT_PAY(包含:WAIT_BUYER_PAY、TRADE_NO_CREATE_PAY) ALL_CLOSED(包含:TRADE_CLOSED、TRADE_CLOSED_BY_TAOBAO) 取自"http://open.taobao.com/dev/index.php/%E4%BA%A4%E6%98%93%E7%8A%B6%E6%80%81"
    • └ reason
    • String
    • 退款原因
    • └ refund_fee
    • String
    • 10.00
    • 退还金额(退还给买家的金额)。精确到2位小数;单位:元。如:200.07,表示:200元7分
    • └ refund_id
    • String
    • 243434312123
    • 纠纷单号id
    • └ refund_phase
    • String
    • onsale
    • 退款阶段,可选值:onsale/aftersale
    • └ seller_logistic_name
    • String
    • 顺丰快递
    • 卖家发货物流公司(换货)
    • └ seller_logistic_no
    • String
    • 2332312312123
    • 卖家发货物流单号(换货)
    • └ status
    • String
    • 退款成功
    • 逆向纠纷状态。其中,仅退款/退货退款的状态为:(1, "买家已经申请退款,等待卖家同意"),(2, "卖家已经同意退款,等待买家退货"),(3, "买家已经退货,等待卖家确认收货"),(4, "退款关闭"),(5, "退款成功"),(6, "卖家拒绝退款”),(7, "等待买家确认重新邮寄的货物"),(8, "等待卖家确认退货地址");换货的状态为:(1, "换货待处理"),(2, "待买家退货"),(3, "买家已退货,待收货"),(4, "换货关闭"),(5, "换货成功"),(6, "待买家修改"),(12, "待发出换货商品"),(13, "待买家收货"),(14, "请退款")
    • └ time_out
    • String
    • 2000-01-01 00:00:00
    • 超时时间
    • └ title
    • String
    • 米兰米兰
    • 商品名称
    • └ buyer_open_uid
    • String
    • ASDXSDSDSDSDS
    • 买家openId
    • └ buyer_nick
    • String
    • 卡卡
    • 买家昵称
    • └ real_receiver_open_id
    • String
    • AAEnVKOdAOIduo9TH9hjf-zb
    • 收件人淘宝加密openId
    • └ real_receiver_display_nick
    • String
    • 这是一个昵称
    • 收件人淘宝加密昵称

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallDisputeReceiveGetRequest req = new TmallDisputeReceiveGetRequest();
    req.setStatus("WAIT_SELLER_AGREE");
    req.setPageSize(20L);
    req.setUseHasNext(true);
    req.setType("fixed");
    req.setRefundId(10000000000L);
    req.setPageNo(1L);
    req.setBuyerNick("卡卡");
    req.setStartModified(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setEndModified(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setFields("refund_id, alipay_no, tid, buyer_nick, seller_nick, status, created, modified, order_status, refund_fee, good_status, show_return_logistic, show_exchange_logistic, time_out, oid, refund_version, title, num, dispute_request, reason, desc");
    req.setBuyerOpenUid("AXSDSDSDsdadSDDD");
    TmallDisputeReceiveGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmall_dispute_receive_get_response>
        <result>
            <page_results>10</page_results>
            <total_results>100</total_results>
            <has_next>true</has_next>
            <error_code>ERROR</error_code>
            <error_msg>NULL</error_msg>
            <results>
                <dispute>
                    <address>北京市海淀区西土城路十号</address>
                    <alipay_no>222222222</alipay_no>
                    <attribute>{}</attribute>
                    <biz_order_id>111111111111</biz_order_id>
                    <buyer_address>浙江省杭州市余杭区瓶窑镇</buyer_address>
                    <buyer_logistic_name>顺丰快递</buyer_logistic_name>
                    <buyer_logistic_no>234567432</buyer_logistic_no>
                    <buyer_name>卡卡</buyer_name>
                    <buyer_phone>13344445555</buyer_phone>
                    <company_name>顺丰快递</company_name>
                    <created>2000-01-01 00:00:00</created>
                    <desc>穷</desc>
                    <dispute_request>换货</dispute_request>
                    <good_return_time>2000-01-01 00:00:00</good_return_time>
                    <good_status>货物状态。可选值BUYER_NOT_RECEIVED (买家未收到货) BUYER_RECEIVED (买家已收到货) BUYER_RETURNED_GOODS (买家已退货)</good_status>
                    <has_good_return>true</has_good_return>
                    <modified>2000-01-01 00:00:00</modified>
                    <num>1</num>
                    <oid>222221331232132</oid>
                    <order_status>BUYER_RECEIVED</order_status>
                    <reason>穷</reason>
                    <refund_fee>10.00</refund_fee>
                    <refund_id>243434312123</refund_id>
                    <refund_phase>onsale</refund_phase>
                    <seller_logistic_name>顺丰快递</seller_logistic_name>
                    <seller_logistic_no>2332312312123</seller_logistic_no>
                    <status>退款成功</status>
                    <time_out>2000-01-01 00:00:00</time_out>
                    <title>米兰米兰</title>
                    <buyer_open_uid>ASDXSDSDSDSDS</buyer_open_uid>
                    <buyer_nick>卡卡</buyer_nick>
                    <real_receiver_open_id>AAEnVKOdAOIduo9TH9hjf-zb</real_receiver_open_id>
                    <real_receiver_display_nick>这是一个昵称</real_receiver_display_nick>
                </dispute>
            </results>
        </result>
    </tmall_dispute_receive_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

    返回
    顶部