checkrealnameinfo

接入微信城市服务,开发者小程序可以使用实名信息校验接口。主要实现的功能是,在用户同意情况下,通过微信城市服务去校验用户(或业务方)输入的实名信息,是否正确且与用户在“开通微信支付”时,预留的实名信息一致。此接口与接入城市服务的开放范围一致,需申请权限可点击此处查看详细说明

接口文档说明

1、业务流程说明

  1. 第一步:业务方小程序的界面,需要实现实名信息校验时,需根据接口文档提供的path跳转至微信城市服务提供的小程序授权页。

  2. 第二步:用户在微信授权页点击同意确认后,微信会回跳至业务方小程序,并带上code参数(code参数包含在返回的extraData)。

  3. 第三步:业务方页面获得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_openidV_OP_NM_MA 时返回:V_NM_ID_MA:姓名与证件号匹配;V_NM_ID_UM:姓名与证件号不匹配。 校验结果