赛捷软件论坛's Archiver

vicky.yu 发表于 2025-12-1 17:31

微信小程序 城市服务实名信息校验

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、请求地址:

[url]https://api.weixin.qq.com/intp/realname/checkrealnameinfo?access_token=ACCESSTOKEN[/url]
说明:此处的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:姓名与证件号不匹配。

页: [1]

Powered by Discuz! Archiver 7.2  © 2001-2009 Comsenz Inc.