商户侧实名校验接口
1. 接口介绍
功能简述：
免密签约过程中，招行通过商户提供的回调地址发送招行侧一网通用户信息，由商户自行校验是否允许该一网通用户继续完成免密签约。
应用场景：
商户具有客户实名信息，需要控制与商户侧信息一致的一网通户可以完成一网通免密签约。
约束条件：
1、商户已向招行申请开通“用户实名认证功能”，并提供接收用户信息的回调地址。
正常流程：
1、用户在商户APP内点击一网通免密签约
2、商户调用“签订支付协议”接口发起签约
3、招行按照本章节“请求报文”格式主动向商户发送一网通用户实名信息
4、商户接收请求，并使用招行公钥进行验签
5、商户校验是否允许该一网通用户签约，按照本章节“响应报文”格式返回招行校验结果
6、招行根据商户校验结果，控制是否允许一网通用户继续签约流程
异常流程:
1、验签失败
2. 请求地址
测试环境URL：
由商户提供，联系招行人员配置
生产环境URL：
由商户提供，联系招行人员配置
请求方式：
POST
3. 请求报文
| 参数名 | 类型（长度） | 必填 | 描述 | 示例 |
|---|---|---|---|---|
| dateTime | String（14） | M | 请求时间，银行发起该请求的时间，精确到秒。 格式： yyyyMMddHHmmss | 20160623101430 |
| txCode | String | M | 交易码，固定为BKRELCK | BKRELCK |
| branchNo | String(4) | M | 商户分行号，4位数字 | 0755 |
| merchantNo | String(6) | M | 商户号，6位数字 | 123456 |
| bankSerialNo | String(20) | M | 银行做此查询请求的流水号 | 2016062310143088 |
| userID | String(20) | O | 商户签约时上送的用户userid | Aa123 |
| userRealName | String | M | 姓名 | 张三 |
| userRealPidType | String(2) | M | 证件类型： | 01 |
| userRealPid | String | M | 证件号 | 440697199012128888 |
| signature | String | M | 数字签名 签名数据源: 对所有请求参数（signature除外）按名称进行排序并用"&"拼接， Value内容不做urlencode， 如 aaa=AAA&bbb=BBB<&ddd=小d ， 取UTF-8编码的byte数组作为签名数据源。 签名私钥: 招行企业网银私钥 签名算法: SHA1WithRSA 签名验签: 使用招行公钥进行验签。 |
请求示例：
假设请求参数原始信息如下：
{
"dateTime":"20160623101430",
"txCode":"BKRELCK",
"branchNo":"0755",
"merchantNo":"002346",
"bankSerialNo":"2016062310143088",
“userID”:Aa123,
"userRealName":"张三",
"userRealPidType":"1",
"userRealPid":"440697199012128888"
}排序拼接后的待签名字符串如下：
bankSerialNo=2016062310143088&branchNo=0755&dateTime=20160623101430&merchantNo=002346&txCode=BKRELCK&userID=Aa123&userRealName=张三&userRealPid=440697199012128888&userRealPidType=1
4. 响应报文
| 参数名 | 类型（长度） | 必填 | 描述 | 示例 |
|---|---|---|---|---|
| rspCode | String | M | 处理结果返回码：SUC0000实名校验成功其他实名校验失败 | SUC0000 |
| rspMsg | String | M | 处理结果返回码的描述信息 | 实名校验成功 |
| bankSerialNo | String(20) | M | 银行流水号，原样返回请求报文中的bankSerialNo | 2016062310143088 |
响应示例：
{
"rspCode":"SUC0000",
"rspMsg":"实名校验成功",
" bankSerialNo":"2016062310143088"
}5. 错误码
| 错误码 | 错误描述 |
|---|---|
NP4043 | 商户证件编号或姓名AES—128解密失败 |
NP4042 | 商户证件类型、证件编号、商户姓名入参非法 |
6. FAQ
无
