# 校验实名信息
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南。
接口英文名:checkrealnameinfo
业务方页面获得code之后,需要通过该接口进行实名信息的校验。校验完成后,业务方再根据具体情况,完成自有的业务流程。
城市服务实名信息校验流程请参考此文档
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/intp/realname/checkrealnameinfo?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用。
# 第三方调用
- 本接口不支持第三方平台调用。
# 2. 请求参数
# 查询参数 Query String Parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| openid | string | 是 | 用户在业务方下的openid,与申请权限时提供的业务方的小程序appid保持一致 |
| real_name | string | 是 | 需要校验的姓名 |
| cred_id | string | 是 | 需要校验的证件号 |
| cred_type | string | 是 | 默认为1,即身份证,目前暂只支持身份证 |
| code | string | 是 | 通过小程序回跳获取的code参数 |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 | 枚举 |
|---|---|---|---|
| errcode | number | 错误码 | - |
| errmsg | string | 错误描述 | - |
| verify_openid | string | openid 验证结果,有多个结果时用分号;连接 | 枚举值 |
| verify_real_name | string | real_name 校验结果,当verify_openid 为V_OP_NM_MA 时返回 | 枚举值 |
# 4. 枚举信息
# Res.verify_openid Enum
openid 验证结果,有多个结果时用分号;连接
| 枚举值 | 描述 |
|---|---|
| V_OP_NA | 用户暂未实名认证 |
| V_OP_NM_MA | 用户与姓名匹配 |
| V_OP_NM_UM | 用户与姓名不匹配 |
# Res.verify_real_name Enum
real_name 校验结果,当verify_openid 为V_OP_NM_MA 时返回
| 枚举值 | 描述 |
|---|---|
| V_NM_ID_MA | 姓名与证件号匹配 |
| V_NM_ID_UM | 姓名与证件号不匹配 |
# 5. 注意事项
本接口无特殊注意事项
# 6. 代码示例
本接口无代码示例
# 7. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 |
|---|---|
| 1005 | invalid appid |
| 80111 | 实名校验code不存在 |
| 80113 | 无效code |
# 8. 适用范围
本接口暂未明确可调用账号类型,或在业务中根据调用传参自行确定是否可调用,请已实际调用情况为准。