微信企业号之userid与openid互转

今天药忘吃喽~ 2022-04-11 07:26 1035阅读 0赞

### 一.前言 ###

该接口使用场景为微信支付、微信红包和企业转账，企业号用户在使用微信支付的功能时，需要自行将企业号的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][https_qyapi.weixin.qq.com_cgi-bin_user_convert_to_openid_access_token_ACCESS_TOKEN]

1.请求参数

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

2.参数说明

<table> 
 <tbody> 
  <tr> 
   <th>参数 </th> 
   <th>必须 </th> 
   <th>说明 </th> 
  </tr> 
  <tr> 
   <td> access_token </td> 
   <td> 是 </td> 
   <td> 调用接口凭证 </td> 
  </tr> 
  <tr> 
   <td> userid </td> 
   <td> 是 </td> 
   <td> 企业号内的成员id </td> 
  </tr> 
  <tr> 
   <td> agentid </td> 
   <td> 否 </td> 
   <td> 整型，需要发送红包的应用ID，若只是使用微信支付和企业转账，则无需该参数 </td> 
  </tr> 
 </tbody> 
</table>

3.权限说明  
成员必须处于应用的可见范围内，并且管理组对应用有使用权限、对成员有查看权限。

4.返回说明

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

5.返回参数说明

<table> 
 <tbody> 
  <tr> 
   <th>参数 </th> 
   <th>说明 </th> 
  </tr> 
  <tr> 
   <td> openid </td> 
   <td> 企业号成员userid对应的openid，若有传参agentid，则是针对该agentid的openid。否则是针对企业号corpid的openid </td> 
  </tr> 
  <tr> 
   <td> appid </td> 
   <td> 应用的appid，若请求包中不包含agentid则不返回appid。该appid在使用微信红包时会用到 </td> 
  </tr> 
 </tbody> 
</table>

### 三.openid转为userid ###

该接口主要应用于使用微信支付、微信红包和企业转账之后的结果查询，开发者需要知道某个结果事件的openid对应企业号内成员的信息时，可以通过调用该接口进行转换查询。

1.请求说明  
Https请求方式: POST

[https://qyapi.weixin.qq.com/cgi-bin/user/convert\_to\_userid?access\_token=ACCESS\_TOKEN][https_qyapi.weixin.qq.com_cgi-bin_user_convert_to_userid_access_token_ACCESS_TOKEN]

2.请求参数

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

3.参数说明

<table> 
 <tbody> 
  <tr> 
   <th>参数 </th> 
   <th>必须 </th> 
   <th>说明 </th> 
  </tr> 
  <tr> 
   <td> openid </td> 
   <td> 是 </td> 
   <td> 在使用微信支付、微信红包和企业转账之后，返回结果的openid </td> 
  </tr> 
 </tbody> 
</table>

4.权限说明  
管理组需对openid对应的企业号成员有查看权限。

5.返回说明

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

6.返回参数说明

<table> 
 <tbody> 
  <tr> 
   <th>参数 </th> 
   <th>说明 </th> 
  </tr> 
  <tr> 
   <td> userid </td> 
   <td> 该openid在企业号中对应的成员userid </td> 
  </tr> 
 </tbody> 
</table>

[https_qyapi.weixin.qq.com_cgi-bin_user_convert_to_openid_access_token_ACCESS_TOKEN]: https://qyapi.weixin.qq.com/cgi-bin/user/convert_to_openid?access_token=ACCESS_TOKEN
[https_qyapi.weixin.qq.com_cgi-bin_user_convert_to_userid_access_token_ACCESS_TOKEN]: https://qyapi.weixin.qq.com/cgi-bin/user/convert_to_userid?access_token=ACCESS_TOKEN