创建停车入场

更新时间：2024.10.22

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

接口说明

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

请求方式：【POST】/v3/vehicle/parking/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)

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

out_parking_no 　必填 string(64)

【商户入场id】商户侧入场标识id，在同一个商户号下唯一

plate_number 　必填 string(32)

【车牌号】车牌号，仅包括省份+车牌，不包括特殊字符。

plate_color 　必填 string

【车牌颜色】车牌颜色

可选取值：

BLUE: 蓝色

GREEN: 绿色

YELLOW: 黄色

BLACK: 黑色

WHITE: 白色

LIMEGREEN: 黄绿色

notify_url 　必填 string(256)

【回调通知url】接受入场状态变更回调通知的url，注意回调url只接受https

start_time 　必填 string(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秒。

parking_name 　必填 string(128)

【停车场名称】所在停车位车场的名称

free_duration 　必填 integer

【免费时长】停车场的免费停车时长，单位为秒

请求示例

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/vehicle/parking/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    "out_parking_no" : "1231243",
9    "plate_number" : "粤B888888",
10    "plate_color" : "BLUE",
11    "notify_url" : "https://yoursite.com/wxpay.html",
12    "start_time" : "2017-08-26T10:43:39+08:00",
13    "parking_name" : "欢乐海岸停车场",
14    "free_duration" : 3600
15  }'
16

应答参数

200 OK

id 　必填 string(32)

【停车入场id】车主服务为商户分配的入场id

out_parking_no 　必填 string(64)

【商户入场id】商户侧入场标识id，在同一个商户号下唯一

plate_number 　必填 string(32)

【车牌号】车牌号，仅包括省份+车牌，不包括特殊字符。

plate_color 　必填 string

【车牌颜色】车牌颜色

可选取值：

BLUE: 蓝色

GREEN: 绿色

YELLOW: 黄色

BLACK: 黑色

WHITE: 白色

LIMEGREEN: 黄绿色

start_time 　必填 string(32)

【入场时间】入场时间，按照使用rfc3339所定义的格式，格式为YYYY-MM-DDThh:mm:ss+TIMEZONE

parking_name 　必填 string(128)

【停车场名称】所在停车位车场的名称

free_duration 　必填 integer

【免费时长】停车场的免费停车时长，单位为秒

state 　必填 string(32)

【停车入场状态】本次入场车牌的服务状态，
NORMAL:正常状态，可以使用微信支付分停车服务，
BLOCKED 不可用状态，暂时不可以使用微信支付分停车服务

block_reason 　选填 string(32)

【不可用状态描述】block服务状态描述，返回车牌状态为BLOCKED，会返回该字段，描述具体BLOCKED的原因，
PAUSE：已暂停微信支付分停车服务；
OVERDUE：已授权签约但欠费，不能提供服务,
OUT_SERVICE : 车牌未开通微信支付分停车服务，
EVALUATION_FAILED 综合评估未通过，用户支付分不可用的情况，会返回该状态。

应答示例

200 OK

1{
2  "id" : "5K8264ILTKCH16CQ250",
3  "out_parking_no" : "212434321",
4  "plate_number" : "粤B888888",
5  "plate_color" : "BLUE",
6  "start_time" : "2017-08-26T10:43:39+08:00",
7  "parking_name" : "欢乐海岸停车场",
8  "free_duration" : 3600,
9  "state" : "NORMAL",
10  "block_reason" : "PAUSE"
11}
12

错误码

公共错误码

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

业务错误码

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

文档是否有帮助

更多支持

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