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

关于网站迁移公告


为提供更优质的开发技术支持,本网站已于2019年8月12日正式迁移至新域名http://openhome.cmbchina.com/paynew/pay/Home,敬请访问并收藏。原网站域名已停止更新维护,请以新网站提供的文档信息为准。

由此给您带来的不便,敬请谅解。


招商银行一网通支付技术支持小组

2019年8月12日