alipay.user.trade.search
查询支付宝账户交易记录
查询支付宝账户交易记录
1.每页记录数最多500条。
2.单次查询最大返回记录数为5000条。
3.一次查询条件时间跨度最大为7天。
4.只提供一年内的数据查询。
应用场景
查询支付宝账户交易记录
API用户授权类型
需要登录授权
系统级输入参数
| 名称 |
类型 |
是否必须 |
示例值 |
默认值 |
描述 |
| method |
String |
是 |
|
|
API接口名称 |
| auth_token |
String |
否 |
|
|
用户的授权，需要用户授权的接口不能为空 |
| timestamp |
String |
是 |
|
|
时间戳，格式为yyyy-MM-dd HH:mm:ss |
| format |
String |
否 |
xml |
json |
响应格式。默认json,目前支持格式为xml,json |
| platform |
String |
否 |
top |
|
创建应用的平台来源 |
| app_id |
String |
是 |
|
|
AOP分配给应用的唯一标识 |
| version |
String |
是 |
1.0 |
|
API协议版本，默认值：1.0 |
| sign |
String |
是 |
|
|
API请求的签名 |
| sign_type |
String |
是 |
RSA |
|
目前仅支持RSA |
| terminal_type |
String |
否 |
mobile |
web |
终端类型：web：PC方式;wap：手机WAP; mobile：手机客户端应用方式 |
| terminal_info |
String |
否 |
|
|
终端详情 |
| return_url |
String |
否 |
|
|
API执行完，页面跳转到的地址 |
应用级输入参数
| 名称 |
类型 |
是否列表类型 |
是否必须 |
示例值 |
默认值 |
描述 |
| start_time |
String
|
否 |
必须 |
2012-04-23 00:00:00 |
|
开始时间，时间必须是今天范围之内。格式为yyyy-MM-dd HH:mm:ss，精确到秒(升级后的api 1.1版本) |
| 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 |
总记录数 |
r1 |
| trade_records |
TradeRecord
|
是 |
必须 |
|
交易记录列表 |
|
| total_pages |
String
|
否 |
必须 |
10 |
总页数 |
r1 |
什么是属性安全等级
返回示例
XML数据格式:
-
- <alipay_user_trade_search_response>
- <total_results>1000</total_results>
- <trade_records list="true">
- <trade_record>
- <alipay_order_no>2012042328668262</alipay_order_no>
- <merchant_order_no>13351856429459624</merchant_order_no>
- <order_type>TRADE</order_type>
- <order_status>TRADE_FINISHED</order_status>
- <owner_user_id>2088102010469625</owner_user_id>
- <owner_logon_id>cgp*@alitest.com</owner_logon_id>
- <owner_name>*本三</owner_name>
- <opposite_user_id>2088102010463830</opposite_user_id>
- <opposite_name>*德一</opposite_name>
- <opposite_logon_id>cc*@163.com</opposite_logon_id>
- <order_title>购买手机</order_title>
- <total_amount>100</total_amount>
- <service_charge>2</service_charge>
- <order_from>taobao</order_from>
- <create_time>2012-04-23 20:54:02</create_time>
- <modified_time>2012-04-23 20:54:07</modified_time>
- <in_out_type>in</in_out_type>
- </trade_record>
- </trade_records>
- <total_pages>10</total_pages>
- </alipay_user_trade_search_response>
-
JSON数据格式::
-
- {
- "alipay_user_trade_search_response":{
- "total_results":"1000",
- "trade_records":{
- "trade_record":[{
- "alipay_order_no":"2012042328668262",
- "merchant_order_no":"13351856429459624",
- "order_type":"TRADE",
- "order_status":"TRADE_FINISHED",
- "owner_user_id":"2088102010469625",
- "owner_logon_id":"cgp*@alitest.com",
- "owner_name":"*本三",
- "opposite_user_id":"2088102010463830",
- "opposite_name":"*德一",
- "opposite_logon_id":"cc*@163.com",
- "order_title":"购买手机",
- "total_amount":100,
- "service_charge":2,
- "order_from":"taobao",
- "create_time":"2012-04-23 20:54:02",
- "modified_time":"2012-04-23 20:54:07",
- "in_out_type":"in"
- }]
- },
- "total_pages":"10"
- }
- }
-
错误码
| 名称 |
描述 |
解决方案 |
| 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 |
查询总数超限,请调整查询条件 |
查询总数超限,请调整查询条件 |
| isv.over-high-time-range |
最大时间跨度不能超过30天（级别高的应用） |
减小时间跨度 |
API工具
在线测试工具
