授权码查询openid

更新时间：2026.05.21

通过授权码查询公众号 openid，调用查询后，该授权码只能由此商户号发起扣款，直至授权码更新。

如果子商户号没有绑定 appid，只返回 openid。

如果子商户号绑定一个 appid 或多个 appid，入参 sub_appid 必传，返回 openid 和 sub_openid。

字段名	变量名	是否必填	类型	示例值	描述
公众账号 ID	`appid`	是	`String(32)`	`wx8888888888888888`	微信分配的公众账号 ID。
商户号	`mch_id`	是	`String(32)`	`1900000109`	微信支付分配的商户号。
子商户公众账号 ID	`sub_appid`	否	`String(32)`	`wx8888888888888888`	微信分配的子商户公众账号 ID。
子商户号	`sub_mch_id`	是	`String(32)`	`1900000109`	微信支付分配的子商户号。
授权码	`auth_code`	是	`String(128)`	`120061098828009406`	扫码支付授权码，设备读取用户微信中的条码或者二维码信息。
渠道商商户号	`channel_id`	是	`String(32)`	`19000001`	微信支付分配给收单服务商的 ID。
网联 IDC 标识	`idc_flag`	是	`String(2)`	`10`	交易发往的网联条码支付 IDC 标识，具体规则见 4.8 网联条码支付 IDC 标识。
随机字符串	`nonce_str`	是	`String(32)`	`5K8264ILTKCH16CQ2502SI8ZNMTM67VS`	随机字符串，不长于 32 位。推荐随机数生成算法。
签名	`sign`	是	`String(512)`	`C380BEC2BFD727A4B6845133519F3AD6`	签名。

字段名	变量名	是否必填	类型	示例值	描述
返回状态码	`return_code`	是	`String(16)`	`SUCCESS`	`SUCCESS/FAIL`。
返回信息	`return_msg`	否	`String(128)`	`签名失败`	返回信息，如非空，为错误原因。签名失败。参数格式校验错误。

以下字段在 return_code 为 SUCCESS 的时候有返回：

字段名	变量名	是否必填	类型	示例值	描述
公众账号 ID	`appid`	是	`String(32)`	`wx8888888888888888`	调用接口提交的公众账号 ID。
商户号	`mch_id`	是	`String(32)`	`1900000109`	调用接口提交的商户号。
子商户公众账号 ID	`sub_appid`	否	`String(32)`	`wx8888888888888888`	调用接口提交的子商户公众账号 ID。
子商户号	`sub_mch_id`	是	`String(32)`	`1900000109`	调用接口提交的子商户号。
随机字符串	`nonce_str`	是	`String(32)`	`5K8264ILTKCH16CQ2502SI8ZNMTM67VS`	网联返回的随机字符串。
业务结果	`result_code`	是	`String(16)`	`SUCCESS`	`SUCCESS/FAIL`。
签名	`sign`	是	`String(512)`	`C380BEC2BFD727A4B6845133519F3AD6`	网联返回的签名。
错误代码	`err_code`	否	`String(32)`	`SYSTEMERROR`	`SYSTEMERROR`-- 系统错误`AUTHCODEEXPIRE`-- 授权码过期`AUTH_CODE_ERROR`-- 授权码错误`AUTH_CODE_INVALID`-- 授权码检验错误

以下字段在 return_code 和 result_code 都为 SUCCESS 的时候有返回：

字段名	变量名	是否必填	类型	示例值	描述
用户标识	`openid`	是	`String(128)`		用户在商户 appid 下的唯一标识。
用户子标识	`sub_openid`	否	`String(128)`		用户在子商户 appid 下的唯一标识。

文档是否有帮助