商圈会员待积分状态查询

更新时间：2024.11.27

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

注意：

商户上送敏感信息时需要使用微信支付公钥加密（推荐），请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引，也可以使用微信支付平台证书公钥加密，参考获取平台证书序列号、平台证书加密敏感信息指引
商圈已对接完成商圈会员3.0版本，详见接入文档
商圈小程序已接入「商圈会员快速积分」插件2.4.0及以上版本

接入顺序

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

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/businesscircle/users/oUpF8uMuAJOM2pxb1Q/points/commit_status?sub_mchid=1900000109&brandid=1000&appid=wx931386123456789e \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

points_commit_status 　选填 string

【商圈会员待积分状态】商圈会员待积分状态

可选取值：

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

应答示例

200 OK

1{
2  "points_commit_status" : "PENDING"
3}
4

错误码

公共错误码

状态码	错误码	描述	解决方案
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版本后重试

文档是否有帮助

更多支持

开发文档(服务商)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服