适用对象： 服务商
请求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
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 顾客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"
}
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 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 | 当前请求服务商非商圈支付即积分服务商 | 请以商圈支付即积分功能的服务商身份调用 |