成功支付结果前端通知API
请求地址
附加在成功页返回商户按钮链接的参数中
适用于PC端生成扫码支付页面API中成功页返回商户地址returnUrl后附加的参数。
请求报文
适用于银行主动跳转到商户，报文需通过招行证书私钥进行签名，商户通过招行证书公钥验证通知来源于招行。由银行作为发起方发起请求，商户接收请求后无需返回响应信息。
报文的参数名：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 | 卡类型,02：本行借记卡； 03：本行贷记卡； 08：他行借记卡； 09：他行贷记卡 | 02 |
| 以下字段联系招行配置控制参数后返回（默认不返回）： | |||||
| 支付用户标识 | uniqueUserID | String(30) | C | 支付用户ID，由身份证+姓名生成（推荐使用） | UQwanCunLbp6cl1RbDFODrhLrAa48= |
| 一网通用户标识 | expandUserID | String(30) | C | 一网通用户ID，由一网通ID生成（招行一网通用户的身份标识） | UQwanCunLbp6cl1RbDFODrhLrAa48= |
请求示例
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次后停止重发。
错误码
无
