SDK停车收费系统对接协议(车场管理+支付)
停车收费系统对接协议(车场管理+支付)
更新记录
SDK开发包下载
一、系统集成
1.1
1.2车场初始化
1.2.1加密说明
1.2反初始化
1.3http退出登录接口
二、上行接口(收费系统调用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车场交易订单查询(返回h5url)
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.37ETC扣款
2.38逃单查询
2.39停车场停车业务纠正
2.40在停业务总数查询
2.41在停业务详情查询
2.42市级车入场判定
2.43获取车道屏幕二维码
离线订单(先走后付)
三、下行接口(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.27内部车同步(停车云)
3.28手动结算(停车云)
3.29积分电子券信息同步(泊链)
3.31车道监控抓拍下发(停车云)
3.32通知上传收费系统日志(泊链)
3.26查询车场停车位(停车云)
3.33收费系统升级(泊链)
3.34公众号购买月卡查询价格(停车云)
3.35车场有效期下发(停车云)
3.36充电桩充电通知(泊链)
3.37逃单补缴异步返回结果
3.39车辆包月账单信息查询
3.39修改道闸余位
3.40查询月卡车、特殊车
3.41通道识别健康码状态下发
3.42手动入场
3.43车牌校正
3.43固定收费
4.1获取当前车牌余额及是否支持电子支付
4.2获取当前车牌余额及是否支持无感支付(http)
5.1数据定义
5.1.1车型:car_type
5.1.2
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
7.2初始化连接智慧屏
7.3推送出场订单
7.4接收被扫数据(SDK回调收费系统)
7.5车场生成出口支付码
7.6推送语音播报
7.7推送进场订单
SUMMARY
文档云
-
+
首页
3.1查询订单价格(泊链)
**数据返回时的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"} |否
admin
2025年2月26日 17:52
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码