商圈会员停车状态同步

更新时间：2024.11.27

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

注意：

商户上送敏感信息时需要使用微信支付公钥加密（推荐），请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引，也可以使用微信支付平台证书公钥加密，参考获取平台证书序列号、平台证书加密敏感信息指引

接入顺序

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

接口说明

支持商户：【普通商户】

请求方式：【POST】/v3/businesscircle/parkings

请求域名：【主域名】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(32)

【子商户号】微信支付分配的子商户号，服务商模式下必传

brandid 　必填 integer

【品牌ID】调用方商户号对应的品牌brandid，调用方商户号需为此品牌brandid的品牌主商户号或品牌服务商商户号

appid 　必填 string(32)

【应用ID】支持服务号、小程序等类型的AppID，需已与brandid完成下单AppID绑定

openid 　必填 string(64)

【用户标识】用户在商户对应AppID下的唯一标识

plate_number 　必填 string(32)

【车牌号】首位需为省份的中文简称，第二位起支持大写字母、数字、中文

state 　必填 string

【状态】停车状态，服务商模式下必传

可选取值：

IN: 用户开车进入商圈
OUT: 用户开车离开商圈

time 　必填 string(32)

【时间】在场状态更新时间，按照使用rfc3339所定义的格式，格式为yyyy-MM-DDThh:mm:ss+TIMEZONE

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/businesscircle/parkings \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "sub_mchid" : "1900000109",
8    "brandid" : 1000,
9    "appid" : "wx931386123456789e",
10    "openid" : "oUpF8uMuAJOM2pxb1Q",
11    "plate_number" : "粤B888888",
12    "state" : "IN",
13    "time" : "2022-06-01T10:43:39+08:00"
14  }'
15

应答参数

无应答包体

应答示例

204 No Content

1'无应答包体'
2

错误码

公共错误码

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

业务错误码

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

文档是否有帮助

更多支持

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