请求地址
一网通支付请求中商户传送的成功支付结果通知地址。
例如:一网通支付API中的payNoticeUrl参数。
请求报文
适用于银行主动回调商户,报文需通过招行证书私钥进行签名,商户通过招行证书公钥验证通知来源于招行。由银行作为发起方发起请求,商户接收请求后返回响应信息。
报文的参数名:jsonRequestData,参数值JSON格式见下表
参数名称 |
JSON键值 |
类型(长度) |
必填 |
描述 |
示例 |
接口版本号 |
version |
String(3) |
M |
固定为”1.0” |
1.0 |
参数编码 |
charset |
String(8) |
M |
固定为“UTF-8” |
UTF-8 |
报文签名 |
sign |
String |
M |
使用招行私钥对noticeData内的数据进行签名;
商户需使用招行公钥验签。 |
|
签名算法 |
signType |
String |
M |
固定为”RSA” |
RSA |
应答数据 |
noticeData |
请求时间 |
dateTime |
String(14) |
M |
银行返回该数据的时间
格式:yyyyMMddHHmmss |
20160622182921 |
回调HTTP地址 |
noticeUrl |
String(256) |
M |
支付请求时填写的支付结果通知地址 |
http://www.merchant.com/path/WAPProcResult.dll |
回调HTTP方法 |
httpMethod |
String(10) |
M |
固定为“POST” |
POST |
商户分行号 |
branchNo |
String(4) |
M |
商户分行号,4位数字 |
0755 |
商户号 |
merchantNo |
String(6) |
M |
商户号,6位数字 |
000054 |
通知类型 |
noticeType |
String(8) |
M |
本接口固定为:“BKPAYRTN” |
BKPAYRTN |
银行通知序号 |
noticeSerialNo |
String(40) |
M |
银行通知序号,订单日期+订单号 |
20180506201612169999153784 |
订单日期 |
date |
String(8) |
M |
商户订单日期
格式:yyyyMMdd
|
20160624 |
订单号 |
orderNo |
String(32) |
M |
商户订单号,支持6-32位(含6和32)间任意位数的订单号,支持不固定位数,支持数字+字母(大小字母)随意组合。 |
9999000001 |
金额 |
amount |
String(14) |
M |
订单金额,格式:XXXX.XX |
0.01 |
银行受理日期 |
bankDate |
String(8) |
M |
银行受理日期 |
20160624 |
银行订单流水号 |
bankSerialNo |
String(20) |
M |
银行订单流水号 |
20160624121201000001 |
优惠标志 |
discountFlag |
String(1) |
M |
Y:有优惠 N:无优惠 |
Y |
优惠金额 |
discountAmount |
String(14) |
M |
单位为元,精确到小数点后两位。格式为:xxxx.xx元 |
30.00 |
商户附加参数 |
merchantPara |
String(256) |
O |
原样返回商户在一网通支付请求报文中传送的成功支付结果通知附加参数 |
12345678|ABCDEFG|HIJKLM |
支付卡类型 |
cardType |
String |
M |
03:信用卡,02:借记卡 ,08:他行借记卡,09:他行信用卡 |
02 |
请求示例
1.json报文组织:
{
"version":"1.0",
"charset":"UTF-8",
"sign":"…",
"signType":"RSA",
"noticeData":{
"dateTime":"20160622182921",
"noticeUrl":"http://www.merchant.com/path/WAPProcResult.dll",
"httpMethod":"POST",
"branchNo":"0755",
"merchantNo":"000054",
"noticeType":"BKPAYRTN",
"noticeSerialNo":"201606249999000001121212",
"date":"20160624",
"orderNo":"9999000001",
"amount":"40.01",
"bankDate":"20160624",
"bankSerialNo":"20160624121201000001",
"discountFlag":"Y",
"discountAmount":"30.00",
"merchantPara":"12345678|ABCDEFG|HIJKLM",
"cardType":"02"
}
}
2.待验证签名字符串为:
amount=40.01&bankDate=20160624&bankSerialNo=20160624121201000001&branchNo=0755&cardType=02&date=20160624&dateTime=20160622182921&discountAmount=30.00&discountFlag=Y&httpMethod=POST&merchantNo=000054&merchantPara=12345678|ABCDEFG|HIJKLM¬iceSerialNo=201606249999000001121212¬iceType=BKPAYRTN¬iceUrl=http://www.merchant.com/path/WAPProcResult.dll&orderNo=9999000001
响应报文
返回 HTTP Status Code 200,表示成功接收。否则表示未成功,未成功则银行会进行重发,重发直至响应成功或重发次数达到上限9次后停止重发。