Apple Pay支付

支付结果异步通知API

请求地址

商户预留的通知接收地址,即通过transactionInfo参数传入的payNoticeUrl值。

通知报文

适用于银行主动回调商户,报文经过招行证书私钥进行签名,商户需通过招行证书公钥验证通知来源于招行。由银行作为发起方发起请求,商户接收请求后返回响应信息。

报文的参数名:jsonRequestData,参数值JSON格式见下表

参数名称JSON键值类型(长度)必填描述示例
接口版本号versionString(3)M固定为”1.0”1.0
参数编码charsetString(8)M固定为UTF-8UTF-8
报文签名signStringM

签名算法signTypeStringM固定为”RSA”
应答数据noticeData

时间戳dateTimeString(14)M

格式:

yyyyMMddHHmmss

含义:

银行返回该数据的时间


返回商户地址noticeUrlString(256)M
http://www.merchant.com/path/WAPProcResult.dll
请求方式httpMethodString(10)M固定为POST
分行号branchNoString(4)M支付商户开户分行号,0755
商户号merchantNoString(6)M支付商户号000054
通知类型noticeTypeString(8)MAPPLEPAY:ApplePay支付结果通知BKPAYRTN
银行通知序号noticeSerialNoString(30)M商户日期+订单号+发送时间201610249999000001121212
商户交易日期dateString(8)M

商户交易日期

格式:YYYYMMDD

20161024
订单号orderNoString(10)M商户订单号9999000001
金额amountString(13)M支付金额,格式:XXXX.XX0.01
银行受理日期bankDateString(8)M银行受理日期
银行交易流水号bankSerialNoString(20)M银行交易流水号
商户自定义参数merchantParaString(256)O商户自定义参数(支付接口中payNoticePara送来)

响应报文

商户返回 HTTP Status Code 200 , 表示成功接收。否则表示未成功,未成功则银行会进行重发,重发直至响应成功或重发次数达到上限9次后停止重发。

示例

通知示例:

{
  "version":"1.0",
  "charset":"UTF-8",
  "sign":"…",
  "signType":"RSA",
  "noticeData":{                   
       "dateTime":"20161024120100",
       "noticeUrl":"http://www.merchant.com/path/WAPProcResult.dll",
       "httpMethod":"POST",
       "branchNo":"0755",
       "merchantNo":"000054",
       "noticeType":"APPLEPAY",
       "noticeSerialNo":"201610249999000001121212",
       "date":"20161024",
       "orderNo":"9999000001",
       "amount":"0.01",
       "bankDate":"20161024",
       "bankSerialNo":"20161024121201000001",
       "merchantPara":"12345678|ABCDEFG|HIJKLM"
       }
 }

待验证签名字符串strToSign为:
amount=0.01&bankDate=20161024&bankSerialNo=20161024121201000001&branchNo=0755&dateTime=20161024182921&httpMethod=POST&merchantNo=000054&merchantPara=12345678|ABCDEFG|HIJKLM&noPwdPay=N&noticeSerialNo=201610249999000001121212&noticeType=APPLEPAY&noticeUrl=http://www.merchant.com/path/WAPProcResult.dll&orderNo=9999000001