约定

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

商户解款查询

请求URL:

• http(s)://ip:port/epayapi/services/settlement/queryshopsettlement

请求方式/格式:

• post
• content-type: application/x-www-form-urlencoded

请求参数

参数名	类型	必传	备注
partner_id	String	是	本系统分配给各个接入应用的合作伙伴id号
merchno	String	是	商户号
enddate	String	是	截止日期，yyyyMMdd
timestamp	String	是	时间戳 yyyyMMddHHmmss
sign_method	String	是	HMAC
sign	String	是	签名

返回参数

参数名	类型	必传	备注
retcode	String	是	0-成功；其他失败
retmsg	String	是	错误信息
merchno	String	否	商户号
amount	double	否	解款金额
begindate	String	否	起始日期, yyyyMMdd
enddate	String	否	截止日期，yyyyMMdd

商户解款

请求URL:

• http(s)://ip:port/epayapi/services/settlement/shopsettlement

请求方式/格式:

• post
• content-type: application/x-www-form-urlencoded

请求参数

参数名	类型	必传	备注
partner_id	String	是	本系统分配给各个接入应用的合作伙伴id号
merchno	String	是	商户号
amount	String	是	解款金额，整数。单位：分
enddate	String	是	截止日期，yyyyMMdd
timestamp	String	是	时间戳 yyyyMMddHHmmss
sign_method	String	是	HMAC
sign	String	是	签名

返回参数

参数名	类型	必传	备注
retcode	String	是	0-成功；其他失败
retmsg	String	是	错误信息
merchno	String	否	商户号
amount	double	否	解款金额
begindate	String	否	起始日期, yyyyMMdd
enddate	String	否	截止日期，yyyyMMdd

操作员解款查询

请求URL:

• http(s)://ip:port/epayapi/services/settlement/queryopersettlement

请求方式/格式:

• post
• content-type: application/x-www-form-urlencoded

请求参数

参数名	类型	必传	备注
partner_id	String	是	本系统分配给各个接入应用的合作伙伴id号
branchno	String	是	网点号
enddate	String	是	截止日期，yyyyMMdd
timestamp	String	是	时间戳 yyyyMMddHHmmss
sign_method	String	是	HMAC
sign	String	是	签名

返回参数

参数名	类型	必传	备注
retcode	String	是	0-成功；其他失败
retmsg	String	是	错误信息
branchno	String	否	网点号
amount	double	否	解款金额
begindate	String	否	起始日期, yyyyMMdd
enddate	String	否	截止日期，yyyyMMdd

操作员解款查询

请求URL:

• http(s)://ip:port/epayapi/services/settlement/opersettlement

请求方式/格式:

• post
• content-type: application/x-www-form-urlencoded

请求参数

参数名	类型	必传	备注
partner_id	String	是	本系统分配给各个接入应用的合作伙伴id号
branchno	String	是	网点号
amount	String	是	解款金额，整数。单位：分
enddate	String	是	截止日期，yyyyMMdd
timestamp	String	是	时间戳 yyyyMMddHHmmss
sign_method	String	是	HMAC
sign	String	是	签名

返回参数

参数名	类型	必传	备注
retcode	String	是	0-成功；其他失败
retmsg	String	是	错误信息
branchno	String	否	网点号
amount	double	否	解款金额
begindate	String	否	起始日期, yyyyMMdd
enddate	String	否	截止日期，yyyyMMdd

附录A-用户请求HMAC签名算法

• 签名方式：hmac-sha1

• 签名密钥由本系统统一线下提供

签名校验的通用步骤如下：

第一步: 设所有发送或者接收到的数据为集合M，将集合M内非空参数值的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA。

假设传送的参数如下：

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

对参数按照key=value的格式，并按照参数名ASCII字典序排序如下：

	openid=xv909vsfijksf9912&partner_id=10000&sign_method=HMAC&stuempno=09893092&timestamp=20150119130901

** 特别注意以下重要规则：**

• 参数名ASCII码从小到大排序（字典序）；

• 如果参数的值为空不参与签名；

• 参数名区分大小写；

• 传送的sign参数不参与签名，用该sign值作校验。

第二步: 用密钥secretkey对stringA字符串，进行hmac-sha1签名，得到sign值signValue。signValue最后采用十六进制小写hex编码生成签名字符串。