基础支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
微信支付分(公共API)
微信支付分(免确认预授权模式)
微信支付分(需确认模式)
支付即服务
行业方案
智慧商圈
微信支付分停车服务
电子发票
营销工具
代金券
商家券
委托营销
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
商家转账到零钱
分账
风险合规
消费者投诉2.0
其他能力
清关报关
图片上传
视频上传
微信支付平台证书

商圈会员待积分状态查询

最新更新时间: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传参

请求参数

参数名 变量 类型[长度限制] 必填 描述
品牌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?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有误,请修改后重试
INVALID_REQUEST 传入的openid未对当前商圈授权会员快速积分 用户未对商圈授权会员积分服务
403 NOAUTH 填写的用户openid与appid不匹配,请传入正确的appid下的用户openid openid与appid不匹配,请修改后重试
NOAUTH 无权限,appid未与brandid绑定 appid未与brandid绑定,请修改后重试
NOAUTH 无权限,brandid下商圈不唯一 传入的品牌id无关联的商圈,请修改后重试
NOAUTH 该接口仅支持接入商圈会员的商圈调用 请商圈升级接入商圈会员3.0版本后重试
500 SYSTEMERROR 系统错误,请稍后再试 请求的商户id有误,请修改后重试
SYSTEMERROR 系统错误,请稍后再试 查询用户的积分提交状态失败,请稍后重试
SYSTEMERROR 系统错误,请稍后再试 查询用户的授权状态失败,请稍后重试



技术咨询

文档反馈