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