Java调用接口:UploadUtil.uploadOutParkOrder(String jsonData),调用时,把所有参数按json对象格式组成字符串,作为参数给java方法。
注:车辆出场前,收费系统有电子支付业务需求时,需要先调用sdk提供的查询接口(4.1接口),来查询车主余额和泊链网络状态,收费系统需要根据返回数据来处理下一步的支付方式,接口说明见接口4.1,接口返回中net_status描述了SDK与泊链的网络状态(0不通,1通畅),balance是车主的余额,收费系统根据返回数据来判断车主余额是否充足以及目前到泊链的网络状态是否畅通,**建议当网络状态通畅时,才需要调用此接口,余额充足时,pay_tyep=wallet,当余额不足或没有余额时,可以发起扫码枪支付,这时pay_type=sweepcode,同时auth_code为必传**。出场结算业务可能会重复调用车辆出场接口,直到结算完成。
pay_type=sweepcode、wallet、cash、monthuser 、free时需要调用此接口
pay_type=scancode时无需调用此接口。
**注:单个SDK 上传订单频率必须限制低于每秒10条!**
字段信息:
| 名称 | 说明 | 类型|最大长度 | 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- | --- |
car_number |车牌| String|8| 京GH0093| 是
in_time |进场时间(unix时间戳格式)| Number|15| 1490875218 |是
out_time |出场时间(unix时间戳格式)| Number|15 |1490879218 |是
uid |入场收费员编号| String| 12|880099 |是
duration| 停车时长(分钟) |Number|15| 50|否
pay_type |支付类型 |String|12| cash| 是
auth_code| 授权码,支付类型是sweepcode时必传| String|12| 微信或支付宝支付码 |否
empty_plot| 空闲车位数 |Number|10| 20 |是
total |实时订单金额(不包含已预付、已减免的部分)| String|15 |6.5|是
order_id |订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号)| String|48 |9009| 是
out_channel_id |出场通道| String|16 |A1 |否
in_channel_id |进场通道 |String|16| B1 |否
amount_receivable| 应收金额| String|15| 10.0 |是
electronic_prepay |电子预付| String|15| 2.0 |否
electronic_pay| 电子结算 |String |15|1.0 |否
cash_prepay |现金预付 |String |15|2.0 |否
cash_pay |现金结算| String| 15|2.0| 否
out_uid| 出场收费员编号| String|12 |23456 |是
**车辆出场接口调用后,分为:方法返回结果(同步)和异步返回结果,pay_type为wallet或sweepcode**且state=2**时需要等待异步返回结果来处理业务:调用同步返回结果**:state是sdk收到数据后返回的状态,pay_type为wallet或sweepcode时的支付状态要从异步返回的state判断
* * * * *
车辆出场调用方法后同步返回结果:
| 名称 | 说明 | 类型|最大长度 | 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- | --- |
state |状态 | Number|1| 0失败,1成功| 是|
order_id| 订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号) |String|48 |325101 |是
service_name |接口名称| String|8| outpark |是
trade_no| 交易流水号(pay_type为wallet、scancode、sweepcode必传) |String|48| 2107110315352000 |否
pay_type| 支付类型| String|12|cash,wallet,sweepcode,free,monthuser| 是
errmsg |方法返回描述| String|48| 当net_status为0时:errmsg:“网络不通,请用现金支付!”;当net_status为1时:1.支付方式为wallet:(1).余额充足,发送消息给泊链(准备扣费放行);(2).余额不足,errmsg:”余额不足,请选其他支付方式”;2.支付方式为sweepcode时发送消息到泊链请求支付停车费(准备支付放行)。|是
| car_number | 车牌 | String| 8 | 京GH0093 | 是 |
| out_channel_id | 出场通道 | String| 12 | A1 | 否 |
异步返回见3.4接口
### **http出场字段信息:**
| 名称 | 说明 | 类型|最大长度 | 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- | --- |
service_name |服务| String|8 |固定outpark |是
token |令牌 |String|32 |def684dd3b1f4e37bd7b14a378847b0a |是
sign |数据签名 |String |32| EFB19B2ED7F78541F3AAF00432F696A5 |是
data |数据,下列字段组成的json对象| Json|48| {} |是
car_number |车牌 |String|8 |苏DTTTT9 |是
in_time |进场时间(unix时间戳格式)| Number|15| 1490875218 |是
out_time |出场时间(unix时间戳格式)| Number|15| 1490879218 |是
total |实时订单金额(不包含已预付、已减免的部分)| String|15 |6.5 |是
order_id| 订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号)| String|15| 9009| 是
empty_plot| 空闲车位数| Number|10| 20 |是
pay_type |支付类型| String|12 |cash |是
auth_code| 授权码,支付类型是sweepcode时必传| String|12| 微信或支付宝支付码| 否
{"service_name":"outpark","token":"def684dd3b1f4e37bd7b14a378847b0a","sign":"CB649425CB5548A375099103AB04CC1E",data:{"car_number":"苏DTTTTT","in_time":1510132659,"out_time":1510135875,"total":"0.54","order_id":"A1_2C1510828170","empty_plot":20,"pay_type":"cash","auth_code":""}}
### **http车辆出场调用方法后返回结果**:
| 名称 | 说明 | 类型|最大长度 | 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- | --- |
state |状态 |Number|1 |0失败,1成功 |是
order_id |订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号)| String|48 |325101 |是
service_name |接口名称 |String|8| outpark| 是
pay_type |支付类型| String|12| cash,wallet,sweepcode,free,monthuser| 是
trade_no| 交易流水号(pay_type为wallet、scancode、sweepcode必传) |String|48| 2107110315352000 |否
errmsg |方法返回描述 |String |48|提示信息 |是
{"state":1,"trade_no":"","errmsg":"结算成功","order_id":"A1_2C1510828170","pay_type":"cash","service_name":"outpark"}
- 停车系统与车场SDK接口协议(含http模式)
- 修订记录
- SDK开发包下载
- 一、系统集成
- 1.1初始化
- 1.2反初始化
- 二、上行接口
- 2.1车辆入场
- 2.1.1更新用户余额(http模式)
- 2.2车辆出场电子支付
- 2.3获取二维码地址
- 2.4 车场订单电子支付状态查询接口
- 2.5 查询在场订单
- 2.6 车辆图片上传
- 三、下行接口
- 3.1查询订单价格
- 3.2预付订单通知
- 3.3无牌车入场请求
- 3.4电子收费异步返回结果
- 四、查询免密及电子支付(SDK提供)
- 4.1获取当前车牌余额及是否支持免密及电子支付
- 五、附录
- 5.1 数据定义
- 5.1.1订单支付类型:pay_type
- 5.1.2是否是泊涟会员:is_exist
- 5.1.3网络状态:net_status
- 5.1.4订单支付通道:pay_channel
- 六、常见问题答疑
- 七、专题文档