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
文档云
-
+
首页
停车收费系统对接协议（车场管理+支付）
:-: **注意：停车系统与泊链平台的对接方式** 停车收费系统与泊链平台的对接方式有两种，SDK对接和HTTP对接模式。采用SDK对接请跳过本小结。下面介绍通过HTTP模式对接泊链的具体方法： 与泊链对接涉及接口有：1.1，1.3， 2.1，2.2，2.18，3.1，3.2，3.3，3.4，**3.12**、4.2.对接HTTP模式时，上述接口将不再通过调用SDK的UploadUtil方法上传数据，而是采用发送HTTP请求的方式将上行的JSON串包，**在http请求header中"Content-Type"设置为"application/json;charset=utf-8"，JSON串数据放置在body中，发送POST请求到泊链服务器。** 组织上行数据时, 根据接口文档要求组织的SDK参数, 设为data, 例如初始化, data为: {"union_id":"200208","park_id":"21835","local_id":"0071cc97102b_1001_qh321_quanhao-atest1"} 然后进行签名, 签名方式为 data数据串+ key=8403A41ED5EF20BC 然后对整串进行md5加密, 得到sign。(注：key是对应厂商的key，此处key仅为示例) 即对 {"union_id":"200208","park_id":"21835","local_id":"0071cc97102b_1001_qh321_quanhao-atest1"}key=8403A41ED5EF20BC 进行md5加密。然后将service_name, sign, token, data组成最终的上行JSON格式数据, 例 {"service_name":"login","sign":"CB649425CB5548A375099103AB04CC1E","data":{"union_id":"200208","park_id":"21835","local_id":"0071cc97102b_1001_qh321_quanhao-atest1"}} 登录时没有token, 故不用添加, 其他接口中, token为必传字段 上行数据的HTTP请求地址： http://ptest.bolink.club/bpd/upload.do (测试平台) http://p.bolink.club/bpd/upload.do (正式平台) 获取泊链下发的下行数据需采用http轮询的方式,当泊链服务器有需要推送给车场的消息时,会获取JSON格式的下行消息。上行和下行的消息格式与上述SDK接口文档中定义的一致。轮询规则：车场发一个http长轮询请求到泊链，泊链会暂时不返回这个请求，等待30秒后返回无消息，如30秒内有消息会及时返回，车场收到http的返回后应及时再次发起一次请求，确保**有且仅有一个http长轮询请求存在，如果发生断开要车场端主动发起新的连接**。 下行数据的HTTP请求地址： http://ptest.bolink.club/bpd/download.do (测试平台) http://p.bolink.club/bpd/download.do (正式平台) 下行接口的请求参数(POST)： | 名称 | 说明 | 类型 | 示例 | 是否必传字段 | | --- | --- | --- | --- | --- | token| 初始化后获取的令牌 |String|6fadf87a5bae43b68a6ae6fc6912f61f |是 返回状态说明： | 名称 | 说明 | 类型 | 示例 | 是否必传字段 | | --- | --- | --- | --- | --- | state| 状态,1成功，0无消息，-1已离线，需要重新初始化 |Number |1 |是 data| 数据 |Json |｛｝ |是 errmsg| 提示信息 |String ||否 **停车收费系统与SDK之间的调用，数据传入和返回都采为json格式，收费系统调用SDK时，java版本提供一个类名为UploadUtil的对象，提供了一些静态方法，包含了初始化和上行接口的所有方法，每个方法中只有一个参数，为json格式的字符串。接口字段中的时间参数为unix时间戳格式是指从1970年1月1日零点起到当前时间的秒数，为长整数。** **接口名称后括号中标明的停车云、泊链 是指收费系统调用接口后，sdk处理后发送数据的方向，如车辆出入场数据，要同时向停车云和泊链传输。电子收费业务需要与泊链进行数据交互才可以完成。**
admin
2023年9月13日 17:50
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档
PDF文档（打印）
分享
链接
类型
密码
更新密码