最新更新时间:2020.8.24 版本说明
通过此API,商圈商户/服务商可针对微信支付前序推送给商圈系统的会员支付结果通知,告知微信支付系统该笔交易的会员积分情况。
接入顺序
2. 商圈会员积分服务授权结果通知(用户在商圈小程序完成会员积分服务授权后,会将用户的授权情况发送至开通时配置的会员积分服务开通回调地址)
3. 商圈会员场内支付结果通知(已授权商圈会员积分服务的用户,在场内发生微信支付交易时,会将消费信息发送至开通时配置的用户消费回调地址)
4. 商圈会员积分同步(只有接入该接口,才会获取到退款信息)
5. 商圈会员场内退款通知(对已同步过积分的会员消费,监控30天内的退款情况,若发生退款,会将退款信息发送至开通时配置的用户消费回调地址)
6. 商圈会员积分服务授权状态查询 (可通过此api查询已授权过商圈会员积分服务用户的最新授权状态)
7. 商圈会员待积分状态查询(可通过此api查询已授权商圈会员积分服务的用户当天是否有待积分的消费,并可在商圈小程序任意页面引导用户前往“商圈会员快速积分”插件提交积分申请)
8. 商圈会员停车状态同步(可通过此api同步会员停车到场状态给微信支付,对用会员的商场内门店消费可100%自动积分)
适用对象:直连商户
请求URL:https://api.mch.weixin.qq.com/v3/businesscircle/points/notify
请求方式:POST
path指该参数为路径参数
query指该参数需在请求URL传参
body指该参数需在请求JSON传参
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
微信订单号 | transaction_id | string[1,64] | 是 | body微信支付推送的商圈内交易通知里携带的微信订单号 示例值:1217752501201407033233368018 |
小程序appid | appid | string[1,128] | 是 | body顾客授权积分时使用的小程序的appid 示例值:wx1234567890abcdef |
用户标识 | openid | string[1,64] | 是 | body顾客授权时使用的小程序上的openid 示例值:oWmnN4xxxxxxxxxxe92NHIGf1xd8 |
是否获得积分 | earn_points | boolean | 是 | body用于标明此单是否获得积分, 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当未获得积分时,提供未获得积分的原因等备注信息 示例值:商品不参与积分活动 |
顾客积分总额 | total_points | int | 否 | body当前顾客积分总额 示例值: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": "促销商品不参与积分活动",
"total_points": 888888
}
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | MCH_NOT_EXISTS | 商圈商户号错误 | 请检查商圈商户号准确性 |
400 | PARAM_ERROR | 参数校验错误 | 请检查商圈商户号,微信订单号,OPENID是否为空 |
400 | PARAM_ERROR | 未获得积分时无备注信息 | 请在顾客未获得积分时补充备注信息 |
400 | PARAM_ERROR | OPENID参数错误 | 请检查OPENID是否有效 |
500 | SYSTEM_ERROR | 系统错误,请稍后重试 | 请使用相同参数稍后重新调用 |
400 | INVALID_REQUEST | 该订单未提交积分 | 请检查该订单是否已成功反馈积分成功 |
400 | INVALID_REQUEST | 该订单积分已回传 | 请勿重复回传 |
400 | INVALID_REQUEST | 该订单已超过回传时效 | 请在收到积分申请后的回传时效内回传积分(支付结果通知给商圈的当天内) |