最新更新時(shí)間：2022.08.24 版本說(shuō)明
通過(guò)此API，商圈商戶/服務(wù)商可自行查詢用戶的商圈會(huì)員積分服務(wù)授權(quán)狀態(tài)。
適用對(duì)象：直連商戶
請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/businesscircle/user-authorizations/{openid}
請(qǐng)求方式：GET
接口頻率：150QPS
前置條件：商圈商戶已開通支付即積分產(chǎn)品功能
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請(qǐng)求JSON傳參
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 小程序appid | appid | string[1, 128] | 是 | query顧客授權(quán)積分時(shí)使用的小程序的appid 示例值：wx1234567890abcdef |
| 顧客openid | openid | string[1, 64] | 是 | path顧客授權(quán)時(shí)使用的小程序上的openid 示例值：oWmnN4xxxxxxxxxxe92NHIGf1xd8 |
https://api.mch.weixin.qq.com/v3/businesscircle/user-authorizations/oWmnN4xxxxxxxxxxe92NHIGf1xd8?appid=wx1234567890abcdef
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 顧客openid | openid | string[1, 64] | 是 | 顧客授權(quán)時(shí)使用的小程序上的openid 示例值：oWmnN4xxxxxxxxxxe92NHIGf1xd8 |
| 授權(quán)狀態(tài) | authorize_state | string[1, 32] | 是 | 顧客授權(quán)商圈積分結(jié)果 UNAUTHORIZED：未授權(quán) AUTHORIZED：已授權(quán) DEAUTHORIZED：已取消授權(quán) 示例值：UNAUTHORIZED |
| 授權(quán)時(shí)間 | authorize_time | string[1, 32] | 否 | 顧客成功授權(quán)商圈積分的時(shí)間,遵循rfc3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss表示時(shí)分秒毫秒，TIMEZONE表示時(shí)區(qū)（+08:00表示東八區(qū)時(shí)間，領(lǐng)先UTC 8小時(shí)，即北京時(shí)間）。例如：2015-05-20T13:29:35+08:00表示北京時(shí)間2015年05月20日13點(diǎn)29分35秒（需要增加所有跟時(shí)間有關(guān)的參數(shù)的描述） 示例值：2020-05-20T13:29:35+08:00 |
| 取消授權(quán)時(shí)間 | deauthorize_time | string[1, 32] | 否 | 顧客關(guān)閉授權(quán)商圈積分的時(shí)間,遵循rfc3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss表示時(shí)分秒毫秒，TIMEZONE表示時(shí)區(qū)（+08:00表示東八區(qū)時(shí)間，領(lǐng)先UTC 8小時(shí)，即北京時(shí)間）。例如：2015-05-20T13:29:35+08:00表示北京時(shí)間2015年05月20日13點(diǎn)29分35秒（需要增加所有跟時(shí)間有關(guān)的參數(shù)的描述） 示例值：2020-05-20T13:29:35+08:00 |
{
"openid": "oWmnN4xxxxxxxxxxe92NHIGf1xd8",
"authorize_state": "AUTHORIZED",
"authorize_time": "2020-05-20T13:29:35+08:00"
}
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 請(qǐng)求參數(shù)中Appid非商圈支付即積分配置的Appid | 請(qǐng)確保Appid為支付即積分配置的Appid |
| 400 | PARAM_ERROR | 請(qǐng)求參數(shù)中Appid和Openid不匹配 | 請(qǐng)使用Appid匹配的Openid調(diào)用 |
| 400 | PARAM_ERROR | 請(qǐng)求參數(shù)中Appid無(wú)效 | 請(qǐng)使用正確的Appid調(diào)用 |
| 400 | PARAM_ERROR | 請(qǐng)求參數(shù)中Openid無(wú)效 | 請(qǐng)使用正確的Openid調(diào)用 |
| 400 | INVALID_REQUEST | 商圈暫未開通支付即積分功能 | 請(qǐng)先開通商圈支付即積分功能 |