支付结果异步通知API
请求地址
商户预留的通知接收地址,即通过transactionInfo参数传入的payNoticeUrl值。
通知报文
适用于银行主动回调商户,报文经过招行证书私钥进行签名,商户需通过招行证书公钥验证通知来源于招行。由银行作为发起方发起请求,商户接收请求后返回响应信息。
报文的参数名:jsonRequestData,参数值JSON格式见下表
参数名称 | JSON键值 | 类型(长度) | 必填 | 描述 | 示例 | |
接口版本号 | version | String(3) | M | 固定为”1.0” | 1.0 | |
参数编码 | charset | String(8) | M | 固定为UTF-8 | UTF-8 | |
报文签名 | sign | String | M | |||
签名算法 | signType | String | M | 固定为”RSA” | ||
应答数据 | noticeData | |||||
时间戳 | dateTime | String(14) | M | 格式: yyyyMMddHHmmss 含义: 银行返回该数据的时间 | ||
返回商户地址 | noticeUrl | String(256) | M | http://www.merchant.com/path/WAPProcResult.dll | ||
请求方式 | httpMethod | String(10) | M | 固定为POST | ||
分行号 | branchNo | String(4) | M | 支付商户开户分行号, | 0755 | |
商户号 | merchantNo | String(6) | M | 支付商户号 | 000054 | |
通知类型 | noticeType | String(8) | M | APPLEPAY:ApplePay支付结果通知 | BKPAYRTN | |
银行通知序号 | noticeSerialNo | String(30) | M | 商户日期+订单号+发送时间 | 201610249999000001121212 | |
商户交易日期 | date | String(8) | M | 商户交易日期 格式:YYYYMMDD | 20161024 | |
订单号 | orderNo | String(10) | M | 商户订单号 | 9999000001 | |
金额 | amount | String(13) | M | 支付金额,格式:XXXX.XX | 0.01 | |
银行受理日期 | bankDate | String(8) | M | 银行受理日期 | ||
银行交易流水号 | bankSerialNo | String(20) | M | 银行交易流水号 | ||
商户自定义参数 | merchantPara | String(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¬iceSerialNo=201610249999000001121212¬iceType=APPLEPAY¬iceUrl=http://www.merchant.com/path/WAPProcResult.dll&orderNo=9999000001