---

title: 一卡通v5第三方数据对接接口文档 date: 2016-06-21 13:54:26 tags:

---

1.1文档说明

本文档用于描述了一卡通对第三方应用提供的通用支付api接口文档，供第三方系统（前置和应用）对接参考。

1.2约定

1. 传输编码统一为utf-8
2. RSA 加密算法为本接口采用的非对称加密算法，SIGN_ALGORITHMS ="SHA1WithRSA";
3. RSA公钥由本系统提供，本系统返回信息的签名数据，第三方系统得到后通过公钥校验算法，验证返回数据的合法性
4. HMAC加密算法为用户请求本系统采用的加密算法，SIGN_ALGORITHMS ="HMAC-SHA1";
5. 具体签名生成参考后面的签名章节
6. retcode等于0表示成功，非0表示失败，失败具体信息查看retmsg
7. 密码加密的原始串为timestamp:pwd

2.1 通用卡、账户信息查询-单用户接口

请求URL:

• https://ip:port/epayapi/services/thirdparty/common/single/cardcustinfo

请求方式/格式:

• POST
• application/x-www-form-urlencoded

请求参数:

参数名	类型	必选	说明
partner_id	String	是	本系统分配给各个接入应用的合作伙伴id号
stuempno	String	是	查询对象的学号
timestamp	String	是	时间戳格式为yyyyMMddhh24miss
sign	String	是	签名
sign_method	String	是	参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1

请求内容示例:

URI：https://ip:port/epayapi/services/thirdparty/common/accountquery

partner_id:10000
stuempno:09893092
timestamp:20150119130901
sign:5195f9b9116e4adf67eeebc9935d33dc683f677d
sign_method:HMAC

返回示例:

• 成功

{
	"retcode":"0",
	"retmsg":"查询成功",
	"stuempno":"09893092",
	"username":"王二小",
    "balance":4850,
    "cardno":103920299,
	"status":"正常"
}

• 失败

{
	"retcode":"1",
	"retmsg":"账户不存在"
}

返回参数说明:

参数名	类型	说明
retcode	String	返回码（0=成功，其他为失败）
retmsg	String	返回消息
stuempno	String	学号
username	String	姓名
balance	Integer	余额(分)
cardno	Integer	卡号
status	String	状态(正常)

2.2 通用卡、账户信息查询-批量接口

请求URL:

• https://ip:port/epayapi/services/thirdparty/common/batch/cardcustinfo

请求方式/格式:

• POST
• application/x-www-form-urlencoded

请求参数:

参数名	类型	必选	说明
partner_id	String	是	本系统分配给各个接入应用的合作伙伴id号
cardupdtime	String	否	卡最后更新时间（二选一）
custupdtime	String	否	客户最后更新时间（二选一）
timestamp	String	是	时间戳格式为yyyyMMddhh24miss
sign	String	是	签名
sign_method	String	是	参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1

请求内容示例:

URI：https://ip:port/epayapi/services/thirdparty/common/batch/cardcustinfo

partner_id:10000
cardupdtime:20150829145802
timestamp:20150119130901
sign:5195f9b9116e4adf67eeebc9935d33dc683f677d
sign_method:HMAC

返回示例:

• 成功

{
	"retcode":"0",
	"retmsg":"查询成功",
	"data":[
				{
				"cardno":1001
				}
			]
}

• 失败

{
	"retcode":"1",
	"retmsg":"查询失败"

返回参数说明:

参数名	类型	说明
retcode	String	返回码（0=成功，其他为失败）
retmsg	String	返回消息
stuempno	String	学号
username	String	姓名
balance	Integer	余额(分)
cardno	Integer	卡号
status	String	状态(正常)

2.3 通用账户流水查询

请求URL:

• https://ip:port/epayapi/services/thirdparty/common/getbilldata

请求方式/格式:

• POST
• application/x-www-form-urlencoded

请求参数:

参数名	类型	必选	说明
partner_id	String	是	本系统分配给各个接入应用的合作伙伴id号
stuempno	String	是	查询对象的学号
pageno	String	否	页码，默认1，范围1-100
pagesize	String	否	每页行数,默认100，范围10-500
startdate	String	是	开始时间 格式yyyyMMdd 最多3个月前
enddate	String	是	结束日期 格式yyyyMMdd 最大跨度1个月
timestamp	String	是	时间戳格式为yyyyMMddhh24miss
sign	String	是	签名
sign_method	String	是	参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1

请求内容示例:

URI：https://ip:port/epayapi/services/thirdparty/common/batch/cardcustinfo

partner_id:10000
pageno:2
pagesize:10
startdate:20150829
enddate:20150929
timestamp:20150119130901
sign:5195f9b9116e4adf67eeebc9935d33dc683f677d
sign_method:HMAC

返回示例:

• 成功

{
	"retcode":"0",
	"retmsg":"查询成功",
	"data":[
				{
				"cardno":1001
				}
			]
}

• 失败

{
	"retcode":"1",
	"retmsg":"查询失败"

返回参数说明:

参数名	类型	说明
retcode	String	返回码（0=成功，其他为失败）
retmsg	String	返回消息
stuempno	String	学号
username	String	姓名
balance	Integer	余额(分)
cardno	Integer	卡号
status	String	状态(正常)