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
文档云
-
+
首页
1.2车场初始化
> ## SDK 4.2 及后续版本支持车场软件**上行接口**加密传输; > > ## 初始化及下行接口无需加密 --- ## **1、车场调用 http 请求到云平台获取公钥** > 如果本地软件未升级、不支持加密传输,可忽略该操作,直接初始化即可正常使用 请求地址::http://yun.bolink.club/zld/sdkSecurity/getPublicKey 调用方式:POST 请求参数: | 字段名称 | 说明 | 类型 | 示例 | 是否必传字段 | | --- | --- | --- | --- | --- | union_id | 厂商编号 | Number |200002 | 是 park_id | 车场编号 | String| 21787 | 是 同步返回内容: | 字段名称 | 说明 | 类型 | 示例 | 是否必传字段 | | --- | --- | --- | --- | --- | state | 状态 |Number |0 失败 1 成功 | 是 msg| 方法返回描述 | String| 获取成功 | 是 | public_key| 车场公钥 |String| MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCSz+Uw1Z0EYzDekusCk+FzhOd9gvuy/+LG9e/mn7bDkztYa2abs4N6dE6XzZjsa6T/nNF4VC865/8RqO+BSB2F7wNbG0QzVmcVpk51kYCoiZzsgdUJ+HGLyadAyWcMOb6zRQqxXeu7M10nizkQbXfLIPZN02QEIzCJXMQuew | 是 > 注: > 车场获取到公钥后,明文初始化,云端返给 SDK 私钥保存;本地软件用公钥加密上行消息上传给 SDK(文档 1.2.1),SDK 用私钥解密后上传到云平台;每个车场的公钥和私钥这对组合是固定的 --- ## **2、车场初始化** > 车场 SDK 与停车收费系统集成时,收费系统调用 SDK 提供的初始化方法,初始化一些身份信息。 > Java 版本的调用方法名为 UploadUtil.init(String jsonData),调用时,把所有参数按 json 对象格式组成字符串,作为参数给 java 方法。 字段信息: | 名称 | 说明 | 类型 | 最大长度 | 示例 | 是否必传字段 | | --- | --- | --- | --- | --- | --- | | union_id | 厂商平台账号 | String|15 | 200002 | 是 | | ukey | 厂商平台密钥 | String|24 | EA2D90FEEF1E9F8E | 是 | | park_id | 车场编号 | String|24 | 3251 | 是 | | cloud_addr | 停车云域名 | String|18 | 测试环境:ts.bolink.club;正式环境:1029.parkingos.club | 是 | |cport | 停车云端口 | Number |10 | 测试环境:6791;正式环境 6789 | 是 | | local_id | 收费系统编号,同一车场的收费系统编号不可重复,车场存在多个收费系统集成 sdk 时,必传,车场 sdk 初始化参数中的 local_id,可以按规则包含通道信息,用关键字 channels 后加下划线加通道号(通道号可由数字、字母、中文组成),多个时用下划线分隔,结尾不要加下划线,如 local_id=mac001,需要绑定 A1、A2、A3 三个通道,那就写为 local_id=aaa001_channels_A1_A2_A3,那么这个 sdk 就管理了三个通道:A1,A2,A3。在泊链后台生成入场或出场二维码,输入的通道号在这个 sdk 管理中,车主扫带该通道号二维码时,泊链会把入场或出场消息发给这个 sdk(在线),如果 sdk 不在线,则不发送。 | String|196 | 22AA | 否 | log_show| sdk 是否打印日志 | number| 2|0 不打印日志,1 打印,默认 0| 否 set_params| 设置参数,扩展参数,见下表说明 | json|48 |{"prepay_send":"1"} | 否 扩展参数 | 名称 | 说明 | 类型 | 最大长度 | 示例 | 是否必传 | | --- | --- | --- | --- | --- | --- | | prepay_send | 接收预付消息,0 不收,1 接收 | String |2 | 1 | 否 | | month_send | 接收公众号月卡续费消息,0 不收,1 接收 | String|2 | 1 | 否 | |receive_cloud| 接收云平台下行消息,0 不收,默认 1 接收 |string|2|1| 否 | prepay_query | 是否接收预付查询,0 不接收预付查询 ,其他设置不生效 | number | 2 | 0 | 否 | fast | 是否同步返回,设置 true 后上行接口除了 2.1 和 2.2 之外都是同步返回,不再异步,默认是 false | bool | | true | 否 |autoconnect | 断网是否重连,默认 1 自动重连。 0 代表不自动,1 代表自动;4.2 及以后版本有效 | number | | 1 | 否 > jsonData 数据示例 > {"union_id":"200002","ukey":"EA2D90FEEF1E9F8E","park_id":"3251","cloud_addr":"ts.bolink.club","cport":6791,local_id”:"aaa001_channels_A1_A2_A3","set_params":{"prepay_send":"1","month_send":"1","receive_cloud":"1"}} --- 车场初始化同步返回: | 名称 | 说明 | 类型 | 最大长度 | 示例 | 是否必传 | | --- | --- | --- | --- | --- | --- | | state | 状态 | Number | 2|0 失败 1 成功 | 是 | | errmsg | 方法返回描述 | String|48 | Init success! | 是 | 示例:{"state":1,"errmsg":"Init success! "} ---
admin
2023年9月14日 09:29
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码