**数据返回时的data_target固定为bolink,发送到泊链**
车主在本车场停车,且不是本停车云的会员时,车主操作公众号或app查询订单,泊链下发查询订单金额请求到sdk,sdk回调收费系统查询订单金额,收费系统计算后返回给sdk,收费系统通过sdk的方法UploadUtil.uploadData(String jsonData)将当前订单金额上传到泊链,再通知到车主终端,显示订单金额 。
**注:无牌车扫出场直付码支付成功后,再次扫码泊链下发的价格查询消息pay_scene是1**
**注:有牌车扫出场直付码查询价格,车场本地收费系统根据泊链推送的车场编号、pay_scene支付场景、出口通道号等信息判断并返回相应车场、通道当前需要结算的车辆订单价格信息**(例如:A车开到车场出口通道D3,这时扫出口通道D3的出场直付码,车场根据pay_scene支付场景、出口通道号D3等信息判断返回车辆A的订单价格信息)
字段信息:
| 名称 | 说明 | 类型|最大长度 | 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- | --- |
car_number| 车牌| String| 8 | 京HP00G6 |否,pay_scene为0,2时必传
service_name |接口名称| String|64| query_price| 是
order_id |订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号)| String|48 |10000 |否,pay_scene为0,2时必传;pay_scene为0时,无在场订单会下发order_id为空串
park_id |车场编号 |String| 24| 20003 |是
pay_scene |支付场景,0:场内预付,1:结算待支付,2:无牌车请求结算,默认:0 |Number|2| 0| 是
out_channel_id |出口通道:字母、数字和下划线组成| String|16 |A1 |否,pay_scene为1,2时必传
query_order_no| 查询价格编号:本次收费系统查询价格的编号,返回时,原值返回,在预付通知中返回给收费系统 |String|48 |300022 |否,pay_scene为1,2时必传
licence|无牌车车牌|String|10|AD42F3B|否,车场以出口待结算车辆为准;泊链下发当前扫码车主产生过的无牌车牌号,如当前扫码车主没产生过无牌车牌号,则不下发该字段;当车场本地不存在待结算有牌车订单且存在该无牌车的在场订单的情况下,才使用licence车牌来进行结算
pay_app| 支付APP,枚举值 : 0微信、1支付宝、2农行 | Number | 2 | 0 |否(只有SDK对接的车场且支付通道是农业银行的才能在查询价格的时候下发pay_app 字段)
|pay_user_id|微信openID或者支付宝的BuyerID|String|100| ouc2o01Annba-HFNNfij-3xBXHrEEWEW|否,当车主用微信或者支付宝APP扫码支付时,并且支付通道是微信直连、支付宝直连、乐刷、汇付为必传
> 示例:
> {"query_order_no":"218402018060000000p-863","park_id":"20003","car_number":"62000F9","service_name":"query_price","order_id":"15000001195","pay_scene":0,"licence":"AD42F3B"}
* * * * *
**返回:调用UploadUtil.uploadData(String jsonData)返回上传结果,方法返回描述如下**
| 名称 | 说明 | 类型|最大长度 | 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- | --- |
service_name| 接口名称| String|64 |query_price| 是
data_target| **传输位置,SDK模式必传,HTTP模式不传**| String|8 |bolink |是
state| 状态| Number|2| 0失败1成功| 是
free_out_time| 免费离场时间(分钟)| Number|15| 10 |否(默认显示10分钟)
query_time |查询价格时间 |Number(unix时间戳格式,精确到秒) |15|1490875218 |否
duration |停车时长(分钟)| Number|15 |50 |是
derate_money |减免金额(元) |String|15 |5| 否
derate_duration | 减免时长(分钟) |Number|15| 5 |否
park_id |车场编号| String| 24|20003| 是
order_id |订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号)| String|48 |10000|是
query_order_no |查询价格编号:本次收费系统查询价格的编号,返回时,原值返回,在预付通知中返回给收费系统 |String|48 |300022| 否,查询调用pay_scene为1,2时必传
errmsg |方法返回描述 |String|48 |State=0时不能为空 |否(有值时必传)
price |当前应收金额(元)| String| 15|4.0 |是
total| 订单总金额(元)| String|15 |6.0 |否
position| 停车位置| String| 24|A001 |否
in_time |进场时间,unix时间戳格式,精确到秒| Number|15 |1490875218| 否, pay_scene为0,2时必传;(与car_number同时返回,可以支付未上传的订单)
car_number |车牌| String| 8|京GH0093 |否, pay_scene为0,2时必传;(与in_time同时返回,可以支付未上传的订单)
hide_inpark_info |有了这字段我们就不显示入场时间和停车时长等需要入场信息的字段| Number|2| 1是 0否| 否(pay_scene为1,2时,返回hide_inpark_info值为1,可以隐藏入场时间和停车时长等需要入场信息)
|multiple_prepay | 车场返回价格时加上这个参数,0不支持多次预付,1支持多次预付;默认0。| Number |1 |0不支持,1支持|否|
||||
**discount_info**|**本地积分电子券,以下为discount_info 的字段参数**|json| | | 否,本地有已对接的积分电子券时返回
member_id |会员编号| String| 50 |Adad123123123123123 |是
use_type| 使用方式:1:积分与电子券只能使用其中一种;2:积分与电子券均可使用| Number |1 |1 |否,当积分信息和电子券信息并存时必传
limit_hour| 最大兑换小时| Number| 10 |5 |否
limit_count |电子券最大使用张数 |Number| 10 |5 |否
||||
**member_points_info**| **会员积分信息,以下为member_points_info 的字段参数**| json || | 否
member_points |总积分数| Number| 10| 10000| 是
points_per_hour| 兑换每小时所用积分| Number |10| 100 |是
coupon_list| 电子券列表,以下为具体的字段 |JsonArray| || 否
coupon_id| 电子券id |String| 64| Qwqe1231231231 |是
amount |电子券面额| Number| 30| 10 |是
unit |单位 1-小时 2-元 |Number| 10| 1 |是
expires_time |过期时间| Number(unix时间戳格式,精确到秒) |20| 1564419661 |否
attach | 附加信息,回调时返回 |Json |128 | {"should_pay":"0.08"} |否
||||
**park_info_detail** |**子车场停车详情列表 ,以下为具体的字段** |JsonArray | | | 否
area_name | 子车场名称 | String | 30 | 地库一层 | 是
duration | 子车场停车时长说明 | String | 30 | 1天3小时10分钟 | 是
|isEscape| 是否强缴,0不显示逃单 ,1显示逃单不强缴 ,2显示逃单并强缴,默认传0不显示逃单| Number |1 |0 |否
||||
|is\_report|数据是否上传到上海路政平台,0 不上报,1 上报| Number|2|1|否
|empty\_plot|空闲车位数|Number|12|20|否
> 示例:
>{"service_name":"query_price","data_target":"bolink","errmsg":"我查询成功啦","state":1,"park_id":"21840","order_id":"38320","price":"0.01","duration":1,"query_time":1564538334,"derate_money":"2.00","derate_duration":123,"query_order_no":"2184020190731095912-426","car_number":"","in_time":1561676330,"discount_info":{"member_id":"liu20190729id001","use_type":1,"limit_hour":3,"limit_count":1,"member_points_info":{"member_points":999999666,"points_per_hour":100},"coupon_list":[{"amount":2,"unit":2,"coupon_id":"200002","expires_time":1560000000},{"amount":1,"unit":1,"coupon_id":"100001","expires_time":1564374975}], "park_info_detail":[{"area_name":"地库一层","duration":"1天3小时10分钟"},{"area_name":"地库二层","duration": "3天3小时10分钟"}],"multiple_prepay":1,"attach":{"should_pay":"0.08"},"position":"A2-1层","isEscape":"1"}
### **http方式返回字段信息**
| 名称 | 说明 | 类型|最大长度 | 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- | --- |
service_name| 服务 |String|64 |query_price| 是
token| 令牌| String|64 |b1ce1026cb794d8ca515159b4b5cecea |是
sign| 数据签名| String|64 |50BE7B01F8531AE4346B1170BE8E90DA |是
data| 数据,下列字段组成的json对象| Json| 48|{} |是
state| 状态 | Number|2 |0失败1成功| 是
free_out_time |免费离场时间(分钟)| Number| 15|10 |否(默认显示10分钟)
query_time| 查询价格时间 |Number(unix时间戳格式,精确到秒)|15 |1490875218|否
duration |停车时长(分钟)| Number| 15|50 |是
derate_money| 减免金额(元) |String| 15|5| 否
derate_duration |减免时长(分钟) |Number| 15|5| 否
park_id |车场编号 |String|24 |20003| 是
order_id |订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号) |String| 48|10000| 是
query_order_no |查询价格编号:本次收费系统查询价格的编号,返回时,原值返回,在预付通知中返回给收费系统 |String| 48|300022 |否,查询调用pay_scene为1,2时必传
errmsg |方法返回描述 |String|48 |State=0时不能为空 |否(有值时必传)
price| 应收金额(元)| String|15| 6.0| 是
total| 订单金额(元)| String|15 |6.0| 否
position |停车位置 |String|24 |A001| 否
in_time |进场时间unix时间戳格式,精确到秒| Number|15 |1490875218| 否, pay_scene为0,2时必传;(与car_number同时返回,可以支付未上传的订单)
car_number |车牌| String| 8|京GH0093 |否, pay_scene为0,2时必传;(与in_time同时返回,可以支付未上传的订单)
|multiple_prepay | 车场返回价格时加上这个参数,0不支持多次预付,1支持多次预付;默认0。| Number |1 |0不支持,1支持|否|
attach | 附加信息,回调时返回 |Json |128 | {"should_pay":"0.08"} |否
- 停车收费系统对接协议(车场管理+支付)
- 修订记录
- SDK开发包下载
- 一、系统集成
- 1.1初始化(废弃版本)
- 1.2 车场初始化(SDK 4.2 及后续版本)
- 1.2.1 加密说明
- 1.3反初始化
- 1.4 http退出登录接口
- 二、上行接口(收费系统调用 SDK)
- 2.1 车辆入场(停车云,泊链)
- 2.2车辆出场(泊链,停车云)
- 2.3异常订单记录上传(停车云)
- 2.4车场收费员信息上传(停车云)
- 2.5员工上下班记录上传(停车云)
- 2.6日志上传(停车云)
- 2.8月卡套餐上传(停车云)
- 2.9价格上传(停车云)
- 2.10月卡会员上传(停车云)
- 2.11异常抬杆/落杆上传(停车云)
- 2.12车辆图片上传
- 2.13月卡续费记录上传(停车云)
- 2.14通道数据上传 (停车云)
- 2.15黑名单上传(停车云)
- 2.16车型数据上传(停车云)
- 2.17出场模糊匹配确认事件上传(停车云)
- 2.18获取二维码地址(泊链)
- 2.19车场订单电子支付状态查询接口
- 2.20 查询在场订单(泊链)
- 2.21岗亭交易订单查询(泊链返回h5 url)
- 2.22 岗亭交接班记录(泊链)
- 2.23 云平台对账接口(停车云)
- 2.24 月卡信息查询(停车云)
- 2.25 储值卡上传(停车云)
- 2.26 储值卡充值记录上传(停车云)
- 2.27 储值卡扣除余额上传(停车云)
- 2.28 储值卡余额查询(停车云)
- 2.29 上传优惠券减免接口(停车云)
- 2.30 泊链电子支付对账接口
- 2.31电子发票上传接口
- 2.32 上传收费系统日志
- 2.33 分页查询月卡信息(停车云)
- 2.34 充电减免信息上传(停车云)
- 2.35 内部车上传(停车云)
- 2.36 平台转发接口(停车云)
- 2.37 ETC扣费
- 2.38 逃单查询
- 2.39停车场停车业务纠正
- 2.40在停业务总数查询
- 2.41在停业务详情查询
- 2.42市级车入场判定
- 2.43获取车道屏幕文字
- 2.44离线订单(先走后付)
- 三、下行接口(SDK回调收费系统)
- 3.1查询订单价格(泊链)
- 3.2预付订单通知(泊链)
- 3.3无牌车入场请求(泊链)
- 3.4电子收费异步返回结果(泊链)
- 3.5价格同步(停车云)
- 3.6月卡套餐同步(停车云)
- 3.7月卡会员同步(停车云)
- 3.8车场收费员信息同步(停车云)
- 3.9接收消息实现锁车/解锁(停车云)
- 3.10月卡续费(泊链)
- 3.11 公众号月卡续费查询价格(停车云)
- 3.12优惠券信息同步(停车云)
- 3.13通道数据下发 (停车云)
- 3.14黑名单下发(停车云)
- 3.15车型数据下发(停车云)
- 3.16月卡续费记录下发(停车云)
- 3.17手动匹配订单通知(停车云)
- 3.18 抬杆/落杆通知(停车云)
- 3.19 访客管理下发 (停车云)
- 3.20 储值卡同步(停车云)
- 3.21 储值卡余额变更记录下发(停车云)
- 3.22 云平台透传接口
- 3.23 退款下发通知(泊链)
- 3.24 找零支出下发通知(泊链)
- 3.25 平台缴费通知(停车云)
- 3.26 查询车场停车位通知(停车云)
- 3.27 内部车同步(停车云)
- 3.28 手动结算(停车云)
- 3.29 追缴订单异步返回结果(泊链)
- 3.30 积分电子券信息同步(泊链)
- 3.31 车道监控抓拍下发(停车云)
- 3.32 通知上传收费系统日志(泊链)
- 3.33 下发收费系统升级通知(泊链)
- 3.34 公众号新建月卡查询价格(停车云)
- 3.35 车场有效期下发(停车云)
- 3.36 充电桩充电通知(泊链)
- 3.37 逃单补缴异步返回结果(泊链)
- 3.38 车辆包月账单信息查询
- 3.39 修改道闸余位
- 3.40 查询月卡车、特殊车
- 3.41 门禁读取的健康码状态下发(停车云)
- 3.42 补录订单手动入场
- 3.43 在场订单车牌校正
- 3.44 无在场订单固定收费
- 四、查询免密及电子支付(SDK提供)
- 4.1获取车牌是否支持免密和SDK心跳
- 4.2推送当前车牌余额及是否支持无感支付(http)
- 五、常见问题与数据定义
- 5.1 数据定义
- 5.1.1车型:car_type
- 5.1.2 入场/出场车型:c_type/out_type
- 5.1.3 订单支付类型:pay_type
- 5.1.4锁车标记:islocked
- 5.1.5性别:sex
- 5.1.6操作类型:operate_type
- 5.1.7员工上下班类型:state
- 5.1.8数据上传位置:data_target
- 5.1.9异常抬杆原因:reason
- 5.1.10是否是泊涟会员:is_exist
- 5.1.11网络状态:net_status
- 5.1.12订单支付通道:pay_channel
- 5.2 常见问题答疑
- 六、专题文档
- 七、智慧屏应用
- 7.1 获取智慧屏 ip(收费系统调用SDK)
- 7.2 初始化连接智慧屏(收费系统调用SDK)
- 7.3 推送出场订单(收费系统调用SDK)
- 7.4 接收被扫数据(SDK回调收费系统)
- 7.5 车场生成出口支付码
- 7.6 推送语音播报
- 7.7 推送进场订单