认证(身份证-手机实名-银行卡四要素)接口规范
一、简介
此文档为认证接口，提供接口出来供使用方调用。接口能力说明：为商户提供认证服务，认证功能包括（公安部）身份证验证、手机实名验证、银行卡四要素验证。
加解密及签名：
- 生成随机密钥，将随机密钥使用RSA公钥加密
- 将交易接口中的数据组装成json，要求值为字符串
- 使用随机密钥对上一步生成的json字符串进行AES加密
- 使用RSA私钥对json字符串进行签名
二、身份证验证
请求参数：
| 参数 | 备注 | 是否必填 | 说明 |
|---|---|---|---|
| cert_no | 合法身份证号 | Y | |
| name | 姓名 | Y | |
| partner_id | 平台号 | Y | |
| v | 版本 | Y | 统一1.1 |
| method | 接口方法 | Y | yumei.auth.idcard |
| timestamp | 时间戳 | Y | |
| format | 参数类型 | Y | JSON |
| sign_method | 加密 | Y | rsa |
三、手机实名验证
请求参数：
| 参数 | 备注 | 是否必填 | 说明 |
|---|---|---|---|
| cert_no | 合法身份证号 | Y | |
| mobile | 合法手机号 | Y | |
| partner_id | 平台号 | Y | |
| v | 版本 | Y | 统一1.1 |
| method | 接口方法 | Y | yumei.auth.mobile |
| timestamp | 时间戳 | Y | |
| format | 参数类型 | Y | JSON |
| sign_method | 加密 | Y | rsa |
四、银行卡四要素验证：
请求参数
| 参数 | 备注 | 是否必填 | 说明 |
|---|---|---|---|
| cert_no | 合法身份证号 | Y | |
| mobile | 合法手机号 | Y | |
| card_no | 银行卡号 | Y | |
| name | 姓名 | Y | |
| partner_id | 平台号 | Y | |
| v | 版本 | Y | 统一1.1 |
| method | 接口方法 | Y | yumei.auth.bankcard |
| timestamp | 时间戳 | Y | |
| format | 参数类型 | Y | JSON |
| sign_method | 加密 | Y | rsa |
统一返回结果：
| 参数 | 备注 | 说明 |
|---|---|---|
| success | 接口是否调用成功 | true/false |
| result_code | 系统级结果码 | 详见服务系统级结果码 |
| result_code_msg | 结果详情 | |
| sign | 签名 |
五、结果码
| 返回码 | 含义 |
|---|---|
| 0000 | 交易成功 |
| T202 | 没有权限访问 |
| 0030 | 格式错 |
| T427 | 账号不能为空 |
| 0012 | 无效交易 |
| T434 | 接口维护中 |
| 0096 | 系统异常 |
| T450 | 手机号码不能为空 |
| 0098 | 交易超时 |
| T453 | 姓名不能为空 |
| 00A0 | 校验失败 |
| T455 | 身份证不能为空 |
| 00A1 | 商户身份验证失败 |
| T458 | 身份证格式不对 |
| 00A2 | 无效签到 |
| T471 | 认证接口调用超限 |
| T472 | 地址不能为空 |
| T489 | 暂不支持的手机号 |
更多精彩内容
