---
url: "https://pay.weixin.qq.com/doc/v3/partner/4012533994.md"
title: "创建停车入场"
doc_id: 4012533994
---

>更新时间：2025.02.21

车辆入场以后，商户调用该接口，创建停车入场信息。




## 接口说明

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

请求方式：【POST】 `/v3/vehicle/parking/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) | true | 【子商户号】 微信支付分配的子商户号，服务商模式下必传 |
| out_parking_no | string(64) | true | 【商户入场ID】商户侧入场标识ID，在同一个商户号下唯一 |
| plate_number | string(32) | true | 【车牌号】车牌号，仅包括省份+车牌，不包括特殊字符。 |
| plate_color | string | true | 【车牌颜色】车牌颜色<br>可选取值：<br><ul><li>`BLUE`: 蓝色</li></ul><br><ul><li>`GREEN`: 绿色</li></ul><br><ul><li>`YELLOW`: 黄色</li></ul><br><ul><li>`BLACK`: 黑色</li></ul><br><ul><li>`WHITE`: 白色</li></ul><br><ul><li>`LIMEGREEN`: 黄绿色</li></ul> |
| notify_url | string(256) | true | 【回调通知URL】接受入场状态变更回调通知的URL，注意回调URL只接受HTTPS |
| start_time | string(32) | true | 【入场时间】入场时间，遵循 [rfc3339](https://datatracker.ietf.org/doc/html/rfc3339) 标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日 13点29分35秒。 |
| parking_name | string(128) | true | 【停车场名称】所在停车位车场的名称 |
| free_duration | integer | true | 【免费时长】停车场的免费停车时长，单位为秒 |
## 应答参数

200 OK

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| id | string(32) | true | 【停车入场ID】车主服务为商户分配的入场ID |
| out_parking_no | string(64) | true | 【商户入场ID】商户侧入场标识ID，在同一个商户号下唯一 |
| plate_number | string(32) | true | 【车牌号】车牌号，仅包括省份+车牌，不包括特殊字符。 |
| plate_color | string | true | 【车牌颜色】车牌颜色<br>可选取值：<br><ul><li>`BLUE`: 蓝色</li></ul><br><ul><li>`GREEN`: 绿色</li></ul><br><ul><li>`YELLOW`: 黄色</li></ul><br><ul><li>`BLACK`: 黑色</li></ul><br><ul><li>`WHITE`: 白色</li></ul><br><ul><li>`LIMEGREEN`: 黄绿色</li></ul> |
| start_time | string(32) | true | 【入场时间】入场时间，按照使用rfc3339所定义的格式，格式为YYYY-MM-DDThh:mm:ss+TIMEZONE |
| parking_name | string(128) | true | 【停车场名称】所在停车位车场的名称 |
| free_duration | integer | true | 【免费时长】停车场的免费停车时长，单位为秒 |
| state | string(32) | true | 【停车入场状态】本次入场车牌的服务状态，<br>NORMAL:正常状态，可以使用微信支付分停车服务，<br>BLOCKED 不可用状态，暂时不可以使用微信支付分停车服务 |
| block_reason | string(32) | false | 【不可用状态描述】block服务状态描述，返回车牌状态为BLOCKED，会返回该字段，描述具体BLOCKED的原因，<br>PAUSE：已暂停微信支付分停车服务；<br>OVERDUE：已授权签约但欠费，不能提供服务,<br>OUT\_SERVICE : 车牌未开通微信支付分停车服务，<br>EVALUATION\_FAILED 综合评估未通过，用户支付分不可用的情况，会返回该状态。 |
## 错误码

### 公共错误码

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 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 | INVALID\_REQUEST | 商户入场ID非法，请检查商户入场ID | 商户多次请求，传参的同一个商户入场ID，对应了不同的停车入场信息，请保持商户入场ID在同一个商户下唯一 |
| 403 | NO\_AUTH | 商户未入驻 | 当前扣款商户无权限扣款，请确认当前扣款商户已开通微信支付分停车产品权限。修复商户权限后可原参数重试 |
| 429 | RATELIMIT\_EXCEEDED | 达到调用速率限制 | 接口调用频率过快，请降低请求频率 |
| 500 | SYSTEM\_ERROR | 出现内部服务器错误 | 5开头的错误码均为系统错误，请使用相同的参数稍后重试 |

请求示例

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


应答示例

> 200 OK

```
{
  "id" : "5K8264ILTKCH16CQ250",
  "out_parking_no" : "212434321",
  "plate_number" : "粤B888888",
  "plate_color" : "BLUE",
  "start_time" : "2017-08-26T10:43:39+08:00",
  "parking_name" : "欢乐海岸停车场",
  "free_duration" : 3600,
  "state" : "NORMAL",
  "block_reason" : "PAUSE"
}

```
