Apple Pay支付

transactionInfo报文数据说明

参数说明

报文数据的参数名:transactionInfo,报文数据采用JSON格式,具体参数要求如下:

参数名称JSON键值类型(长度)必填描述示例
接口版本号versionString(3)M固定为“1.0”1.0
报文签名signStringM使用支付密钥对reqData内的数据进行签名(签名方法详见3.3)
签名算法signTypeStringM固定为“SHA-256”SHA-256
请求数据reqData

分行号branchNoString(4)M商户分行号,4位数字0755
商户号merchantNoString(6)M商户号,6位数字000054
订单日期dateString(8)M格式:yyyyMMdd20161024
订单号orderNoString(10)M

10位数字,由商户生成,一天内不能重复。

订单日期+订单号唯一定位一笔订单。

9999000001
金额amountString(14)M

格式:xxxx.xx

固定两位小数,最大13位整数

0.01
成功支付结果通知地址payNoticeUrlString(256)M

商户接收成功支付结果通知的地址。

注意:

1、MerchantUrl必须以“https://”或“http://”开头;

2、MerchantUrl自身不能带商户参数;

http://www.merchant.com/path/ payNotice.do
成功支付结果通知附加参数payNoticeParaString(256)O

该参数在发送成功支付结果通知时,将原样返回商户

注意:该参数可为空,商户如果需要不止一个参数,可以自行把参数组合、拼装,但组合后的结果不能带有’&’字符。

12345678|ABCDEFG|HIJKLM
Apple分配给商户的IDmerchantIDString(60)M

商户在Apple上的ID。即商户APP的域名URL。

最大长度60自己,一般为英文字符+.符号

招商银行APP内部商户使用:

merchant.com.cmbchina.MPBBank

外部商户的APP使用自己在苹果开发者账号中申请的商户ID

merchant.com.cmbchina.MPBBank
二级商户名称subMerchantNameString(100)O

当前订单为商户的二级商户的订单时需要传送二级商户信息;

最大长度100字节(数字+中英文,一个中文算两个字节)

小米天猫旗舰店
二级商户编码subMerchantNoString(30)O

传递条件同上;

二级商户号,最大长度30字节(数字+英文)

164564561AFAF
二级商户类型名称subMerchantTypeNameString(100)O

传递条件同上;

二级商户类别名称,最大长度100字节(数字+中英文,一个中文算两个字节)

智能手机商户
二级商户类型编码subMerchantTypeNoString(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