---
url: "https://pay.weixin.qq.com/doc/v3/partner/4012474127.md"
title: "商圈会员停车状态同步"
doc_id: 4012474127
---

>更新时间：2024.11.28

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

**注意：**

商户上送敏感信息时需要使用微信支付公钥加密（推荐），请参考 [获取微信支付公钥ID说明](https://pay.weixin.qq.com/doc/v3/partner/4013038589.md#Q%3A-%E5%A6%82%E4%BD%95%E8%8E%B7%E5%8F%96%E5%BE%AE%E4%BF%A1%E6%94%AF%E4%BB%98%E5%85%AC%E9%92%A5ID%3F) 以及 [微信支付公钥加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059044.md)，也可以使用微信支付平台证书公钥加密，参考 [获取平台证书序列号](https://pay.weixin.qq.com/doc/v3/partner/4013059181.md)、 [平台证书加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059053.md)

**接入顺序**

1. [“商圈会员快速积分”小程序插件开发文档](https://mp.weixin.qq.com/wxopen/plugindevdoc?appid=wxfab2bf944bfc4da6&token=1213946737&lang=zh_CN)

2. [商圈会员积分服务授权结果通知](https://pay.weixin.qq.com/doc/v3/partner/4012076406.md)（用户在商圈小程序完成会员积分服务授权后，会将用户的授权情况发送至开通时配置的会员积分服务开通回调地址）

3. [商圈会员场内支付结果通知](https://pay.weixin.qq.com/doc/v3/partner/4012076414.md)（已授权商圈会员积分服务的用户，在场内发生微信支付交易时，会将消费信息发送至开通时配置的的用户消费回调地址）

4. [商圈会员积分同步](https://pay.weixin.qq.com/doc/v3/partner/4012474133.md)（只有接入该接口，才会获取到退款信息）

5. [商圈会员场内退款通知](https://pay.weixin.qq.com/doc/v3/partner/4012076419.md)（对已同步过积分的会员消费，监控30天内的退款情况，若发生退款，会将退款信息发送至开通时配置的的用户消费回调地址）

6. [商圈会员积分服务授权状态查询](https://pay.weixin.qq.com/doc/v3/partner/4012474135.md)（可通过此api查询已授权过商圈会员积分服务用户的最新授权状态）

7. [商圈会员待积分状态查询](https://pay.weixin.qq.com/doc/v3/partner/4012474129.md)（可通过此api查询已授权商圈会员积分服务的用户当天是否有待积分的消费，并可在商圈小程序任意页面引导用户前往“商圈会员快速积分”插件提交积分申请）

8. [商圈会员停车状态同步](https://pay.weixin.qq.com/doc/v3/partner/4012474127.md)（可通过此api同步会员停车到场状态给微信支付，对用会员的商场内门店消费可100%自动积分）





## 接口说明

支持商户：【普通服务商】

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

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

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引[点击查看](https://pay.weixin.qq.com/doc/v3/partner/4012082567.md)

## 请求参数

### Header 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| Authorization | string | true | 请参考 [签名认证](https://pay.weixin.qq.com/doc/v3/partner/4012365870.md#%E8%AF%B7%E6%B1%82%E6%8E%A5%E5%8F%A3%E5%90%8E%E7%AB%AF%E7%AD%BE%E5%90%8D) 生成认证信息 |
| Accept | string | true | 请设置为 `application/json` |
| Content-Type | string | true | 请设置为 `application/json` |
### Body 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| sub_mchid | string(32) | false | **【子商户号】** 微信支付分配的子商户号，服务商模式下必传 |
| brandid | integer | true | **【品牌ID】** 调用方商户号对应的品牌brandid，调用方商户号需为此品牌brandid的品牌主商户号或品牌服务商商户号 |
| appid | string(32) | true | **【应用ID】** 支持服务号、小程序等类型的AppID，需已与brandid完成下单AppID绑定 |
| openid | string(64) | true | **【用户标识】** 用户在商户对应AppID下的唯一标识 |
| plate_number | string(32) | true | **【车牌号】** 首位需为省份的中文简称，第二位起支持大写字母、数字、中文 |
| state | string | true | **【状态】** 停车状态，服务商模式下必传<br>可选取值：<br><ul><li>`IN`: 用户开车进入商圈</li></ul><br><ul><li>`OUT`: 用户开车离开商圈</li></ul> |
| time | string(32) | true | **【时间】** 在场状态更新时间，按照使用rfc3339所定义的格式，格式为yyyy-MM-DDThh:mm:ss+TIMEZONE |
## 应答参数

无应答包体
## 错误码

### 公共错误码

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | PARAM\_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
| 400 | INVALID\_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 [接口规则](https://pay.weixin.qq.com/doc/v3/partner/4012081726.md) |
| 401 | SIGN\_ERROR | 验证不通过 | 请参阅 [签名常见问题](https://pay.weixin.qq.com/doc/v3/partner/4012082324.md) |
| 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 有误，请修改后重试 |
| 400 | PARAM\_ERROR | sub\_mch\_code有误 | 子商户号 sub\_mchid 有误，请修改后重试 |
| 403 | NO\_AUTH | mch\_id与brand\_id关系不匹配 | 非brandid品牌主商户号或品牌服务商商户号，请修改后重试 |
| 403 | NO\_AUTH | OpenID与AppID不匹配 | OpenID与AppID不匹配，非传入AppID下的用户OpenID，请修改后重试 |
| 403 | NO\_AUTH | 父子关系不匹配 | mchid与sub\_mchid无父子关系，请修改后重试 |
| 403 | NO\_AUTH | brandid与AppID不匹配 | AppID未与brandid绑定，请修改后重试 |
| 403 | NO\_AUTH | brandid无对应的唯一商圈mainid | brandid下商圈不唯一，请修改后重试 |
| 403 | NO\_AUTH | sub\_mch\_code与brand\_id不匹配 | 传入的sub\_mchid非brandid的品牌主商户号，请修改后重试 |
| 500 | SYSTEM\_ERROR | 系统必填字段source为空 | 系统错误，请稍后再试 |
| 500 | SYSTEM\_ERROR | 系统必填字段machine\_key为空 | 系统错误，请稍后再试 |
| 500 | SYSTEM\_ERROR | 系统必填字段mch\_id为空 | 系统错误，请稍后再试 |
| 500 | SYSTEM\_ERROR | 保存数据失败 | 系统错误，请稍后再试 |
| 500 | SYSTEM\_ERROR | brandid无对应的唯一商圈mainid | brandid下商圈不唯一，请修改后重试 |

请求示例

- [curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4012474127-curl.md)
- [Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4012474127-java.md)
- [Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4012474127-go.md)


应答示例

> 204 No Content

```
'无应答包体'

```
