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