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

**注意：**

• 商户上送敏感信息时使用微信支付平台公钥加密，证书序列号包含在请求HTTP头部的Wechatpay-Serial，详见接口规则 (opens new window) • 商圈已对接完成商圈会员3.0版本，详见接入文档 (opens new window) • 商圈小程序已接入「商圈会员快速积分」插件2.4.0及以上版本

接入顺序：

1. “商圈会员快速积分”小程序插件开发文档 (opens new window)
2. 商圈会员积分服务授权结果通知 (opens new window)（用户在商圈小程序完成会员积分服务授权后，会将用户的授权情况发送至开通时配置的会员积分服务开通回调地址）
3. 商圈会员场内支付结果通知 (opens new window)（已授权商圈会员积分服务的用户，在场内发生微信支付交易时，会将消费信息发送至开通时配置的用户消费回调地址）
4. 商圈会员积分同步 (opens new window)（只有接入该接口，才会获取到退款信息）
5. 商圈会员场内退款通知 (opens new window)（对已同步过积分的会员消费，监控30天内的退款情况，若发生退款，会将退款信息发送至开通时配置的用户消费回调地址）
6. 商圈会员积分服务授权状态查询 (opens new window)（可通过此api查询已授权过商圈会员积分服务用户的最新授权状态）
7. 商圈会员待积分状态查询 (opens new window)（可通过此api查询已授权商圈会员积分服务的用户当天是否有待积分的消费，并可在商圈小程序任意页面引导用户前往“商圈会员快速积分”插件提交积分申请）
8. 商圈会员停车状态同步 (opens new window)（可通过此api同步会员停车到场状态给微信支付，对用会员的商场内门店消费可100%自动积分）

接口说明

支持商户：

【普通商户】

请求方式：

【GET】/v3/businesscircle/users/{openid}/points/commit_status

请求域名：

【主域名】

https://api.mch.weixin.qq.com

使用该域名将访问就近的接入点

【备域名】

https://api2.mch.weixin.qq.com

使用该域名将访问异地的接入点 ，指引点击查看

请求参数

Header HTTP头参数
Authorization 必填 string
请参考 签名认证 生成认证信息
Accept 必填 string
请设置为 application/json

Path 路径参数
openid 必填 string(128)
【用户标识】 用户在商户对应AppID下的唯一标识

Query 查询参数
sub_mchid 选填 string(32)
【子商户号】 微信支付分配的子商户号，服务商模式下必传
brandid 必填 integer
【品牌ID】 调用方商户号对应的品牌brandid，调用方商户号需为此品牌brandid的品牌主商户号或品牌服务商商户号
appid 必填 string(128)
【应用ID】 支持服务号、小程序等类型的AppID，需已与brandid完成下单AppID绑定

请求示例

GET

应答参数

200OK
points_commit_status 选填 string
【商圈会员待积分状态】 商圈会员待积分状态
可选取值：

• PENDING: 商圈会员有待提交的积分记录，可引导会员跳转插件提交积分申请
• FINISHED: 商圈会员没有待提交的积分记录

应答示例

200 OK

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅 接口规则
401	SIGN_ERROR	验证不通过	请参阅 签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	传入的OpenID未对当前商圈授权会员快速积分	用户未对商圈授权会员积分服务
400	PARAM_ERROR	参数有误：应用ID（AppID）为空	参数有误，品牌ID brandid 为空
400	PARAM_ERROR	参数有误：品牌ID（brandid）为空	请传入brandid
400	PARAM_ERROR	参数有误：用户标识（OpenID）为空	请传入OpenID
400	PARAM_ERROR	参数有误：用户标识（OpenID）有误	传入的OpenID有误，请修改后重试
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版本后重试