文档中心 > API类目 > 支付宝API

alipay.user.trade.search (查询支付宝账户交易记录)

查询支付宝账户交易记录

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
start_time String 必须 2012-04-23 00:00:00 开始时间,时间必须是今天范围之内。格式为yyyy-MM-dd HH:mm:ss,精确到秒
end_time String 必须 2012-04-25 23:59:59 结束时间。与开始时间间隔在七天之内
alipay_order_no String 可选 2012042328668262 支付宝订单号,为空查询所有记录
merchant_order_no String 可选 13351856429459624 商户订单号,为空查询所有记录
order_type String 可选 TRADE 订单类型,为空查询所有类型订单。
order_status String 可选 TRADE_FINISHED 订单状态,为空查询所有状态订单
order_from String 可选 TAOBAO 订单来源,为空查询所有来源。淘宝(TAOBAO),支付宝(ALIPAY),其它(OTHER)
page_no String 必须 1
  • 默认值:2
  • 页码。取值范围:大于零的整数; 默认值1
    page_size String 必须 100 每页获取条数。最大值500。

    响应参数

    名称 类型 示例值 描述
    total_results String 1000 总记录数
    trade_records TradeRecord [] 交易记录列表
    • └ alipay_order_no
    • String
    • 2012042328668262
    • 支付宝订单号
    • └ merchant_order_no
    • String
    • 13351856429459624
    • 商户订单号
    • └ order_type
    • String
    • TRADE
    • 订单类型
    • └ order_status
    • String
    • TRADE_FINISHED
    • 订单状态
    • └ owner_user_id
    • String
    • 2088102010469625
    • 本方支付宝账号
    • └ owner_logon_id
    • String
    • cgp*@alitest.com
    • 本方支付宝登录号,需要隐藏
    • └ owner_name
    • String
    • *本三
    • 本方姓名,需要隐藏
    • └ opposite_user_id
    • String
    • 2088102010463830
    • 对方支付宝账号
    • └ opposite_name
    • String
    • *德一
    • 对方姓名,需要隐藏
    • └ opposite_logon_id
    • String
    • cc*@163.com
    • 对方支付宝登录号,需要隐藏
    • └ order_title
    • String
    • 购买手机
    • 订单的名称,描述订单的摘要信息,如交易的商品名称
    • └ total_amount
    • Price
    • 100
    • 订单总金额
    • └ service_charge
    • Price
    • 2
    • 订单服务费
    • └ order_from
    • String
    • taobao
    • 订单来源,为空查询所有来源。淘宝(taobao),支付宝(alipay),其它(other)
    • └ create_time
    • Date
    • 2012-04-23 20:54:02
    • 订单创建时间
    • └ modified_time
    • Date
    • 2012-04-23 20:54:07
    • 订单最后修改时间
    • └ in_out_type
    • String
    • in
    • 资金流入流程类型,in表示收入,out表示支出
    total_pages String 10 总页数

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlipayUserTradeSearchRequest req = new AlipayUserTradeSearchRequest();
    req.setStartTime("2012-04-23 00:00:00");
    req.setEndTime("2012-04-25 23:59:59");
    req.setAlipayOrderNo("2012042328668262");
    req.setMerchantOrderNo("13351856429459624");
    req.setOrderType("TRADE");
    req.setOrderStatus("TRADE_FINISHED");
    req.setOrderFrom("TAOBAO");
    req.setPageNo("1");
    req.setPageSize("100");
    AlipayUserTradeSearchResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alipay_user_trade_search_response>
        <total_results>1000</total_results>
        <trade_records>
            <trade_record>
            </trade_record>
        </trade_records>
        <total_pages>10</total_pages>
    </alipay_user_trade_search_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.order-from-is-invalid 订单来源不正确 订单来源,为空查询所有来源。淘宝(TAOBAO),支付宝(ALIPAY),其它(OTHER)
    isv.order-state-and-type-not-march 业务类型和订单状态不匹配 业务类型和订单状态不匹配
    isv.order-state-is-invalid 订单状态不正确 订单状态不正确
    isv.order-type-is-invalid 业务类型不正确 业务类型不正确
    isv.over-max-time-range 最大时间跨度不能超过7天 减小时间跨度
    isv.over-max-page-size 每页记录数最多500条 调整每页记录数
    isv.query-result-count-out-limit 查询总数超限,请调整查询条件 查询总数超限,请调整查询条件

    API工具

    如何获得此API

    FAQ

    返回
    顶部