---
url: "https://pay.weixin.qq.com/doc/v2/partner/4011941724.md"
title: "付款码查询openid"
doc_id: 4011941724
---

>更新时间：2024.12.25

接口链接: https://api.mch.weixin.qq.com/tools/authcodetoopenid

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

注意：

- 本接口仅用于获取openid。如商户的业务场景涉及获取openid 后，对用户的资金、积分等资产做扣减操作，商户需进行二次用户身份校验(包括但不限于短信验密、会员密码验证等方式)，以确保用户资产安全，防止用户资损

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

- 如果子商户号绑定一个appid，入参sub\_appid非必传，返回openid和sub\_openid

- 如果子商户号绑定多个appid，入参sub\_appid必传，返回openid和sub\_openid




## 请求参数：

| 字段名 | 变量名 | 必填 | 类型 | 描述 |
| --- | --- | --- | --- | --- |
| 服务商的APPID | appid | 是 | String(32) | 服务商商户的APPID |
| 子商户公众账号ID | sub\_appid | 否 | String(32) | 微信分配的子商户公众账号ID |
| 商户号 | mch\_id | 是 | String(32) | 微信支付分配的商户号 |
| 子商户号 | sub\_mch\_id | 是 | String(32) | 微信支付分配的子商户号 |
| 付款码 | auth\_code | 是 | String(128) | 扫码支付付款码，设备读取用户微信中的条码或者二维码信息 |
| 随机字符串 | nonce\_str | 是 | String(32) | 随机字符串，不长于32位 |
| 签名 | sign | 是 | String(64) | 签名 |

## 同步返回结果：

| 字段名 | 变量名 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- | --- |
| 返回状态码 | return\_code | 是 | String(16) | SUCCESS/FAIL |
| 返回信息 | return\_msg | 否 | String(128) | 返回信息，如非空，为错误原因，例如：签名失败、参数格式校验错误 |
| 以下字段在return\_code为SUCCESS的时候有返回 | 以下字段在return\_code为SUCCESS的时候有返回 | 以下字段在return\_code为SUCCESS的时候有返回 | 以下字段在return\_code为SUCCESS的时候有返回 | 以下字段在return\_code为SUCCESS的时候有返回 |
| 服务商的APPID | appid | 是 | String(32) | 服务商商户的APPID |
| 子商户公众账号ID | sub\_appid | 否 | String(32) | 微信分配的子商户公众账号ID |
| 商户号 | mch\_id | 是 | String(32) | 微信支付分配的商户号 |
| 子商户号 | sub\_mch\_id | 是 | String(32) | 微信支付分配的子商户号 |
| 随机字符串 | nonce\_str | 是 | String(32) | 随机字符串，不长于32位 |
| 签名 | sign | 是 | String(32) | 签名 |
| 业务结果 | result\_code | 是 | String(16) | SUCCESS/FAIL |
| 错误代码 | err\_code | 否 | String(32) | SYSTEMERROR--系统错误<br>AUTHCODEEXPIRE---付款码过期<br>AUTH\_CODE\_ERROR—付款码错误<br>AUTH\_CODE\_INVALID—付款码检验错误 |
| 以下字段在return\_code 和result\_code都为SUCCESS的时候有返回 | 以下字段在return\_code 和result\_code都为SUCCESS的时候有返回 | 以下字段在return\_code 和result\_code都为SUCCESS的时候有返回 | 以下字段在return\_code 和result\_code都为SUCCESS的时候有返回 | 以下字段在return\_code 和result\_code都为SUCCESS的时候有返回 |
| 用户标识 | openid | 是 | String(128) | 用户在商户appid下的唯一标识 |
| 用户子标识 | sub\_openid | 否 | String(128) | 用户在子商户appid下的唯一标识 |