最新更新時(shí)間：2022.08.25 版本說明
通過此API，商圈商戶/服務(wù)商可將會(huì)員的停車狀態(tài)同步給微信支付，以輔助判斷用戶到場(chǎng)，用戶在商圈內(nèi)門店消費(fèi)可自動(dòng)積商圈會(huì)員積分。
商戶上送敏感信息時(shí)使用微信支付平臺(tái)公鑰加密，證書序列號(hào)包含在請(qǐng)求HTTP頭部的Wechatpay-Serial，詳見接口規(guī)則
接入順序
1. “商圈會(huì)員快速積分”小程序插件開發(fā)文檔
2. 商圈會(huì)員積分服務(wù)授權(quán)結(jié)果通知（用戶在商圈小程序完成會(huì)員積分服務(wù)授權(quán)后，會(huì)將用戶的授權(quán)情況發(fā)送至開通時(shí)配置的會(huì)員積分服務(wù)開通回調(diào)地址）
3. 商圈會(huì)員場(chǎng)內(nèi)支付結(jié)果通知（已授權(quán)商圈會(huì)員積分服務(wù)的用戶，在場(chǎng)內(nèi)發(fā)生微信支付交易時(shí)，會(huì)將消費(fèi)信息發(fā)送至開通時(shí)配置的的用戶消費(fèi)回調(diào)地址）
4. 商圈會(huì)員積分同步（只有接入該接口，才會(huì)獲取到退款信息）
5. 商圈會(huì)員場(chǎng)內(nèi)退款通知（對(duì)已同步過積分的會(huì)員消費(fèi)，監(jiān)控30天內(nèi)的退款情況，若發(fā)生退款，會(huì)將退款信息發(fā)送至開通時(shí)配置的的用戶消費(fèi)回調(diào)地址）
6. 商圈會(huì)員積分服務(wù)授權(quán)狀態(tài)查詢 （可通過此api查詢已授權(quán)過商圈會(huì)員積分服務(wù)用戶的最新授權(quán)狀態(tài)）
7. 商圈會(huì)員待積分狀態(tài)查詢（可通過此api查詢已授權(quán)商圈會(huì)員積分服務(wù)的用戶當(dāng)天是否有待積分的消費(fèi)，并可在商圈小程序任意頁面引導(dǎo)用戶前往“商圈會(huì)員快速積分”插件提交積分申請(qǐng)）
8. 商圈會(huì)員停車狀態(tài)同步（可通過此api同步會(huì)員停車到場(chǎng)狀態(tài)給微信支付，對(duì)用會(huì)員的商場(chǎng)內(nèi)門店消費(fèi)可100%自動(dòng)積分）
適用對(duì)象：直連商戶
請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/businesscircle/parkings
請(qǐng)求方式：post
path指該參數(shù)為路徑參數(shù)
query指該參數(shù)需在請(qǐng)求URL傳參
body指該參數(shù)需在請(qǐng)求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 品牌ID | brandid | int | 是 | body調(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,32] | 是 | body支持服務(wù)號(hào)、小程序等類型的AppID，需已與brandid完成下單AppID綁定 示例值：wx931386123456789e |
| 用戶標(biāo)識(shí) | openid | string[1,64] | 是 | body用戶在商戶對(duì)應(yīng)AppID下的唯一標(biāo)識(shí) 示例值：oUpF8uMuAJOM2pxb1Q |
| 車牌號(hào) | plate_number | string[1,32] | 是 | body首位需為省份的中文簡稱，第二位起支持大寫字母、數(shù)字、中文 示例值：粵B888888 |
| 狀態(tài) | state | string | 是 | body停車狀態(tài)，服務(wù)商模式下必傳 IN：入場(chǎng)，用戶開車進(jìn)入商圈 OUT：離場(chǎng)，用戶開車離開商圈 示例值：IN |
| 時(shí)間 | time | string[1,32] | 是 | body在場(chǎng)狀態(tài)更新時(shí)間，按照使用rfc3339所定義的格式，格式為yyyy-MM-DDThh:mm:ss+TIMEZONE 示例值：2022-06-01T10:43:39+08:00 |
{
"appid": "wx931386123456789e",
"brandid": 1000,
"openid": "oUpF8uMuAJOM2pxb1Q",
"plate_number": "粵B888888",
"state": "IN",
"time": "2022-06-01T10:43:39+08:00"
}
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 業(yè)務(wù)必填字段brand_id為空 | 參數(shù)有誤，品牌ID brandid 為空 |
| PARAM_ERROR | 業(yè)務(wù)必填字段appid為空 | 參數(shù)有誤，應(yīng)用ID appid 為空 | |
| PARAM_ERROR | 業(yè)務(wù)必填字段openid為空 | 參數(shù)有誤，用戶標(biāo)識(shí) openid 為空 | |
| PARAM_ERROR | 業(yè)務(wù)必填字段plate_number為空 | 參數(shù)有誤，車牌號(hào) plate_number 為空 | |
| PARAM_ERROR | 業(yè)務(wù)必填字段state為空 | 參數(shù)有誤，狀態(tài) state 為空 | |
| PARAM_ERROR | 業(yè)務(wù)必填字段time為空 | 參數(shù)有誤，時(shí)間 time 為空 | |
| PARAM_ERROR | plate_number格式有誤 | 參數(shù)有誤，車牌號(hào) plate_number 格式有誤 | |
| PARAM_ERROR | time格式有誤 | 時(shí)間 time 格式有誤，請(qǐng)修改后重試 | |
| PARAM_ERROR | time超出取值范圍 | 時(shí)間 time 不能為未來的時(shí)間點(diǎn)，請(qǐng)修改后重試 | |
| PARAM_ERROR | openid有誤 | 用戶openid 有誤，請(qǐng)修改后重試 | |
| PARAM_ERROR | appid有誤 | appid 有誤，請(qǐng)修改后重試 | |
| 403 | NOAUTH | mch_id與brand_id關(guān)系不匹配 | 非brandid品牌主商戶號(hào)或品牌服務(wù)商商戶號(hào)，請(qǐng)修改后重試 |
| NOAUTH | openid與appid不匹配 | openid與appid不匹配，非傳入appid下的用戶openid，請(qǐng)修改后重試 | |
| NOAUTH | brandid與appid不匹配 | appid未與brandid綁定，請(qǐng)修改后重試 | |
| NOAUTH | brandid無對(duì)應(yīng)的唯一商圈mainid | brandid下商圈不唯一，請(qǐng)修改后重試 | |
| 500 | SYSTEMERROR | 系統(tǒng)必填字段source為空 | 系統(tǒng)錯(cuò)誤，請(qǐng)稍后再試 |
| SYSTEMERROR | 系統(tǒng)必填字段machine_key為空 | 系統(tǒng)錯(cuò)誤，請(qǐng)稍后再試 | |
| SYSTEMERROR | 系統(tǒng)必填字段mch_id為空 | 系統(tǒng)錯(cuò)誤，請(qǐng)稍后再試 | |
| SYSTEMERROR | 保存數(shù)據(jù)失敗 | 系統(tǒng)錯(cuò)誤，請(qǐng)稍后再試 | |
| SYSTEMERROR | brandid無對(duì)應(yīng)的唯一商圈mainid | brandid下商圈不唯一，請(qǐng)修改后重試 |