参数说明
报文数据的参数名:transactionInfo,报文数据采用JSON格式,具体参数要求如下:
参数名称 |
JSON键值 |
类型(长度) |
必填 |
描述 |
示例 |
接口版本号 |
version |
String(3) |
M |
固定为“1.0” |
1.0 |
报文签名 |
sign |
String |
M |
使用支付密钥对reqData内的数据进行签名(签名方法详见3.3) |
|
签名算法 |
signType |
String |
M |
固定为“SHA-256” |
SHA-256 |
请求数据 |
reqData |
|
|
分行号 |
branchNo |
String(4) |
M |
商户分行号,4位数字 |
0755 |
商户号 |
merchantNo |
String(6) |
M |
商户号,6位数字 |
000054 |
订单日期 |
date |
String(8) |
M |
格式:yyyyMMdd |
20161024 |
订单号 |
orderNo |
String(10) |
M |
10位数字,由商户生成,一天内不能重复。
订单日期+订单号唯一定位一笔订单。
|
9999000001 |
金额 |
amount |
String(14) |
M |
格式:xxxx.xx
固定两位小数,最大13位整数
|
0.01 |
成功支付结果通知地址 |
payNoticeUrl |
String(256) |
M |
商户接收成功支付结果通知的地址。
注意:
1、MerchantUrl必须以“https://”或“http://”开头;
2、MerchantUrl自身不能带商户参数;
|
http://www.merchant.com/path/ payNotice.do |
成功支付结果通知附加参数 |
payNoticePara |
String(256) |
O |
该参数在发送成功支付结果通知时,将原样返回商户
注意:该参数可为空,商户如果需要不止一个参数,可以自行把参数组合、拼装,但组合后的结果不能带有’&’字符。
|
12345678|ABCDEFG|HIJKLM |
Apple分配给商户的ID |
merchantID |
String(60) |
M |
商户在Apple上的ID。即商户APP的域名URL。
最大长度60自己,一般为英文字符+.符号
招商银行APP内部商户使用:
merchant.com.cmbchina.MPBBank
外部商户的APP使用自己在苹果开发者账号中申请的商户ID
|
merchant.com.cmbchina.MPBBank |
二级商户名称 |
subMerchantName |
String(100) |
O |
当前订单为商户的二级商户的订单时需要传送二级商户信息;
最大长度100字节(数字+中英文,一个中文算两个字节)
|
小米天猫旗舰店 |
二级商户编码 |
subMerchantNo |
String(30) |
O |
传递条件同上;
二级商户号,最大长度30字节(数字+英文)
|
164564561AFAF |
二级商户类型名称 |
subMerchantTypeName |
String(100) |
O |
传递条件同上;
二级商户类别名称,最大长度100字节(数字+中英文,一个中文算两个字节)
|
智能手机商户 |
二级商户类型编码 |
subMerchantTypeNo |
String(7) |
O |
传递条件同上;
二级商户类别编码,最大长度7字节(数字)
|
1452466 |
示例
报文数据示例
{
"version":"1.0",
"sign":"见签名处理章节",
"signType":"SHA-256",
"reqData":{
"branchNo":"0755",
"merchantNo":"000054",
"date":"20161024",
"orderNo":"9999000001",
"amount":"0.01",
"payNoticeUrl":"http://www.merchant.com/path/payNotice.do",
"payNoticePara":"12345678|ABCDEFG|HIJKLM",
"merchantID":"merchant.com.cmbchina.MPBBank",
"subMerchantName":"小米天猫旗舰店",
"subMerchantNo":"164564561AFAF",
"subMerchantTypeName":"智能手机商户",
"subMerchantTypeNo":"1452466",
}
}
待签名字符串示例(未包含支付密钥):
amount=0.01&branchNo=0755&date=20161024&merchantID=merchant.com.cmbchina.MPBBank&merchantNo=000054&orderNo=9999000001&payNoticePara=12345678|ABCDEFG|HIJKLM&payNoticeUrl=http://www.merchant.com/path/payNotice.do&subMerchantName=小米天猫旗舰店&subMerchantNo=164564561AFAF&subMerchantTypeName=智能手机商户&subMerchantTypeNo=1452466