商圈会员积分同步

更新时间:2023.08.23

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

注意:

接入顺序

  1. “商圈会员快速积分”小程序插件开发文档 (opens new window)
  2. 商圈会员积分服务授权结果通知 (opens new window)(用户在商圈小程序完成会员积分服务授权后,会将用户的授权情况发送至开通时配置的会员积分服务开通回调地址)
  3. 商圈会员场内支付结果通知 (opens new window)(已授权商圈会员积分服务的用户,在场内发生微信支付交易时,会将消费信息发送至开通时配置的用户消费回调地址)
  4. 商圈会员积分同步 (opens new window)(只有接入该接口,才会获取到退款信息)
  5. 商圈会员场内退款通知 (opens new window)(对已同步过积分的会员消费,监控30天内的退款情况,若发生退款,会将退款信息发送至开通时配置的用户消费回调地址)
  6. 商圈会员积分服务授权状态查询 (opens new window)(可通过此api查询已授权过商圈会员积分服务用户的最新授权状态)
  7. 商圈会员待积分状态查询 (opens new window)(可通过此api查询已授权商圈会员积分服务的用户当天是否有待积分的消费,并可在商圈小程序任意页面引导用户前往“商圈会员快速积分”插件提交积分申请)
  8. 商圈会员停车状态同步 (opens new window)(可通过此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

# 应答参数

无应答包体

应答示例

204 No Content

# 错误码

# 公共错误码

状态码 错误码 描述 解决方案
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是否有效
反馈
咨询
目录