商圈会员积分同步

更新时间：2024.09.20

通过此API，商圈商户/服务商可针对微信支付前序推送给商圈系统的会员支付结果通知，告知微信支付系统该笔交易的会员积分情况。

注意：

接入顺序

“商圈会员快速积分”小程序插件开发文档
商圈会员积分服务授权结果通知（用户在商圈小程序完成会员积分服务授权后，会将用户的授权情况发送至开通时配置的会员积分服务开通回调地址）
商圈会员场内支付结果通知（已授权商圈会员积分服务的用户，在场内发生微信支付交易时，会将消费信息发送至开通时配置的用户消费回调地址）
商圈会员积分同步（只有接入该接口，才会获取到退款信息）
商圈会员场内退款通知（对已同步过积分的会员消费，监控30天内的退款情况，若发生退款，会将退款信息发送至开通时配置的用户消费回调地址）
商圈会员积分服务授权状态查询（可通过此api查询已授权过商圈会员积分服务用户的最新授权状态）
商圈会员待积分状态查询（可通过此api查询已授权商圈会员积分服务的用户当天是否有待积分的消费，并可在商圈小程序任意页面引导用户前往“商圈会员快速积分”插件提交积分申请）
商圈会员停车状态同步（可通过此api同步会员停车到场状态给微信支付，对用会员的商场内门店消费可100%自动积分）

接口说明

支持商户：【普通商户】

请求方式：【POST】/v3/businesscircle/points/notify

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引点击查看

请求参数

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

请设置为application/json

Content-Type 　必填　string

请设置为application/json

body 包体参数

sub_mchid 　选填 string(64)

【商圈商户ID】当以服务商模式管理商圈积分能力时，则要带上商圈商户ID，否则留空

transaction_id 　必填 string(64)

【微信订单号】微信支付推送的商圈内交易通知里携带的微信订单号

appid 　必填 string(128)

【小程序AppID】顾客授权积分时使用的小程序的AppID

openid 　必填 string(64)

【顾客OpenID】顾客授权时使用的小程序上的OpenID

earn_points 　必填 boolean

【是否获得积分】用于标明此单是否获得积分，true为获得积分，false为未获得

increased_points 　必填 integer

【订单新增积分值】顾客此笔交易新增的积分值

points_update_time 　必填 string(32)

【积分更新时间】为顾客此笔交易成功积分的时间

no_points_remarks 　选填 string(128)

【未获得积分的备注信息】当未获得积分时，提供未获得积分的原因等备注信息

total_points 　选填 integer

【顾客积分总额】当前顾客积分总额

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/businesscircle/points/notify \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "sub_mchid" : "1234567890",
8    "transaction_id" : "1217752501201407033233368018",
9    "appid" : "wx1234567890abcdef",
10    "openid" : "oWmnN4xxxxxxxxxxe92NHIGf1xd8",
11    "earn_points" : true,
12    "increased_points" : 100,
13    "points_update_time" : "2020-05-20T13:29:35.120+08:00",
14    "no_points_remarks" : "商品不参与积分活动",
15    "total_points" : 888888
16  }'
17

应答参数

无应答包体

应答示例

204 No Content

1'无应答包体'
2

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	该订单未提交积分	请检查该订单是否已成功反馈积分成功
400	INVALID_REQUEST	该订单积分已回传	请勿重复回传
400	INVALID_REQUEST	该订单已超过回传时效	请在收到积分申请后的回传时效内回传积分（支付结果通知给商圈的当天内）
400	MCH_NOT_EXISTS	商圈商户号错误	请检查商圈商户号准确性
400	PARAM_ERROR	未获得积分时无备注信息	请在顾客未获得积分时补充备注信息
400	PARAM_ERROR	OpenID参数错误	请检查OpenID是否有效

文档是否有帮助

更多支持

开发文档(服务商)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服