泊链会员车主在本车场停车时,又不是本停车云的会员时,车主操作公众号或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|12 |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|1 |0 |是
out_channel_id |出口通道:字母、数字和下划线组成 |String|16 |A1 |否,pay_scene为1,2时必传
query_order_no| 查询价格编号:本次收费系统查询价格的编号,返回时,原值返回,在预付通知中返回给收费系统 |String|16| 300022 |否,pay_scene为1,2时必传
licence|无牌车车牌|String|10|AD42F3B|否,车场以出口待结算车辆为准;泊链下发当前扫码车主产生过的无牌车牌号,如当前扫码车主没产生过无牌车牌号,则不下发该字段;当车场本地不存在待结算有牌车订单且存在该无牌车的在场订单的情况下,才使用licence车牌来进行结算
|pay_user_id|微信openID或者支付宝的BuyerID|String|100| ouc2o01Annba-HFNNfij-3xBXHrEEWEW|否,当车主用微信或者支付宝APP扫码支付时,并且支付通道是微信直连、支付宝直连、乐刷、汇付为必传
* * * * *
**返回:调用UploadUtil.uploadData(String jsonData)返回上传结果,方法返回描述如下**
| 名称 | 说明 | 类型 | 最大长度|示例 | 是否必传字段 |
| --- | --- | --- | --- | --- | --- |
service_name| 接口名称 |String|12| query_price| 是
data_target| **传输位置,SDK模式必传,HTTP模式不传** |String|6| bolink| 是
state| 状态| Number|1| 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| 是(与car_number同时返回,可以支付未上传的订单)
car_number |车牌| String| 8|京GH0093 |是(与in_time同时返回,可以支付未上传的订单)
hide_inpark_info |有了这字段我们就不显示入场时间和停车时长等需要入场信息的字段| Number|1| 1是 0否| 否(pay_scene为1,2时,返回hide_inpark_info值为1,可以隐藏入场时间和停车时长等需要入场信息)
|multiple_prepay | 车场返回价格时加上这个参数,0不支持多次预付,1支持多次预付;默认0。| Number |1 |0不支持,1支持|否|
### **http方式返回字段信息**
| 名称 | 说明 | 类型|最大长度 | 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- | --- |
service_name |服务 |String|12| query_price| 是
token |令牌 |String |32|b1ce1026cb794d8ca515159b4b5cecea |是
sign |数据签名 |String|32 |50BE7B01F8531AE4346B1170BE8E90DA |是
data |数据,下列字段组成的json对象 |Json|48| {} |是
state| 状态| Number|1| 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 |否
|multiple_prepay | 车场返回价格时加上这个参数,0不支持多次预付,1支持多次预付;默认0。| Number |1 |0不支持,1支持|否|
- 停车系统与车场SDK接口协议(含http模式)
- 修订记录
- SDK开发包下载
- 一、系统集成
- 1.1初始化
- 1.2反初始化
- 二、上行接口
- 2.1车辆入场
- 2.1.1更新用户余额(http模式)
- 2.2车辆出场电子支付
- 2.3获取二维码地址
- 2.4 车场订单电子支付状态查询接口
- 2.5 查询在场订单
- 2.6 车辆图片上传
- 三、下行接口
- 3.1查询订单价格
- 3.2预付订单通知
- 3.3无牌车入场请求
- 3.4电子收费异步返回结果
- 四、查询免密及电子支付(SDK提供)
- 4.1获取当前车牌余额及是否支持免密及电子支付
- 五、附录
- 5.1 数据定义
- 5.1.1订单支付类型:pay_type
- 5.1.2是否是泊涟会员:is_exist
- 5.1.3网络状态:net_status
- 5.1.4订单支付通道:pay_channel
- 六、常见问题答疑
- 七、专题文档