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获取车道屏幕二维码
2.44离线订单(先走后付)
2.45月卡、储值、内部车的车类别上传
三、下行接口(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固定收费
3.44月卡、储值、内部车的车类别下行接口
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
2025年11月26日 16:55
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码