最新更新時間：2022.08.25 版本說明
通過此API，商圈商戶/服務(wù)商可以自行查詢已授權(quán)“商圈會員積分服務(wù)”的會員用戶當(dāng)日在該商圈的待積分狀態(tài)。
? 商戶上送敏感信息時使用微信支付平臺公鑰加密，證書序列號包含在請求HTTP頭部的Wechatpay-Serial，詳見接口規(guī)則
? 商圈已對接完成商圈會員3.0版本，詳見接入文檔
? 商圈小程序已接入「商圈會員快速積分」插件2.4.0及以上版本
接入順序
2. 商圈會員積分服務(wù)授權(quán)結(jié)果通知（用戶在商圈小程序完成會員積分服務(wù)授權(quán)后，會將用戶的授權(quán)情況發(fā)送至開通時配置的會員積分服務(wù)開通回調(diào)地址）
3. 商圈會員場內(nèi)支付結(jié)果通知（已授權(quán)商圈會員積分服務(wù)的用戶，在場內(nèi)發(fā)生微信支付交易時，會將消費信息發(fā)送至開通時配置的的用戶消費回調(diào)地址）
4. 商圈會員積分同步（只有接入該接口，才會獲取到退款信息）
5. 商圈會員場內(nèi)退款通知（對已同步過積分的會員消費，監(jiān)控30天內(nèi)的退款情況，若發(fā)生退款，會將退款信息發(fā)送至開通時配置的的用戶消費回調(diào)地址）
6. 商圈會員積分服務(wù)授權(quán)狀態(tài)查詢 （可通過此api查詢已授權(quán)過商圈會員積分服務(wù)用戶的最新授權(quán)狀態(tài)）
7. 商圈會員待積分狀態(tài)查詢（可通過此api查詢已授權(quán)商圈會員積分服務(wù)的用戶當(dāng)天是否有待積分的消費，并可在商圈小程序任意頁面引導(dǎo)用戶前往“商圈會員快速積分”插件提交積分申請）
8. 商圈會員停車狀態(tài)同步（可通過此api同步會員停車到場狀態(tài)給微信支付，對用會員的商場內(nèi)門店消費可100%自動積分）
適用對象：直連商戶
請求URL：https://api.mch.weixin.qq.com/v3/businesscircle/users/{openid}/points/commit_status
請求方式：get
path指該參數(shù)為路徑參數(shù)
query指該參數(shù)需在請求URL傳參
body指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 品牌ID | brandid | int | 是 | query調(diào)用方商戶號對應(yīng)的品牌brandid，調(diào)用方商戶號需為此品牌brandid的品牌主商戶號或品牌服務(wù)商商戶號 示例值：1000 |
| 應(yīng)用ID | appid | string[1,128] | 是 | query支持服務(wù)號、小程序等類型的AppID，需已與brandid完成下單AppID綁定 示例值：wx931386123456789e |
| 用戶標(biāo)識 | openid | string[1,128] | 是 | path用戶在商戶對應(yīng)AppID下的唯一標(biāo)識 示例值：oUpF8uMuAJOM2pxb1Q |
https://api.mch.weixin.qq.com/v3/businesscircle/users/oUpF8uMuAJOM2pxb1Q/points/commit_status?brandid=1000&appid=wx931386123456789e
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 商圈會員待積分狀態(tài) | points_commit_status | string | 否 | 商圈會員待積分狀態(tài) PENDING：有積分待提交，商圈會員有待提交的積分記錄，可引導(dǎo)會員跳轉(zhuǎn)插件提交積分申請 FINISHED：無積分可提交，商圈會員沒有待提交的積分記錄 示例值：PENDING |
{
"points_commit_status": "PENDING"
}
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 參數(shù)有誤：應(yīng)用ID（appid）為空 | 請傳入appid |
| PARAM_ERROR | 參數(shù)有誤：品牌ID（brandid）為空 | 請傳入brandid | |
| PARAM_ERROR | 參數(shù)有誤：用戶標(biāo)識（openid）為空 | 請傳入openid | |
| PARAM_ERROR | 參數(shù)有誤：用戶標(biāo)識（openid）有誤 | 傳入的openid有誤，請修改后重試 | |
| INVALID_REQUEST | 傳入的openid未對當(dāng)前商圈授權(quán)會員快速積分 | 用戶未對商圈授權(quán)會員積分服務(wù) | |
| 403 | NOAUTH | 填寫的用戶openid與appid不匹配，請傳入正確的appid下的用戶openid | openid與appid不匹配，請修改后重試 |
| NOAUTH | 無權(quán)限，appid未與brandid綁定 | appid未與brandid綁定，請修改后重試 | |
| NOAUTH | 無權(quán)限，brandid下商圈不唯一 | 傳入的品牌id無關(guān)聯(lián)的商圈，請修改后重試 | |
| NOAUTH | 該接口僅支持接入商圈會員的商圈調(diào)用 | 請商圈升級接入商圈會員3.0版本后重試 | |
| 500 | SYSTEMERROR | 系統(tǒng)錯誤，請稍后再試 | 請求的商戶id有誤，請修改后重試 |
| SYSTEMERROR | 系統(tǒng)錯誤，請稍后再試 | 查詢用戶的積分提交狀態(tài)失敗，請稍后重試 | |
| SYSTEMERROR | 系統(tǒng)錯誤，請稍后再試 | 查詢用戶的授權(quán)狀態(tài)失敗，請稍后重試 |