免密支付

用户在银行端取消免密支付协议的回调通知

1. 接口介绍

功能简述:

用户通过招行APP取消一网通免密支付协议后,招行主动给商户发此通知。

约束条件:

默认不会主动给商户发送通知,商户如有需要,请提供回调地址并联系对接分行进行配置

正常流程:

1、 用户在招行APP支付设置页“关闭免密服务”,或注销招行APP一网通用户,取消支付协议
2、 判断商户是否配置回调地址
3、 往回调地址发通知

异常流程:

1、 商户提供的回调地址网络不通
2、 商户没响应HTTP 200

2. 请求地址

商户提供的回调通知地址,由招行在系统中配置,配置路径:商户管理系统——免密协议取消回调地址。

3. 请求报文

适用于银行主动回调商户,报文通过招行证书私钥进行签名,商户需通过招行公钥验证通知来源于招行。由银行作为发起方发起请求,商户接收请求后返回响应信息。

报文的参数名:jsonRequestData,参数值JSON格式见下表:

参数名类型(长度)必填描述示例
versionString(3)M接口版本号,固定为1.01.0
charsetString(8)M参数编码,固定为UTF-8UTF-8
signStringM报文签名,使用招行私钥对noticeData内的数据进行签名;商户需使用招行公钥验签。
signTypeStringM签名算法,固定为RSARSA
noticeData应答数据


dateTimeString(14)M请求时间,银行处理该交易的时间
格式:yyyyMMddHHmmss
20160622182921
noticeTypeStringM通知类型,固定为BKQXBKQX
noticeSerialNoString(40)M通知序列号201606238888888
branchNoString(4)M商户分行号,4位数字0755
merchantNoString(6)M商户号,6位数字002346
noticeUrlStringM回调地址http://test.52sz.co/zsPay/zsResult.php
httpMethodStringM回调方法,固定为PostPost
agrNoString(32)M客户协议号1234567891234568789
bankSerialNoString(30)M银行处理该请求的流水号2016062310143099
bank_msgChar(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