商户进件
特约商户进件
基础支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
支付即服务
点金计划
行业方案
电商收付通(商户进件)
电商收付通(普通支付)
电商收付通(合单支付)
电商收付通(分账)
电商收付通(补差)
电商收付通(退款)
电商收付通(余额查询)
电商收付通(商户提现)
电商收付通(下载账单)
智慧商圈
微信支付分停车服务
营销工具
代金券
商家券
委托营销
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
分账
连锁品牌分账
风险合规
商户开户意愿确认
消费者投诉2.0
其他能力
图片上传
视频上传

商圈积分授权查询

最新更新时间:2021.01.29 版本说明


通过积分授权查询API,商圈服务商可自行查询用户积分功能开通情况

接口说明

适用对象: 服务商

请求URL:https://api.mch.weixin.qq.com/v3/businesscircle/user-authorizations/{openid}

请求方式:GET

接口频率:150QPS

前置条件:商圈服务商已开通支付即积分产品功能


path 指该参数为路径参数

query 指该参数为URL参数

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


请求参数

参数名 变量 类型[长度限制] 必填 描述
商圈商户ID sub_mchid string[1, 64] query当以服务商模式管理商圈积分能力时,则要带上商圈商户ID,否则留空
示例值:1234567890
小程序appid appid string[1, 128] query顾客授权积分时使用的小程序的appid
示例值:wx1234567890abcdef
顾客openid openid string[1, 64] path顾客授权时使用的小程序上的openid
示例值:oWmnN4xxxxxxxxxxe92NHIGf1xd8

请求示例


https://api.mch.weixin.qq.com/v3/businesscircle/user-authorizations/oWmnN4xxxxxxxxxxe92NHIGf1xd8?sub_mchid=1234567890&appid=wx1234567890abcdef

{
JAVA示例代码
}

返回参数

参数名 变量 类型[长度限制] 必填 描述
顾客openid openid string[1, 64] 顾客授权时使用的小程序上的openid
示例值:oWmnN4xxxxxxxxxxe92NHIGf1xd8
授权状态 authorize_state string[1, 32] 顾客授权商圈积分结果
UNAUTHORIZED:未授权
AUTHORIZED:已授权
DEAUTHORIZED:已取消授权
示例值:UNAUTHORIZED
授权时间 authorize_time string[1, 32] 顾客成功授权商圈积分的时间,遵循rfc3339标准格式,格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE,YYYY-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss表示时分秒毫秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示北京时间2015年05月20日13点29分35秒(需要增加所有跟时间有关的参数的描述)
示例值:2020-05-20T13:29:35+08:00
取消授权时间 deauthorize_time string[1, 32] 顾客关闭授权商圈积分的时间,遵循rfc3339标准格式,格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE,YYYY-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss表示时分秒毫秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示北京时间2015年05月20日13点29分35秒(需要增加所有跟时间有关的参数的描述)
示例值:2020-05-20T13:29:35+08:00

返回示例


{
  "openid": "oWmnN4xxxxxxxxxxe92NHIGf1xd8",
  "authorize_state": "AUTHORIZED",
  "authorize_time": "2020-05-20T13:29:35+08:00"
}
                    

http://2323weixin.qq.com
                    

错误码公共错误码

状态码 错误码 描述 解决方案
400 PARAM_ERROR 请求参数中Appid非商圈支付即积分配置的Appid 请确保Appid为支付即积分配置的Appid
400 PARAM_ERROR 请求参数中Appid和Openid不匹配 请使用Appid匹配的Openid调用
400 PARAM_ERROR 请求参数中Appid无效 请使用正确的Appid调用
400 PARAM_ERROR 请求参数中Openid无效 请使用正确的Openid调用
400 INVALID_REQUEST  当前请求服务商非商圈支付即积分服务商 请以商圈支付即积分功能的服务商身份调用




技术咨询

文档反馈