最新更新時間:2020.8.3 版本說明
通過此API,商圈商戶/服務(wù)商可針對微信支付前序推送給商圈系統(tǒng)的顧客商圈內(nèi)交易通知,告知微信支付系統(tǒng)該筆交易的積分情況
請按照文檔順序依次進(jìn)行接入
2. 商圈支付結(jié)果通知(已開通積分功能的用戶,在場內(nèi)發(fā)生交易時,會將交易信息返回至開通時提交的回調(diào)地址)
3. 商圈積分同步(只有接入該接口,才會獲取到退款信息)
4. 商圈退款成功通知(對已同步過積分的交易,監(jiān)控30天內(nèi)的退款情況,若發(fā)生退款,則會把相關(guān)退款通知發(fā)送給商圈商戶,商戶的回調(diào)地址同支付結(jié)果回調(diào)地址保持一致)
適用對象:直連商戶 服務(wù)商
請求URL:https://api.mch.weixin.qq.com/v3/businesscircle/points/notify
請求方式:POST
接口規(guī)則:http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml
path指該參數(shù)為路徑參數(shù)
query指該參數(shù)需在請求URL傳參
body指該參數(shù)需在請求JSON傳參
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
商圈商戶ID | sub_mchid | string[1,64] | 否 | body當(dāng)以服務(wù)商模式管理商圈積分能力時,則要帶上商圈商戶ID,否則留空 示例值:1234567890 |
微信訂單號 | transaction_id | string[1,64] | 是 | body微信支付推送的商圈內(nèi)交易通知里攜帶的微信訂單號 示例值:1217752501201407033233368018 |
小程序appid | appid | string[1,128] | 是 | body顧客授權(quán)積分時使用的小程序的appid 示例值:wx1234567890abcdef |
用戶標(biāo)識 | openid | string[1,64] | 是 | body顧客授權(quán)時使用的小程序上的openid 示例值:oWmnN4xxxxxxxxxxe92NHIGf1xd8 |
是否獲得積分 | earn_points | boolean | 是 | body用于標(biāo)明此單是否獲得積分, true為獲得積分, false為未獲得 示例值:true |
訂單新增積分值 | increased_points | int | 是 | body顧客此筆交易新增的積分值 示例值:100 |
積分更新時間 | points_update_time | string[1,32] | 是 | body為顧客此筆交易成功積分的時間 示例值:2020-05-20T13:29:35.120+08:00 |
未獲得積分的備注信息 | no_points_remarks | string[1,128] | 否 | body當(dāng)未獲得積分時,提供未獲得積分的原因等備注信息 示例值:商品不參與積分活動 |
顧客積分總額 | total_points | int | 否 | body當(dāng)前顧客積分總額 示例值:888888 |
{
"sub_mchid": "1234567890",
"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
}
{
"sub_mchid": "1234567890",
"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": "促銷商品不參與積分活動",
"total_points": 888888
}
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | MCH_NOT_EXISTS | 商圈商戶號錯誤 | 請檢查商圈商戶 |
400 | PARAM_ERROR | 參數(shù)校驗(yàn)錯誤 | 請檢查商圈商戶號,微信訂單號,OPENID是否為空 |
400 | PARAM_ERROR | 未獲得積分時無備注信息 | 請?jiān)陬櫩臀传@得積分時補(bǔ)充備注信息 |
400 | PARAM_ERROR | OPENID參數(shù)錯誤 | 請檢查OPENID是否有效 |
500 | SYSTEM_ERROR | 系統(tǒng)錯誤,請稍后重試 | 請使用相同參數(shù)稍后重新調(diào)用 |
400 | INVALID_REQUEST | 該訂單未提交積分 | 請檢查該訂單是否已成功反饋積分成功 |
400 | INVALID_REQUEST | 該訂單積分已回傳 | 請勿重復(fù)回傳 |
400 | INVALID_REQUEST | 該訂單已超過回傳時效 | 請?jiān)谑盏椒e分申請后的回傳時效內(nèi)回傳積分 |