基础支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
微信支付分(免确认模式)
微信支付分(免确认预授权模式)
微信支付分(需确认模式)
微信支付分(公共API)
支付即服务
行业方案
智慧商圈
微信支付分停车服务
营销工具
代金券
商家券
委托营销
消费卡
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
付款
分账
风险合规
消费者投诉2.0
其他能力
清关报关
图片上传
视频上传

商圈积分同步

最新更新时间:2020.8.3 版本说明


通过此API,商圈商户/服务商可针对微信支付前序推送给商圈系统的顾客商圈内交易通知,告知微信支付系统该笔交易的积分情况

注意:

请按照文档顺序依次进行接入

1. 小程序插件开发文档

2. 商圈支付结果通知(已开通积分功能的用户,在场内发生交易时,会将交易信息返回至开通时提交的回调地址)

3. 商圈积分同步(只有接入该接口,才会获取到退款信息)

4. 商圈退款成功通知(对已同步过积分的交易,监控30天内的退款情况,若发生退款,则会把相关退款通知发送给商圈商户,商户的回调地址同支付结果回调地址保持一致)

接口说明

适用对象:直连商户

请求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
}

{
JAVA示例代码
}

请求示例二(无积分)


{
   "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
}

{
JAVA示例代码
}

返回参数


处理成功,应答无内容

返回示例


204
处理成功,应答无内容
                    

http://2323weixin.qq.com
                    

错误码公共错误码

状态码 错误码 描述 解决方案
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 该订单已超过回传时效 请在收到积分申请后的回传时效内回传积分


技术咨询

文档反馈