适用对象：直连商户
请求URL：https://api.mch.weixin.qq.com/v3/vehicle/parking/parkings
请求方式：POST
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 商户入场id | out_parking_no | string[1, 64] | 是 | body商户侧入场标识id，在同一个商户号下唯一 示例值：1231243 |
| 车牌号 | plate_number | string[1, 32] | 是 | body车牌号，仅包括省份+车牌，不包括特殊字符。 示例值：粤B888888 |
| 车牌颜色 | plate_color | string[1, 32] | 是 | body车牌颜色，枚举值 BLUE：蓝色 GREEN：绿色 YELLOW：黄色 BLACK：黑色 WHITE：白色 LIMEGREEN：黄绿色 示例值：BLUE |
| 回调通知url | notify_url | string[1, 256] | 是 | body接受入场状态变更回调通知的url，注意回调url只接受https 示例值：https://yoursite.com/wxpay.html |
| 入场时间 | start_time | string[1, 32] | 是 | body入场时间，遵循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秒。 示例值：2017-08-26T10:43:39+08:00 |
| 停车场名称 | parking_name | string[1, 32] | 是 | body所在停车位车场的名称 示例值：欢乐海岸停车场 |
| 免费时长 | free_duration | int | 是 | body停车场的免费停车时长，单位为秒 示例值：3600 |
{
"out_parking_no": "1231243",
"plate_number": "粤B888888",
"plate_color": "BLUE",
"notify_url": "https://yoursite.com/wxpay.html",
"start_time": "2017-08-26T10:43:39+08:00",
"parking_name": "欢乐海岸停车场",
"free_duration": 3600
}
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 停车入场id | id | string[1, 32] | 是 | 车主服务为商户分配的入场id 示例值：5K8264ILTKCH16CQ250 |
| 商户入场id | out_parking_no | string[1, 64] | 是 | 商户侧入场标识id，在同一个商户号下唯一 示例值：212434321 |
| 车牌号 | plate_number | string[1, 32] | 是 | 车牌号，仅包括省份+车牌，不包括特殊字符。 示例值：粤B888888 |
| 车牌颜色 | plate_color | string[1, 32] | 是 | 车牌颜色，枚举值： BLUE：蓝色 GREEN：绿色 YELLOW：黄色 BLACK：黑色 WHITE：白色 LIMEGREEN：黄绿色 示例值：BLUE |
| 入场时间 | start_time | string[1, 32] | 是 | 入场时间，遵循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秒。 示例值：2017-08-26T10:43:39+08:00 |
| 停车场名称 | parking_name | string[1, 32] | 是 | 所在停车位车场的名称 示例值：欢乐海岸停车场 |
| 免费时长 | free_duration | int | 是 | 停车场的免费停车时长，单位为秒 示例值：3600 |
| 停车入场状态 | state | string[1, 32] | 是 | 本次入场车牌的服务状态， NORMAL：正常状态，可以使用微信支付分停车服务， BLOCKED：不可用状态，暂时不可以使用微信支付分停车服务 示例值：NORMAL |
| 不可用状态描述 | block_reason | string[1, 32] | 否 | block服务状态描述，返回车牌状态为BLOCKED，会返回该字段，描述具体BLOCKED的原因， PAUSE：已暂停微信支付分停车服务； OVERDUE：已授权签约但欠费，不能提供服务, OUT_SERVICE：车牌未开通微信支付分停车服务， EVALUATION_FAILED：综合评估未通过，用户支付分不可用的情况，会返回该状态。 示例值：PAUSE |
{
"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"
}
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 429 | RATELIMIT_EXCEEDED | 达到调用速率限制 | 接口调用频率过快，请降低请求频率 |
| 400 | PARAM_ERROR | 参数错误 | 参数错误，请依照文档检查各参数是否合法 |
| 400 | INVALID_REQUEST | 商户入场id非法，请检查商户入场id | 商户多次请求，传参的同一个商户入场id，对应了不同的停车入场信息，请保持商户入场id在同一个商户下唯一 |
| 403 | NO_AUTH | 商户未入驻 | 当前扣款商户无权限扣款，请确认当前扣款商户已开通微信支付分停车产品权限。修复商户权限后可原参数重试 |
| 500 | SYSTEM_ERROR | 出现内部服务器错误 | 5开头的错误码均为系统错误，请使用相同的参数稍后重试 |