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.12优惠券信息同步(停车云)
> **应用场景**: > 车场合作商家将优惠券发放给车主,车主扫描优惠券二维码关联订单后,优惠券的信息同步到车场收费系统。 字段信息: | 名称 | 说明 | 类型 | 最大长度 | 示例 | 是否必传字段 | | --- | --- | --- | --- | --- | --- | service_name | 接口名称 | String|64 |deliver_ticket | 是 ticket_id | 优惠券编号 | String| 15|10022 | 是 create_time| 新建时间(unix 时间戳格式) |Number|15| 1490879218 | 否 limit_day| 失效日期(unix 时间戳格式)| Number| 15|1490879218 | 是 money| 优惠券金额 | String|15 |5 | 否(ticket_type 为 0 时必传) duration | 优惠券时长 | Number| 15|5 | 否(ticket_type 为 1 时必传) car_number | 车牌 | String| 8| 京 GH0093| 是 ticket_unit| 时长劵单位:1 表示分钟,2 表示小时,3 表示天 | Number|4| 1| 否(ticket_type 为 1 时必传) discount| 折扣券额度 |String|64 |7| 是 ticket_type | 减免类型:0 表示减免停车金额,1 表示减免停车时长,2 全免劵,3 折扣券,4 外部优惠券,5 指定截止时间的全免券 | 4|0 | 是, ticket_type 为 4 时,ticket_id 字段携带扫描外部券获取的优惠券信息,本地需确认返回该值 order_id | 订单编号 |String|48| 9880 | 是,have_order 为 0 时,下发 order_id 为空字符串 remark | 备注 | String|32 | 两小时内免 3 元 | 否 shop_name| 商户名称 |String|24|1 号商店 | 是 time_range| 如果一张全免券或固定码发出的优惠券支持多次使用,该字段为这张券可以减免的有效时长。此时有值。其它时候为 0(当 ticket_type 为 5 时,该字段为时间戳,精确到秒)|int|12|0,单位为小时 | 是 have_order| 云平台是否有在场订单 |Number|1 |1 表示云平台有该车牌的在场订单;0 表示没有,本地根据该字段进行业务处理;该字段原值返回。have_order 值为 0 时 ,与 car_number 同时返回,可减免未上传的订单,否则记录用券信息失败。(have_order 值为 0 时,与 intime、order_id、car_number 同时返回,可限制用券的张数(与有在场订单的用券数一致))| 是 |park_id | 车场编号 | String|24 |test001| 是 fix_code_name| 固定码名称 | String|24 | 测试 1 固定码 | 否,使用固定码时下发 starttime| 券可用开始时间 |String|15|00:00| 否,使用固定码时下发 endtime| 券可用结束时间 |String|15|23:59| 否,使用固定码时下发 startdate| 券可用开始日期(unix 时间戳格式)|Number|15|23:59| 否,使用固定码时下发 enddate| 券可用结束日期(unix 时间戳格式)|Number|15|23:59| 否,使用固定码时下发 active_start_time| 券生效开始时间 |String|15|00:00| 否,使用固定码时下发,由本地收费系统判断 active_end_time| 券生效结束时间 |String|15|23:59| 否,使用固定码时下发,由本地收费系统判断 buy_money| 车主买券支付金额(元)|String|15|1 | 否,使用固定码且设置车主支付的优惠券下发时必传 pay_limit| 支付公司限制 |Number|15|0,不限制;1,农行 APP | 否,使用固定码时下发(使用该功能时车场需开通农行支付通道,计费系统对此类优惠券做相应的减免) shop_id| 商户编号 |Number|24|234| 是 > 示例: > {"ticket_type":2,"create_time":1575687031,"limit_day":1575687331,"fix_code_name":"测试 1 固定码","service_name":"deliver_ticket","have_order":1,"park_id":"12345","discount":"","endtime":"23:59","remark":"","starttime":"00:00","ticket_id":"26105715","shop_name":"不回收折扣券","startdate":1575686996,"active_end_time":"23:59","duration":0,"enddate":1575773396,"money":"","time_range":0,"car_number":"京 123124","active_start_time":"00:00","order_id":"A1_2C1575686500","shop_id":234} --- **返回:调用 UploadUtil.uploadData(String jsonData)返回上传结果,方法返回描述如下** | 名称 | 说明 | 类型 | 最大长度 | 示例 | 是否必传字段 | | --- | --- | --- | --- | --- | --- | service_name | 接口名称 |String|64| deliver_ticket| 是 data_target| 传输位置 |String|8| cloud| 是 ticket_id| 优惠券编号 | String|15| 10022| 是 order_id | 订单编号 | String |48|9880 | 否,have_order=1 时必传; have_order=0 时,与 intime、car_number 同时返回,可限制用券的张数(与有在场订单的用券数一致)| | state| 状态 | Number|2| 0 失败 1 成功 | 是 errmsg | 方法返回描述 | String|48| State=0 时不能为空 | 否(有值时必传) time_range| 如果一张全免券支持多次使用,该字段为这张全免券可以减免的有效时长。此时有值。其它时候为 0|int|12|0| 是 ticket_type | 减免类型:0 表示减免停车金额,1 表示减免停车时长,2 全免劵,3 折扣券,4 外部优惠券(为 4 时必传)| Number| 4|0 | 否 have_order| 云平台是否有在场订单 |number|1 | 1 表示云平台有该车牌的在场订单;0 表示没有 | 否,下发的 have_order 值为 0 时,与 car_number 同时返回,可减免未上传的订单 car_number | 车牌 | String| 8| 京 GH0093| 否,下发的 have_order 值为 0 时,与 have_order 同时返回,可减免未上传的订单 intime | 进场时间 unix 时间戳格式 | Number|15 |1490875218| 否, 下发的 have_order 值为 0 时,与 order_id、car_number 同时返回,可限制用券的张数(与有在场订单的用券数一致)| --- ### **http 方式返回字段信息** | 名称 | 说明 | 类型 | 最大长度 | 示例 | 是否必传字段 | | --- | --- | --- | --- | --- | --- | service_name| 服务 |String|64 |deliver_ticket| 是 token| 令牌 | String|64 |b1ce1026cb794d8ca515159b4b5cecea | 是 sign| 数据签名 | String|64 |50BE7B01F8531AE4346B1170BE8E90DA | 是 data| 数据,下列字段组成的 json 对象 | Json| 48|{} | 是 **data_target**| **传输位置**|String|8| **cloud**|**是** ticket_id| 优惠券编号 | String|15| 10022| 是 order_id | 订单编号 | String |48|9880 | 是,**订单号为空时无法限制叠加张数** state| 状态 | Number|2| 0 失败 1 成功 | 是 errmsg | 方法返回描述 | String|48| State=0 时不能为空 | 否(有值时必传) time_range| 如果一张全免券支持多次使用,该字段为这张全免券可以减免的有效时长。此时有值。其它时候为 0|int|12|0| 是 have_order| 云平台是否有在场订单 |number|1 | 1 表示云平台有该车牌的在场订单;0 表示没有 | 否,下发的 have_order 值为 0 时,与 car_number 同时返回,可减免未上传的订单 car_number | 车牌 | String| 8| 京 GH0000| 否,下发的 have_order 值为 0 时,与 have_order 同时返回,可减免未上传的订单 > 示例: > {"service_name":"deliver_ticket","have_order":0,"car_number":"京 GH0000","errmsg":"已减免!!","data_target":"cloud","state":1,"ticket_id":"17561669","order_id":"a_12345670981"}
admin
2023年9月14日 10:02
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码