微信支付-开发者文档

返回上一层文档首页 / 商圈会员待积分状态查询

商圈会员待积分状态查询

最新更新时间：2022.08.25 版本说明

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

注意：

• 商户上送敏感信息时使用微信支付平台公钥加密，证书序列号包含在请求HTTP头部的Wechatpay-Serial，详见接口规则

• 商圈已对接完成商圈会员3.0版本，详见接入文档

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

接入顺序

1. “商圈会员快速积分”小程序插件开发文档

2. 商圈会员积分服务授权结果通知（用户在商圈小程序完成会员积分服务授权后，会将用户的授权情况发送至开通时配置的会员积分服务开通回调地址）

3. 商圈会员场内支付结果通知（已授权商圈会员积分服务的用户，在场内发生微信支付交易时，会将消费信息发送至开通时配置的的用户消费回调地址）

4. 商圈会员积分同步（只有接入该接口，才会获取到退款信息）

5. 商圈会员场内退款通知（对已同步过积分的会员消费，监控30天内的退款情况，若发生退款，会将退款信息发送至开通时配置的的用户消费回调地址）

6. 商圈会员积分服务授权状态查询（可通过此api查询已授权过商圈会员积分服务用户的最新授权状态）

7. 商圈会员待积分状态查询（可通过此api查询已授权商圈会员积分服务的用户当天是否有待积分的消费，并可在商圈小程序任意页面引导用户前往“商圈会员快速积分”插件提交积分申请）

8. 商圈会员停车状态同步（可通过此api同步会员停车到场状态给微信支付，对用会员的商场内门店消费可100%自动积分）

接口说明

适用对象：服务商

请求URL：https://api.mch.weixin.qq.com/v3/businesscircle/users/{openid}/points/commit_status

请求方式：get

path指该参数为路径参数

query指该参数需在请求URL传参

body指该参数需在请求JSON传参

请求参数

参数名	变量	类型[长度限制]	必填	描述
子商户号	sub_mchid	string[1, 32]	否	query微信支付分配的子商户号，服务商模式下必传示例值：1900000109
品牌ID	brandid	int	是	query调用方商户号对应的品牌brandid，调用方商户号需为此品牌brandid的品牌主商户号或品牌服务商商户号示例值：1000
应用ID	appid	string[1,128]	是	query支持服务号、小程序等类型的AppID，需已与brandid完成下单AppID绑定示例值：wx931386123456789e
用户标识	openid	string[1,128]	是	path用户在商户对应AppID下的唯一标识示例值：oUpF8uMuAJOM2pxb1Q

请求示例

https://api.mch.weixin.qq.com/v3/businesscircle/users/oUpF8uMuAJOM2pxb1Q/points/commit_status?sub_mchid=1900000109&brandid=1000&appid=wx931386123456789e

返回参数

参数名	变量	类型[长度限制]	必填	描述
商圈会员待积分状态	points_commit_status	string	否	商圈会员待积分状态 PENDING：有积分待提交，商圈会员有待提交的积分记录，可引导会员跳转插件提交积分申请 FINISHED：无积分可提交，商圈会员没有待提交的积分记录示例值：PENDING

返回示例

正常示例


{
  "points_commit_status": "PENDING"
}

错误码公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数有误：应用ID（appid）为空	请传入appid
	PARAM_ERROR	参数有误：品牌ID（brandid）为空	请传入brandid
	PARAM_ERROR	参数有误：用户标识（openid）为空	请传入openid
	PARAM_ERROR	参数有误：用户标识（openid）有误	传入的openid有误，请修改后重试
	PARAM_ERROR	参数有误：子商户号（sub_mchid）有误	传入的特约商户号有误，请修改后重试
	INVALID_REQUEST	传入的openid未对当前商圈授权会员快速积分	用户未对商圈授权会员积分服务
403	NOAUTH	无权限，传入的sub_mchid非brandid的品牌主商户号	传入的商户号非品牌主商户号，请修改后重试
	NOAUTH	无权限，mchid与submchid无父子关系	发起请求的商户与特约商户无父子关系，请修改后重试
	NOAUTH	填写的用户openid与appid不匹配，请传入正确的appid下的用户openid	openid与appid不匹配，请修改后重试
	NOAUTH	无权限，appid未与brandid绑定	appid未与brandid绑定，请修改后重试
	NOAUTH	无权限，brandid下商圈不唯一	传入的品牌id无关联的商圈，请修改后重试
	NOAUTH	该接口仅支持接入商圈会员的商圈调用	请商圈升级接入商圈会员3.0版本后重试
500	SYSTEMERROR	系统错误，请稍后再试	请求的商户id有误，请修改后重试
	SYSTEMERROR	系统错误，请稍后再试	查询用户的积分提交状态失败，请稍后重试
	SYSTEMERROR	系统错误，请稍后再试	查询用户的授权状态失败，请稍后重试

微信支付合作伙伴平台