transactionInfo报文数据说明
参数说明
报文数据的参数名: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