请求地址
商户预留的通知接收地址,即通过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