# 校验实名信息

调试诊断

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南

接口英文名:checkrealnameinfo

业务方页面获得code之后,需要通过该接口进行实名信息的校验。校验完成后,业务方再根据具体情况,完成自有的业务流程。

城市服务实名信息校验流程请参考此文档

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/intp/realname/checkrealnameinfo?access_token=ACCESS_TOKEN

# 云调用

  • 本接口不支持云调用。

# 第三方调用

  • 本接口不支持第三方平台调用。

# 2. 请求参数

# 查询参数 Query String Parameters

参数名类型必填示例说明
access_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_token

# 请求体 Request Payload

参数名类型必填说明
openidstring用户在业务方下的openid,与申请权限时提供的业务方的小程序appid保持一致
real_namestring需要校验的姓名
cred_idstring需要校验的证件号
cred_typestring默认为1,即身份证,目前暂只支持身份证
codestring通过小程序回跳获取的code参数

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明枚举
errcodenumber错误码-
errmsgstring错误描述-
verify_openidstringopenid 验证结果,有多个结果时用分号;连接枚举值
verify_real_namestringreal_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 诊断工具 辅助定位和分析问题。

错误码错误描述
1005invalid appid
80111实名校验code不存在
80113无效code

# 8. 适用范围

本接口暂未明确可调用账号类型,或在业务中根据调用传参自行确定是否可调用,请已实际调用情况为准。