查询订单价格(泊链)
数据返回时的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"} | 否 |
- 上一篇:预付订单通知(泊链) 2022/3/16
- 下一篇:下行接口(SDK回调收费系统) 2022/3/16