商户进件
特约商户进件
基础支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
支付即服务
点金计划
行业方案
平台收付通(商户进件)
平台收付通(普通支付)
平台收付通(合单支付)
平台收付通(分账)
平台收付通(补差)
平台收付通(退款)
平台收付通(余额查询)
平台收付通(商户提现)
平台收付通(注销申请)
平台收付通(注销后提现)
平台收付通(跨境付款)
平台收付通(下载账单)
智慧商圈
微信支付分停车服务
电子发票
营销工具
代金券
商家券
委托营销
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
分账
连锁品牌分账
风险合规
商户开户意愿确认
消费者投诉2.0
商户违规通知回调
其他能力
图片上传
视频上传
微信支付平台证书

商圈会员停车状态同步

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


通过此API,商圈商户/服务商可将会员的停车状态同步给微信支付,以辅助判断用户到场,用户在商圈内门店消费可自动积商圈会员积分。

注意:

商户上送敏感信息时使用微信支付平台公钥加密,证书序列号包含在请求HTTP头部的Wechatpay-Serial,详见接口规则


接入顺序

1. “商圈会员快速积分”小程序插件开发文档

2. 商圈会员积分服务授权结果通知(用户在商圈小程序完成会员积分服务授权后,会将用户的授权情况发送至开通时配置的会员积分服务开通回调地址)

3. 商圈会员场内支付结果通知(已授权商圈会员积分服务的用户,在场内发生微信支付交易时,会将消费信息发送至开通时配置的的用户消费回调地址)

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

5. 商圈会员场内退款通知(对已同步过积分的会员消费,监控30天内的退款情况,若发生退款,会将退款信息发送至开通时配置的的用户消费回调地址)

6. 商圈会员积分服务授权状态查询 (可通过此api查询已授权过商圈会员积分服务用户的最新授权状态)

7. 商圈会员待积分状态查询(可通过此api查询已授权商圈会员积分服务的用户当天是否有待积分的消费,并可在商圈小程序任意页面引导用户前往“商圈会员快速积分”插件提交积分申请)

8. 商圈会员停车状态同步(可通过此api同步会员停车到场状态给微信支付,对用会员的商场内门店消费可100%自动积分)


接口说明

适用对象:服务商

请求URL:https://api.mch.weixin.qq.com/v3/businesscircle/parkings

请求方式:post


path指该参数为路径参数

query指该参数需在请求URL传参

body指该参数需在请求JSON传参

请求参数

参数名 变量 类型[长度限制] 必填 描述
子商户号 sub_mchid string[1,32] body微信支付分配的子商户号,服务商模式下必传
示例值:1900000109
品牌ID brandid int body调用方商户号对应的品牌brandid,调用方商户号需为此品牌brandid的品牌主商户号或品牌服务商商户号
示例值:1000
应用ID appid string[1,32] body支持服务号、小程序等类型的AppID,需已与brandid完成下单AppID绑定
示例值:wx931386123456789e
用户标识 openid string[1,64] body用户在商户对应AppID下的唯一标识
示例值:oUpF8uMuAJOM2pxb1Q
车牌号 plate_number string[1,32] body首位需为省份的中文简称,第二位起支持大写字母、数字、中文
示例值:粤B888888
状态 state string body停车状态,服务商模式下必传
IN:入场,用户开车进入商圈
OUT:离场,用户开车离开商圈
示例值:IN
时间 time string[1,32] body在场状态更新时间,按照使用rfc3339所定义的格式,格式为yyyy-MM-DDThh:mm:ss+TIMEZONE
示例值:2022-06-01T10:43:39+08:00

请求示例

{
  "appid": "wx931386123456789e",
  "brandid": 1000,
  "openid": "oUpF8uMuAJOM2pxb1Q",
  "plate_number": "粤B888888",
  "state": "IN",
  "sub_mchid": "1900000109",
  "time": "2022-06-01T10:43:39+08:00"
}

返回参数


处理成功,应答无内容

返回示例


204
处理成功,应答无内容

错误码公共错误码

状态码 错误码 描述 解决方案
400 PARAM_ERROR 业务必填字段brand_id为空 参数有误,品牌ID brandid 为空
PARAM_ERROR 业务必填字段appid为空 参数有误,应用ID appid 为空
PARAM_ERROR 业务必填字段openid为空 参数有误,用户标识 openid 为空
PARAM_ERROR 业务必填字段plate_number为空 参数有误,车牌号 plate_number 为空
PARAM_ERROR 业务必填字段state为空 参数有误,状态 state 为空
PARAM_ERROR 业务必填字段time为空 参数有误,时间 time 为空
PARAM_ERROR plate_number格式有误 参数有误,车牌号 plate_number 格式有误
PARAM_ERROR time格式有误 时间 time 格式有误,请修改后重试
PARAM_ERROR time超出取值范围 时间 time 不能为未来的时间点,请修改后重试
PARAM_ERROR openid有误 用户openid 有误,请修改后重试
PARAM_ERROR appid有误 appid 有误,请修改后重试
PARAM_ERROR sub_mch_code有误 子商户号 sub_mchid 有误,请修改后重试
403 NOAUTH mch_id与brand_id关系不匹配 非brandid品牌主商户号或品牌服务商商户号,请修改后重试
NOAUTH openid与appid不匹配 openid与appid不匹配,非传入appid下的用户openid,请修改后重试
NOAUTH 父子关系不匹配 mchid与sub_mchid无父子关系,请修改后重试
NOAUTH sub_mch_code与brand_id不匹配 传入的sub_mchid非brandid的品牌主商户号,请修改后重试
NOAUTH brandid与appid不匹配 appid未与brandid绑定,请修改后重试
NOAUTH brandid无对应的唯一商圈mainid brandid下商圈不唯一,请修改后重试
500 SYSTEMERROR 系统必填字段source为空 系统错误,请稍后再试
SYSTEMERROR 系统必填字段machine_key为空 系统错误,请稍后再试
SYSTEMERROR 系统必填字段mch_id为空 系统错误,请稍后再试
SYSTEMERROR 保存数据失败 系统错误,请稍后再试
SYSTEMERROR brandid无对应的唯一商圈mainid brandid下商圈不唯一,请修改后重试



技术咨询

文档反馈