基础支付
JSAPI支付
APP支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
微信支付分(免确认预授权模式)
微信支付分(需确认模式)
微信支付分(公共API)
支付即服务
行业方案
智慧商圈
微信支付分停车服务
营销工具
代金券
商家券
委托营销
消费卡
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
付款
分账
风险合规
消费者投诉2.0
其他能力
清关报关
图片上传
视频上传

创建停车入场API

最新更新时间:2021.08.06 版本说明


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

接口说明

适用对象:直连商户

请求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
}

{
JAVA示例代码
}

返回参数

参数名 变量 类型[长度限制] 必填 描述
停车入场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"
}
                    

http://2323weixin.qq.com
                    

错误码公共错误码

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


技术咨询

文档反馈