Userid与openid互换接口

userid转换成openid接口

该接口使用场景为微信支付、微信红包和企业转账，企业号用户在使用微信支付的功能时，需要自行将企业号的userid转成openid。在使用微信红包功能时，需要将应用id和userid转成appid和openid才能使用。

• 请求说明

Https请求方式: POST

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

• 请求示例

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

• 参数说明

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

• 权限说明

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

• 返回说明

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

• 返回参数说明

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

openid转换成userid接口

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

• 请求说明

Https请求方式: POST

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

• 请求示例

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

• 参数说明

参数	必须	说明
openid	是	在使用微信支付、微信红包和企业转账之后，返回结果的openid

• 权限说明

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

• 返回说明

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

• 返回参数说明

参数	说明
userid	该openid在企业号中对应的成员userid