通過此API,商圈商戶/服務(wù)商可針對(duì)微信支付前序推送給商圈系統(tǒng)的會(huì)員支付結(jié)果通知,告知微信支付系統(tǒng)該筆交易的會(huì)員積分情況。
**注意:**
接入順序
- “商圈會(huì)員快速積分”小程序插件開發(fā)文檔 (opens new window)
- 商圈會(huì)員積分服務(wù)授權(quán)結(jié)果通知 (opens new window)(用戶在商圈小程序完成會(huì)員積分服務(wù)授權(quán)后,會(huì)將用戶的授權(quán)情況發(fā)送至開通時(shí)配置的會(huì)員積分服務(wù)開通回調(diào)地址)
- 商圈會(huì)員場(chǎng)內(nèi)支付結(jié)果通知 (opens new window)(已授權(quán)商圈會(huì)員積分服務(wù)的用戶,在場(chǎng)內(nèi)發(fā)生微信支付交易時(shí),會(huì)將消費(fèi)信息發(fā)送至開通時(shí)配置的用戶消費(fèi)回調(diào)地址)
- 商圈會(huì)員積分同步 (opens new window)(只有接入該接口,才會(huì)獲取到退款信息)
- 商圈會(huì)員場(chǎng)內(nèi)退款通知 (opens new window)(對(duì)已同步過積分的會(huì)員消費(fèi),監(jiān)控30天內(nèi)的退款情況,若發(fā)生退款,會(huì)將退款信息發(fā)送至開通時(shí)配置的用戶消費(fèi)回調(diào)地址)
- 商圈會(huì)員積分服務(wù)授權(quán)狀態(tài)查詢 (opens new window)(可通過此api查詢已授權(quán)過商圈會(huì)員積分服務(wù)用戶的最新授權(quán)狀態(tài))
- 商圈會(huì)員待積分狀態(tài)查詢 (opens new window)(可通過此api查詢已授權(quán)商圈會(huì)員積分服務(wù)的用戶當(dāng)天是否有待積分的消費(fèi),并可在商圈小程序任意頁面引導(dǎo)用戶前往“商圈會(huì)員快速積分”插件提交積分申請(qǐng))
- 商圈會(huì)員停車狀態(tài)同步 (opens new window)(可通過此api同步會(huì)員停車到場(chǎng)狀態(tài)給微信支付,對(duì)用會(huì)員的商場(chǎng)內(nèi)門店消費(fèi)可100%自動(dòng)積分)
# 接口說明
支持商戶:
【普通商戶】
請(qǐng)求方式:
【POST】/v3/businesscircle/points/notify
請(qǐng)求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點(diǎn)【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點(diǎn) ,指引點(diǎn)擊查看
# 請(qǐng)求參數(shù)
- Authorization 必填 string請(qǐng)參考 簽名認(rèn)證 生成認(rèn)證信息
- Accept 必填 string請(qǐng)?jiān)O(shè)置為
application/json
- Content-Type 必填 string請(qǐng)?jiān)O(shè)置為
application/json
Header HTTP頭參數(shù)
- sub_mchid 選填 string(64)【商圈商戶ID】 當(dāng)以服務(wù)商模式管理商圈積分能力時(shí),則要帶上商圈商戶ID,否則留空
- transaction_id 必填 string(64)【微信訂單號(hào)】 微信支付推送的商圈內(nèi)交易通知里攜帶的微信訂單號(hào)
- appid 必填 string(128)【小程序AppID】 顧客授權(quán)積分時(shí)使用的小程序的AppID
- openid 必填 string(64)【顧客OpenID】 顧客授權(quán)時(shí)使用的小程序上的OpenID
- earn_points 必填 boolean【是否獲得積分】 用于標(biāo)明此單是否獲得積分,true為獲得積分,false為未獲得
- increased_points 必填 integer【訂單新增積分值】 顧客此筆交易新增的積分值
- points_update_time 必填 string(32)【積分更新時(shí)間】 為顧客此筆交易成功積分的時(shí)間
- no_points_remarks 選填 string(128)【未獲得積分的備注信息】 當(dāng)未獲得積分時(shí),提供未獲得積分的原因等備注信息
- total_points 選填 integer【顧客積分總額】 當(dāng)前顧客積分總額
Body 包體參數(shù)
請(qǐng)求示例
POST
# 應(yīng)答參數(shù)
無應(yīng)答包體
應(yīng)答示例
204 No Content
# 錯(cuò)誤碼
# 公共錯(cuò)誤碼
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)根據(jù)錯(cuò)誤提示正確傳入?yún)?shù) |
400 | INVALID_REQUEST | HTTP 請(qǐng)求不符合微信支付 APIv3 接口規(guī)則 | 請(qǐng)參閱 接口規(guī)則 |
401 | SIGN_ERROR | 驗(yàn)證不通過 | 請(qǐng)參閱 簽名常見問題 |
500 | SYSTEM_ERROR | 系統(tǒng)異常,請(qǐng)稍后重試 | 請(qǐng)稍后重試 |
# 業(yè)務(wù)錯(cuò)誤碼
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | INVALID_REQUEST | 該訂單未提交積分 | 請(qǐng)檢查該訂單是否已成功反饋積分成功 |
400 | INVALID_REQUEST | 該訂單積分已回傳 | 請(qǐng)勿重復(fù)回傳 |
400 | INVALID_REQUEST | 該訂單已超過回傳時(shí)效 | 請(qǐng)?jiān)谑盏椒e分申請(qǐng)后的回傳時(shí)效內(nèi)回傳積分(支付結(jié)果通知給商圈的當(dāng)天內(nèi)) |
400 | MCH_NOT_EXISTS | 商圈商戶號(hào)錯(cuò)誤 | 請(qǐng)檢查商圈商戶號(hào)準(zhǔn)確性 |
400 | PARAM_ERROR | 未獲得積分時(shí)無備注信息 | 請(qǐng)?jiān)陬櫩臀传@得積分時(shí)補(bǔ)充備注信息 |
400 | PARAM_ERROR | OpenID參數(shù)錯(cuò)誤 | 請(qǐng)檢查OpenID是否有效 |