checkrealnameinfo
接入微信城市服务,开发者小程序可以使用实名信息校验接口。主要实现的功能是,在用户同意情况下,通过微信城市服务去校验用户(或业务方)输入的实名信息,是否正确且与用户在“开通微信支付”时,预留的实名信息一致。此接口与接入城市服务的开放范围一致,需申请权限可点击此处查看详细说明。
接口文档说明
1、业务流程说明
第一步:业务方小程序的界面,需要实现实名信息校验时,需根据接口文档提供的path跳转至微信城市服务提供的小程序授权页。
第二步:用户在微信授权页点击同意确认后,微信会回跳至业务方小程序,并带上
code
参数(code
参数包含在返回的extraData
)。第三步:业务方页面获得
code
之后,需要通过后台调用微信提供的后台API,进行实名信息的校验。校验完成后,业务方再根据具体情况,完成自有的业务流程。
2、获取code参数
根据4.1描述的步骤,调用后台API校验实名信息时,需要先获取code参数。获取方式如下:
1、请求方式:
跳转至微信城市服务提供的appid和path appid:wx308bd2aeb83d3345 path:subPages/city/wxpay-auth/main
2、应答方式:
用户完成确认同意后,会跳回至业务方小程序,并在extraData字段中带上调用后台接口所需的code,即extraData中的code字段。 如需了解如何处理extraData字段,可以点击此处查看更多
3、后台校验实名信息的API
注:此后台API,与小程序API使用方式一致。如需了解小程序API使用方式,请点击此处查看详细说明
1、请求方式:POST
2、请求地址:
https://api.weixin.qq.com/intp/realname/checkrealnameinfo?access\_token=ACCESSTOKEN
说明:此处的access_token获取方式,可点击此处参考详细说明
3、请求格式:JSON
4、请求参数:
字段 | 类型 | 说明 | 备注 |
---|---|---|---|
openid | string | 用户在业务方下的openid | 与申请权限时提供的业务方的小程序appid保持一致 |
real_name | string | 姓名 | 需要校验的姓名 |
cred_id | string | 证件号 | 需要校验的证件号 |
cred_type | string | 默认为1,即身份证 | 目前暂只支持身份证 |
code | string | 回调获取的code | 通过小程序回跳获取的code参数 |
5、返回字段:
字段 | 类型 | 说明 | 备注 |
---|---|---|---|
errcode | int | 0为接口调用成功 | 错误码 |
errmsg | string | 失败时的错误提示 | 错误原因 |
verify_openid | string | V_OP_NA :用户暂未实名认证;V_OP_NM_MA :用户与姓名匹配;V_OP_NM_UM :用户与姓名不匹配。 | 有多个结果时用分号”;”连接; |
verify_real_name | string | 当verify_openid 为V_OP_NM_MA 时返回:V_NM_ID_MA :姓名与证件号匹配;V_NM_ID_UM :姓名与证件号不匹配。 | 校验结果 |