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.1
> 车场SDK与停车收费系统集成时,收费系统调用SDK提供的初始化方法,初始化一些身份信息。 > Java版本的调用方法名为UploadUtil.init(String jsonData),调用时,把所有参数按json对象格式组成字符串,作为参数给java方法。 字段信息: | 名称 | 说明 | 类型 |最大长度 | 示例 | 是否必传字段 | | --- | --- | --- | --- | --- | --- | | union_id | 厂商编号 | String|15 | 200002 | 是 | | ukey | 厂商平台密钥,泊链接口签名用 | String|24 | EA2D90FEEF1E9F8E | 是 | | park_id | 车场编号 | String|24 | 3251 | 是 | | ckey | 互联车场密钥,停车云接口签名用,每个车场**ckey唯一** | String|24 | WERRTTTTYY | 是 | | cloud_addr | 停车云域名 | String|18 | 测试环境:ts.bolink.club;正式环境:1029.parkingos.club | 是 | |cport | 停车云端口 | Number |10 | 测试环境:6791 ; 正式环境6789 | 是 | | bolink_addr | 泊链服务器域名 | String|18 | 测试环境:beta.bolink.club;正式环境:s.bolink.club | 是 | | bport |泊链端口 | Number | 10|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 | 否 > jsonData数据示例 > {"union_id":"200002","ukey":"EA2D90FEEF1E9F8E","park_id":"3251","ckey": "9H3YD5U5T73GITSP","cloud_addr":"ts.bolink.club","cport":6791,"bolink_addr": "beta.bolink.club","bport":6789,”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 bolink and cloud success! | 是 | 示例{"state":1,"errmsg":"Init bolink and cloud success! "} ### **http对接字段信息:** | 名称 | 说明 | 类型|最大长度| 示例 | 是否必传 | | --- | --- | --- | --- | --- |--- | service_name |接口名称 |String|64 |“login” |是 sign |签名串 |String|64 |63ECB6FF63605A4092ADCA5EF796F580 |是 data |数据,下列字段组成的json对象 |Json|48 |{} |是 union_id |厂商平台账号| String|15 |200208 |是 park_id |车场编号| String| 24|21835| 是 local_id |收费系统编号,同一车场的收费系统编号不可重复,车场存在多个收费系统集成http时,必传,车场http初始化参数中的local_id,可以按规则包含通道信息,用关键字channels后加下划线加通道号,多个时用下划线分隔,结尾不要加下划线,如local_id=mac001,需要绑定A1、A2、A3三个通道,那就写为local_id=aaa001_channels_A1_A2_A3,那么这个http就管理了三个通道:A1,A2,A3。在泊链后台生成入场或出场二维码,输入的通道号在这个http管理中,车主扫带该通道号二维码时,泊链会把入场或出场消息发给这个http(在线),如果http不在线,则不发送。| String|196 |22AA| 否 如需支持公有云平台业务,初始化时需包含以下扩展参数 **扩展参数** | 名称 | 说明 | 类型|最大长度| 示例 | 是否必传 | | --- | --- | --- | --- | --- | --- | | login_cloud|是否支持云平台业务,0不支持,1支持 | String|2 | 1 | 否 | |receive_cloud|接收云平台下行消息,0不收,默认1接收|string|2|1|否 > 示例 {"service_name":"login","sign":"8C69577DD5567560210FD7D38A1AF160","data":{"union_id":"200000","park_id":"20000","local_id":"gg1_hhhhchannels_D1_D2","set_params":{"receive_cloud":"1","login_cloud":"1"}}} ### **http车场初始化返回:** | 名称 | 说明 | 类型|最大长度| 示例 | 是否必传 | | --- | --- | --- | --- | --- | --- | state| 状态 | Number| 2|0失败1成功 |是 token |令牌 |String|64 |969652cbb1a146c1a3ab26bdda3c3d3d |否(state为1时必传) service_name |接口名称 |String|64 |“login” |是 channel_id| 通道号 |String|16 |200208_21835_0071cc97102b_1001_qh321_GUYUE车场-atest1 |否 errmsg| 错误信息| String|48 |“登录成功” |否 示例 {"state":1,"token":"98a16a30df1e4ce488e1b1fcd7ac46c3","channel_id":"200000_20000_gg1_hhhhchannels_D1_D2","service_name":"login"}
admin
2024年12月23日 16:40
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码