微信小程序 城市服務(wù)實名信息校驗

2022-05-11 15:56 更新

checkrealnameinfo

接入微信城市服務(wù),開發(fā)者小程序可以使用實名信息校驗接口。主要實現(xiàn)的功能是,在用戶同意情況下,通過微信城市服務(wù)去校驗用戶(或業(yè)務(wù)方)輸入的實名信息,是否正確且與用戶在“開通微信支付”時,預(yù)留的實名信息一致。此接口與接入城市服務(wù)的開放范圍一致,需申請權(quán)限可點擊此處查看詳細(xì)說明。

接口文檔說明

1、業(yè)務(wù)流程說明

  1. 第一步:業(yè)務(wù)方小程序的界面,需要實現(xiàn)實名信息校驗時,需根據(jù)接口文檔提供的path跳轉(zhuǎn)至微信城市服務(wù)提供的小程序授權(quán)頁。
  2. 第二步:用戶在微信授權(quán)頁點擊同意確認(rèn)后,微信會回跳至業(yè)務(wù)方小程序,并帶上code參數(shù)(code參數(shù)包含在返回的extraData)。
  3. 第三步:業(yè)務(wù)方頁面獲得code之后,需要通過后臺調(diào)用微信提供的后臺API,進(jìn)行實名信息的校驗。校驗完成后,業(yè)務(wù)方再根據(jù)具體情況,完成自有的業(yè)務(wù)流程。

2、獲取code參數(shù)

根據(jù)4.1描述的步驟,調(diào)用后臺API校驗實名信息時,需要先獲取code參數(shù)。獲取方式如下:

1、請求方式:

跳轉(zhuǎn)至微信城市服務(wù)提供的appid和path appid:wx308bd2aeb83d3345 path:subPages/city/wxpay-auth/main

2、應(yīng)答方式:

用戶完成確認(rèn)同意后,會跳回至業(yè)務(wù)方小程序,并在extraData字段中帶上調(diào)用后臺接口所需的code,即extraData中的code字段。 如需了解如何處理extraData字段,可以點擊此處查看更多

3、后臺校驗實名信息的API

注:此后臺API,與小程序API使用方式一致。如需了解小程序API使用方式,請點擊此處查看詳細(xì)說明

1、請求方式:POST

2、請求地址:

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

說明:此處的access_token獲取方式,可點擊此處參考詳細(xì)說明

3、請求格式:JSON

4、請求參數(shù):

字段 類型 說明 備注
openid string 用戶在業(yè)務(wù)方下的openid 與申請權(quán)限時提供的業(yè)務(wù)方的小程序appid保持一致
real_name string 姓名 需要校驗的姓名
cred_id string 證件號 需要校驗的證件號
cred_type string 默認(rèn)為1,即身份證 目前暫只支持身份證
code string 回調(diào)獲取的code 通過小程序回跳獲取的code參數(shù)

5、返回字段:

字段 類型 說明 備注
errcode int 0為接口調(diào)用成功 錯誤碼
errmsg string 失敗時的錯誤提示 錯誤原因
verify_openid string V_OP_NA:用戶暫未實名認(rèn)證;V_OP_NM_MA:用戶與姓名匹配;V_OP_NM_UM:用戶與姓名不匹配。 有多個結(jié)果時用分號”;”連接;
verify_real_name string 當(dāng)verify_openid 為V_OP_NM_MA 時返回:V_NM_ID_MA:姓名與證件號匹配;V_NM_ID_UM:姓名與證件號不匹配。 校驗結(jié)果


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號