---
url: "https://pay.weixin.qq.com/doc/v3/partner/4012474129.md"
title: "商圈会员待积分状态查询"
doc_id: 4012474129
---

>更新时间：2024.11.28

通过此API，商圈商户/服务商可以自行查询已授权“商圈会员积分服务”的会员用户当日在该商圈的待积分状态。

**注意：**

- 商户上送敏感信息需要使用微信支付公钥加密（推荐），请参考 [获取微信支付公钥ID说明](https://pay.weixin.qq.com/doc/v3/partner/4013038589.md#Q%3A-%E5%A6%82%E4%BD%95%E8%8E%B7%E5%8F%96%E5%BE%AE%E4%BF%A1%E6%94%AF%E4%BB%98%E5%85%AC%E9%92%A5ID%3F) 以及 [微信支付公钥加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059044.md)，也可以使用微信支付平台证书公钥加密，参考 [获取平台证书序列号](https://pay.weixin.qq.com/doc/v3/partner/4013059181.md)、 [平台证书加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059053.md)

- 商圈已对接完成商圈会员3.0版本，详见 [接入文档](https://docs.qq.com/doc/DYmlhc3FyalB0RGxU)

- 商圈小程序已接入「商圈会员快速积分」插件2.4.0及以上版本


**接入顺序**

1. [“商圈会员快速积分”小程序插件开发文档](https://mp.weixin.qq.com/wxopen/plugindevdoc?appid=wxfab2bf944bfc4da6&token=1213946737&lang=zh_CN)

2. [商圈会员积分服务授权结果通知](https://pay.weixin.qq.com/doc/v3/partner/4012076406.md)（用户在商圈小程序完成会员积分服务授权后，会将用户的授权情况发送至开通时配置的会员积分服务开通回调地址）

3. [商圈会员场内支付结果通知](https://pay.weixin.qq.com/doc/v3/partner/4012076414.md)（已授权商圈会员积分服务的用户，在场内发生微信支付交易时，会将消费信息发送至开通时配置的的用户消费回调地址）

4. [商圈会员积分同步](https://pay.weixin.qq.com/doc/v3/partner/4012474133.md)（只有接入该接口，才会获取到退款信息）

5. [商圈会员场内退款通知](https://pay.weixin.qq.com/doc/v3/partner/4012076419.md)（对已同步过积分的会员消费，监控30天内的退款情况，若发生退款，会将退款信息发送至开通时配置的的用户消费回调地址）

6. [商圈会员积分服务授权状态查询](https://pay.weixin.qq.com/doc/v3/partner/4012474135.md)（可通过此api查询已授权过商圈会员积分服务用户的最新授权状态）

7. [商圈会员待积分状态查询](https://pay.weixin.qq.com/doc/v3/partner/4012474129.md)（可通过此api查询已授权商圈会员积分服务的用户当天是否有待积分的消费，并可在商圈小程序任意页面引导用户前往“商圈会员快速积分”插件提交积分申请）

8. [商圈会员停车状态同步](https://pay.weixin.qq.com/doc/v3/partner/4012474127.md)（可通过此api同步会员停车到场状态给微信支付，对用会员的商场内门店消费可100%自动积分）





## 接口说明

支持商户：【普通服务商】

请求方式：【GET】 `/v3/businesscircle/users/{openid}/points/commit_status`

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引[点击查看](https://pay.weixin.qq.com/doc/v3/partner/4012082567.md)

## 请求参数

### Header 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| Authorization | string | true | 请参考 [签名认证](https://pay.weixin.qq.com/doc/v3/partner/4012365870.md#%E8%AF%B7%E6%B1%82%E6%8E%A5%E5%8F%A3%E5%90%8E%E7%AB%AF%E7%AD%BE%E5%90%8D) 生成认证信息 |
| Accept | string | true | 请设置为 `application/json` |
### Path 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| openid | string(128) | true | **【用户标识】** 用户在商户对应AppID下的唯一标识 |
### Query 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| sub_mchid | string(32) | false | **【子商户号】** 微信支付分配的子商户号，服务商模式下必传 |
| brandid | integer | true | **【品牌ID】** 调用方商户号对应的品牌brandid，调用方商户号需为此品牌brandid的品牌主商户号或品牌服务商商户号 |
| appid | string(128) | true | **【应用ID】** 支持服务号、小程序等类型的AppID，需已与brandid完成下单AppID绑定 |
## 应答参数

200 OK

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| points_commit_status | string | false | **【商圈会员待积分状态】** 商圈会员待积分状态<br>可选取值：<br><ul><li>`PENDING`: 商圈会员有待提交的积分记录，可引导会员跳转插件提交积分申请</li></ul><br><ul><li>`FINISHED`: 商圈会员没有待提交的积分记录</li></ul> |
## 错误码

### 公共错误码

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | PARAM\_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
| 400 | INVALID\_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 [接口规则](https://pay.weixin.qq.com/doc/v3/partner/4012081726.md) |
| 401 | SIGN\_ERROR | 验证不通过 | 请参阅 [签名常见问题](https://pay.weixin.qq.com/doc/v3/partner/4012082324.md) |
| 500 | SYSTEM\_ERROR | 系统异常，请稍后重试 | 请稍后重试 |

### 业务错误码

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | INVALID\_REQUEST | 传入的OpenID未对当前商圈授权会员快速积分 | 用户未对商圈授权会员积分服务 |
| 400 | PARAM\_ERROR | 参数有误：应用ID（AppID）为空 | 请传入AppID |
| 400 | PARAM\_ERROR | 参数有误：品牌ID（brandid）为空 | 请传入brandid |
| 400 | PARAM\_ERROR | 参数有误：用户标识（OpenID）为空 | 请传入OpenID |
| 400 | PARAM\_ERROR | 参数有误：用户标识（OpenID）有误 | 传入的OpenID有误，请修改后重试 |
| 400 | PARAM\_ERROR | 参数有误：子商户号（sub\_mchid）有误 | 传入的特约商户号有误，请修改后重试 |
| 403 | NO\_AUTH | 无权限，传入的sub\_mchid非brandid的品牌主商户号 | 传入的商户号非品牌主商户号，请修改后重试 |
| 403 | NO\_AUTH | 无权限，mchid与submchid无父子关系 | 发起请求的商户与特约商户无父子关系，请修改后重试 |
| 403 | NO\_AUTH | 填写的用户OpenID与AppID不匹配，请传入正确的AppID下的用户OpenID | OpenID与AppID不匹配，请修改后重试 |
| 403 | NO\_AUTH | 无权限，AppID未与brandid绑定 | AppID未与brandid绑定，请修改后重试 |
| 403 | NO\_AUTH | 无权限，brandid下商圈不唯一 | 传入的品牌ID无关联的商圈，请修改后重试 |
| 403 | NO\_AUTH | 该接口仅支持接入商圈会员的商圈调用 | 请商圈升级接入商圈会员3.0版本后重试 |

请求示例

- [curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4012474129-curl.md)
- [Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4012474129-java.md)
- [Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4012474129-go.md)


应答示例

> 200 OK

```
{
  "points_commit_status" : "PENDING"
}

```
