商圈会员积分服务授权查询

更新时间：2024.11.18

通过此API，商圈商户/服务商可自行查询用户的商圈会员积分服务授权状态。

接口频率：150QPS
前置条件：商圈商户/服务商已开通支付即积分产品功能

接口说明

支持商户：【普通服务商】

请求方式：【GET】/v3/businesscircle/user-authorizations/{openid}

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引点击查看

请求参数

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

请设置为application/json

path 路径参数

openid 　必填 string(64)

【顾客OpenID】顾客授权时使用的小程序上的OpenID

query 查询参数

sub_mchid 　选填 string(64)

【商圈商户ID】当以服务商模式管理商圈积分能力时，则要带上商圈商户ID，否则留空

appid 　必填 string(128)

【小程序AppID】顾客授权积分时使用的小程序的AppID

应答示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/businesscircle/user-authorizations/oWmnN4xxxxxxxxxxe92NHIGf1xd8?sub_mchid=1234567890&appid=wx1234567890abcdef \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

openid 　必填 string(64)

【顾客OpenID】顾客授权时使用的小程序上的OpenID

authorize_state 　必填 string

【授权状态】顾客授权商圈积分结果，1."UNAUTHORIZED":未授权，2."AUTHORIZED":已授权，3."DEAUTHORIZED":已取消授权

可选取值：

UNAUTHORIZED: 顾客无授权商圈进行支付即积分的记录

AUTHORIZED: 顾客已授权商圈进行支付即积分的能力

DEAUTHORIZED: 顾客已取消授权商圈进行支付即积分的能力

authorize_time 　选填 string(32)

【授权时间】顾客成功授权商圈积分的时间

deauthorize_time 　选填 string(32)

【取消授权时间】顾客关闭授权商圈积分的时间

应答示例

200 OK

1{
2  "openid" : "oWmnN4xxxxxxxxxxe92NHIGf1xd8",
3  "authorize_state" : "UNAUTHORIZED",
4  "authorize_time" : "2020-05-20T13:29:35+08:00",
5  "deauthorize_time" : "2020-05-20T13:29:35+08:00"
6}
7

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

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

文档是否有帮助

更多支持

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