用户在银行端取消免密支付协议的回调通知
1. 接口介绍
功能简述:
用户通过招行APP取消一网通免密支付协议后,招行主动给商户发此通知。
约束条件:
默认不会主动给商户发送通知,商户如有需要,请提供回调地址并联系对接分行进行配置。
正常流程:
1、 用户在招行APP--设置--安全中心-支付设置--免密支付,选择商户后进入该商户的免密支付设置页,点击“关闭免密服务”;或注销招行APP一网通用户时自动取消支付协议
2、 判断商户是否配置回调地址
3、 往回调地址发通知
异常流程:
1、 商户提供的回调地址网络不通
2、 商户没响应HTTP 200
2. 请求地址
商户提供的回调通知地址,由招行在系统中配置,配置路径:商户管理系统——免密协议取消回调地址。
3. 请求报文
适用于银行主动回调商户,报文通过招行证书私钥进行签名,商户需通过招行公钥验证通知来源于招行。由银行作为发起方发起请求,商户接收请求后返回响应信息。
报文的参数名:jsonRequestData,参数值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 |
noticeType | String | M | 通知类型,固定为BKQX | BKQX |
noticeSerialNo | String(40) | M | 通知序列号 | 201606238888888 |
branchNo | String(4) | M | 商户分行号,4位数字 | 0755 |
merchantNo | String(6) | M | 商户号,6位数字 | 002346 |
noticeUrl | String | M | 回调地址 | http://test.52sz.co/zsPay/zsResult.php |
httpMethod | String | M | 回调方法,固定为Post | Post |
agrNo | String(32) | M | 客户协议号 | 1234567891234568789 |
bankSerialNo | String(30) | M | 银行处理该请求的流水号 | 2016062310143099 |
bank_msg | Char(80) | M | 描述信息 | 取消协议 |
请求示例:
json报文组织:
{ "version":"1.0", "charset":"UTF-8", "sign":"…", "signType":"RSA", "noticeData":{ "dateTime":"20160622182921", "noticeType":"BKQX", "noticeSerialNo":"201606238888888", "branchNo":"0755", "merchantNo":"002346", "noticeUrl":"http://test.52sz.co/zsPay/zsResult.php", "httpMethod":"POST", "agrNo":"1234567891234568789", "bankSerialNo":"2016062310143099", "bank_msg":"取消协议" } }
表单组织:
<form action="请求地址" method="post" > <input type="hidden" name="jsonRequestData" value="以上json字符串" /> </form>
4. 响应报文
返回 HTTP Status Code 200,表示成功接收。否则表示未成功,未成功则银行会进行重发,重发直至响应成功或重发次数达到上限后停止重发。
5. 错误码
无
6. FAQ
无