最新更新時(shí)間:2022.08.25 版本說(shuō)明
通過(guò)此API,商圈商戶/服務(wù)商可將會(huì)員的停車狀態(tài)同步給微信支付,以輔助判斷用戶到場(chǎng),用戶在商圈內(nèi)門店消費(fèi)可自動(dòng)積商圈會(huì)員積分。
商戶上送敏感信息時(shí)使用微信支付平臺(tái)公鑰加密,證書序列號(hào)包含在請(qǐng)求HTTP頭部的Wechatpay-Serial,詳見(jiàn)接口規(guī)則
接入順序
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/parkings
請(qǐng)求方式:post
path指該參數(shù)為路徑參數(shù)
query指該參數(shù)需在請(qǐng)求URL傳參
body指該參數(shù)需在請(qǐng)求JSON傳參
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
子商戶號(hào) | sub_mchid | string[1,32] | 否 | body微信支付分配的子商戶號(hào),服務(wù)商模式下必傳 示例值:1900000109 |
品牌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首位需為省份的中文簡(jiǎn)稱,第二位起支持大寫字母、數(shù)字、中文 示例值:粵B888888 |
狀態(tài) | state | string | 是 | body停車狀態(tài),服務(wù)商模式下必傳 IN:入場(chǎng),用戶開(kāi)車進(jìn)入商圈 OUT:離場(chǎng),用戶開(kāi)車離開(kāi)商圈 示例值: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",
"sub_mchid": "1900000109",
"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 不能為未來(lái)的時(shí)間點(diǎn),請(qǐng)修改后重試 | |
PARAM_ERROR | openid有誤 | 用戶openid 有誤,請(qǐng)修改后重試 | |
PARAM_ERROR | appid有誤 | appid 有誤,請(qǐng)修改后重試 | |
PARAM_ERROR | sub_mch_code有誤 | 子商戶號(hào) sub_mchid 有誤,請(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 | 父子關(guān)系不匹配 | mchid與sub_mchid無(wú)父子關(guān)系,請(qǐng)修改后重試 | |
NOAUTH | sub_mch_code與brand_id不匹配 | 傳入的sub_mchid非brandid的品牌主商戶號(hào),請(qǐng)修改后重試 | |
NOAUTH | brandid與appid不匹配 | appid未與brandid綁定,請(qǐng)修改后重試 | |
NOAUTH | brandid無(wú)對(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無(wú)對(duì)應(yīng)的唯一商圈mainid | brandid下商圈不唯一,請(qǐng)修改后重試 |