1. 程式人生 > >微信企業號之userid與openid互轉

微信企業號之userid與openid互轉

一.前言

該介面使用場景為微信支付、微信紅包和企業轉賬,企業號使用者在使用微信支付的功能時,需要自行將企業號的userid轉成openid。在使用微信紅包功能時,需要將應用id和userid轉成appid和openid才能使用。

二.userid轉換為openid

請求說明
Https請求方式: POST

https://qyapi.weixin.qq.com/cgi-bin/user/convert_to_openid?access_token=ACCESS_TOKEN

1.請求引數

{
   "userid": "zhangsan",
   "agentid": 1
}

2.引數說明

引數 必須 說明
access_token 呼叫介面憑證
userid 企業號內的成員id
agentid 整型,需要傳送紅包的應用ID,若只是使用微信支付和企業轉賬,則無需該引數

3.許可權說明
成員必須處於應用的可見範圍內,並且管理組對應用有使用許可權、對成員有檢視許可權。

4.返回說明

{
"errcode": 0, "errmsg": "ok", "openid": "oDOGms-6yCnGrRovBj2yHij5JL6E", "appid":"wxf874e15f78cc84a7" }

5.返回引數說明

引數 說明
openid 企業號成員userid對應的openid,若有傳參agentid,則是針對該agentid的openid。否則是針對企業號corpid的openid
appid 應用的appid,若請求包中不包含agentid則不返回appid。該appid在使用微信紅包時會用到

三.openid轉為userid

該介面主要應用於使用微信支付、微信紅包和企業轉賬之後的結果查詢,開發者需要知道某個結果事件的openid對應企業號內成員的資訊時,可以通過呼叫該介面進行轉換查詢。

1.請求說明
Https請求方式: POST

https://qyapi.weixin.qq.com/cgi-bin/user/convert_to_userid?access_token=ACCESS_TOKEN

2.請求引數

{
   "openid": "oDOGms-6yCnGrRovBj2yHij5JL6E"
}

3.引數說明

引數 必須 說明
openid 在使用微信支付、微信紅包和企業轉賬之後,返回結果的openid

4.許可權說明
管理組需對openid對應的企業號成員有檢視許可權。

5.返回說明

{
   "errcode": 0,
   "errmsg": "ok",
   "userid": "zhangsan"
}

6.返回引數說明

引數 說明
userid 該openid在企業號中對應的成員userid