mybank.finance.yulibao.trans.history.query (余利宝历史交易查询)

余利宝历史交易查询

公共参数

请求地址:
环境 HTTPS请求地址
正式环境 https://openapi.alipay.com/gateway.do
公共请求参数:
参数 类型 是否必填 最大长度 描述 示例值
app_id String 32 支付宝分配给开发者的应用ID 2014072300007148
method String 128 接口名称 mybank.finance.yulibao.trans.history.query
format String 40 仅支持JSON JSON
charset String 10 请求使用的编码格式,如utf-8,gbk,gb2312等 utf-8
sign_type String 10 商户生成签名字符串所使用的签名算法类型,目前支持RSA2和RSA,推荐使用RSA2 RSA2
sign String 256 商户请求参数的签名串,详见签名 详见示例
timestamp String 19 发送请求的时间,格式"yyyy-MM-dd HH:mm:ss" 2014-07-24 03:07:50
version String 3 调用的接口版本,固定为:1.0 1.0
app_auth_token String 40 详见应用授权概述
biz_content String - 请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

请求参数

参数 类型 是否必填 最大长度 描述 示例值
fund_code String 必须 30 基金代码,必填。目前默认填001529,代表余利宝。 001529
start_date String 必须 8 查询交易的开始时间,必须是格式为yyyyMMdd的日期字符串,如20160808。 20160808
end_date String 必须 8 查询交易的结束时间,必须是格式为yyyyMMdd的日期字符串,且日期要大于等于start_date,时间最大跨度为30天,如start_date为20160808,则end_date最大值为20160906。 20160818
page Number 必须 2 页码,历史交易记录分页展示的页码。必须为正整数,最大值为99。 1
page_size Number 必须 5 每页条数,历史交易记录查询时每页的最大条数。必须为正整数,最大值为50。 20

公共响应参数

参数 类型 是否必填 最大长度 描述 示例值
code String - 网关返回码,详见文档 40004
msg String - 网关返回码描述,详见文档 Business Failed
sub_code String - 业务返回码,详见文档 ACQ.TRADE_HAS_SUCCESS
sub_msg String - 业务返回码描述,详见文档 交易已被支付
sign String - 签名,详见文档 DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo=

响应参数

参数 类型 是否必填 最大长度 描述 示例值
history_trans_detail_infos YLBTransDetailInfo [] 必填 - 历史交易详情信息
  • └ amount
  • String
  • 必填
  • 20
  • 余利宝交易金额,单位为元
  • 12.34
  • └ trans_date
  • Date
  • 必填
  • 30
  • 交易时间
  • 2016-08-30 04:42:22
  • └ trans_account_date
  • Date
  • 必填
  • 30
  • 交易到账时间
  • 2016-08-30 04:45:19
  • └ biz_no
  • String
  • 必填
  • 50
  • 交易流水号
  • 2016090910121100020000000000200000075364
  • └ trans_name
  • String
  • 必填
  • 50
  • 交易名称,如正常申购、正常赎回、收益发放、份额强增、份额强减
  • 正常申购
  • └ trans_type
  • String
  • 必填
  • 50
  • 交易类型,如正常申购、正常赎回、收益发放、份额强增、份额强减
  • 正常申购
  • └ trans_status
  • String
  • 必填
  • 50
  • 交易状态,如success-成功、failure-失败、inprocess-进行中等
  • success
  • └ memo
  • String
  • 必填
  • 50
  • 备注信息
  • (理财基金)基金申购
current_page Number 必填 2 历史交易记录查询的当前页码 1
has_next_page Boolean 必填 5 当前查询是否具有下一页的数据,true-有,fasle-没有 false
total_item_count String 必填 50 当前查询在不分页情况下的数据总数 28

请求示例

  • JAVA
  • .NET
  • PHP
  • HTTP请求源码
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
MybankFinanceYulibaoTransHistoryQueryRequest request = new MybankFinanceYulibaoTransHistoryQueryRequest();
request.setBizContent("{" +
"\"fund_code\":\"001529\"," +
"\"start_date\":\"20160808\"," +
"\"end_date\":\"20160818\"," +
"\"page\":1," +
"\"page_size\":20" +
"  }");
MybankFinanceYulibaoTransHistoryQueryResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

响应示例

  • JSON示例
{
	"mybank_finance_yulibao_trans_history_query_response":{
		"msg":"Success",
		"code":"10000",
		"history_trans_detail_infos":[
			{
				"amount":"12.34",
				"trans_date":"2016-08-30 04:42:22",
				"trans_account_date":"2016-08-30 04:45:19",
				"biz_no":"2016090910121100020000000000200000075364",
				"trans_name":"正常申购",
				"memo":"(理财基金)基金申购",
				"trans_status":"success",
				"trans_type":"正常申购"
			}
		],
		"has_next_page":false,
		"total_item_count":"28",
		"current_page":1
	},
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

异常示例

  • JSON示例
{
	"mybank_finance_yulibao_trans_history_query_response":{
		"msg":"Service Currently Unavailable",
		"code":"20000",
		"sub_msg":"系统繁忙",
		"sub_code":"isp.unknow-error"
	},
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

业务错误码

错误码 错误描述 解决方案
INVALID_PARAMETER 输入日期不正确,可能是不符合格式要求、开始和结束日期倒挂、或日期跨度超过30天 输入正确格式的日期,格式如20160808,且开始日期要小于等于结束日期,日期跨度不超过30天
SYSTEM_ERROR 系统繁忙 稍后重试
SYSTEM_ERROR 系统繁忙 稍后重试
INVALID_PARAMETER 参数有误。输入的分页参数有误 page和page_size必须为正整数,且page最大值为99,page_size最大值为50
INVALID_PARAMETER 参数有误。输入的基金代码不正确 输入正确的基金代码

公共错误码

返回
顶部