最新更新時(shí)間：2020.8.24 版本說明
通過此API，商圈商戶/服務(wù)商可針對(duì)微信支付前序推送給商圈系統(tǒng)的會(huì)員支付結(jié)果通知，告知微信支付系統(tǒng)該筆交易的會(huì)員積分情況。
接入順序
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)，并可在商圈小程序任意頁(yè)面引導(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/points/notify
請(qǐng)求方式：POST
path指該參數(shù)為路徑參數(shù)
query指該參數(shù)需在請(qǐng)求URL傳參
body指該參數(shù)需在請(qǐng)求JSON傳參
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 微信訂單號(hào) | transaction_id | string[1,64] | 是 | body微信支付推送的商圈內(nèi)交易通知里攜帶的微信訂單號(hào) 示例值：1217752501201407033233368018 |
| 小程序appid | appid | string[1,128] | 是 | body顧客授權(quán)積分時(shí)使用的小程序的appid 示例值：wx1234567890abcdef |
| 用戶標(biāo)識(shí) | openid | string[1,64] | 是 | body顧客授權(quán)時(shí)使用的小程序上的openid 示例值：oWmnN4xxxxxxxxxxe92NHIGf1xd8 |
| 是否獲得積分 | earn_points | boolean | 是 | body用于標(biāo)明此單是否獲得積分， true為獲得積分， false為未獲得 示例值：true |
| 訂單新增積分值 | increased_points | int | 是 | body顧客此筆交易新增的積分值 示例值：100 |
| 積分更新時(shí)間 | points_update_time | string[1,32] | 是 | body為顧客此筆交易成功積分的時(shí)間 示例值：2020-05-20T13:29:35.120+08:00 |
| 未獲得積分的備注信息 | no_points_remarks | string[1,128] | 否 | body當(dāng)未獲得積分時(shí)，提供未獲得積分的原因等備注信息 示例值：商品不參與積分活動(dòng) |
| 顧客積分總額 | total_points | int | 否 | body當(dāng)前顧客積分總額 示例值：888888 |
{
"transaction_id": "4200000533202000000000000000",
"appid": "wx8828b70xxxxxxx8",
"openid": "otPAN5xxxxxxxxrOEG6lUv_pzacc",
"earn_points": true,
"increased_points": 100,
"points_update_time": "2020-05-20T13:29:35.120+08:00",
"total_points": 888888
}
{
"transaction_id": "4200000533202000000000000000",
"appid": "wx8828b70xxxxxxx8",
"openid": "otPAN5xxxxxxxxrOEG6lUv_pzacc",
"earn_points": false,
"increased_points": 0,
"points_update_time": "2020-05-20T13:29:35.120+08:00",
"no_points_remarks": "促銷商品不參與積分活動(dòng)",
"total_points": 888888
}
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | MCH_NOT_EXISTS | 商圈商戶號(hào)錯(cuò)誤 | 請(qǐng)檢查商圈商戶號(hào)準(zhǔn)確性 |
| 400 | PARAM_ERROR | 參數(shù)校驗(yàn)錯(cuò)誤 | 請(qǐng)檢查商圈商戶號(hào)，微信訂單號(hào)，OPENID是否為空 |
| 400 | PARAM_ERROR | 未獲得積分時(shí)無備注信息 | 請(qǐng)?jiān)陬櫩臀传@得積分時(shí)補(bǔ)充備注信息 |
| 400 | PARAM_ERROR | OPENID參數(shù)錯(cuò)誤 | 請(qǐng)檢查OPENID是否有效 |
| 500 | SYSTEM_ERROR | 系統(tǒng)錯(cuò)誤，請(qǐng)稍后重試 | 請(qǐng)使用相同參數(shù)稍后重新調(diào)用 |
| 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)） |