**數據返回時的data_target固定為bolink,發送到泊鏈**
車主在本車場停車,且不是本停車云的會員時,車主操作公眾號或app查詢訂單,泊鏈下發查詢訂單金額請求到sdk,sdk回調收費系統查詢訂單金額,收費系統計算后返回給sdk,收費系統通過sdk的方法UploadUtil.uploadData(String jsonData)將當前訂單金額上傳到泊鏈,再通知到車主終端,顯示訂單金額 。
**注:無牌車掃出場直付碼支付成功后,再次掃碼泊鏈下發的價格查詢消息pay_scene是1**
**注:有牌車掃出場直付碼查詢價格,車場本地收費系統根據泊鏈推送的車場編號、pay_scene支付場景、出口通道號等信息判斷并返回相應車場、通道當前需要結算的車輛訂單價格信息**(例如:A車開到車場出口通道D3,這時掃出口通道D3的出場直付碼,車場根據pay_scene支付場景、出口通道號D3等信息判斷返回車輛A的訂單價格信息)
字段信息:
| 名稱 | 說明 | 類型|最大長度 | 示例 | 是否必傳字段 |
| --- | --- | --- | --- | --- | --- |
car_number| 車牌| String| 8 | 京HP00G6 |否,pay_scene為0,2時必傳
service_name |接口名稱| String|64| query_price| 是
order_id |訂單記錄號(車輛在停車場停車唯一訂單編號,對應入場訂單編號)| String|48 |10000 |否,pay_scene為0,2時必傳;pay_scene為0時,無在場訂單會下發order_id為空串
park_id |車場編號 |String| 24| 20003 |是
pay_scene |支付場景,0:場內預付,1:結算待支付,2:無牌車請求結算,默認:0 |Number|2| 0| 是
out_channel_id |出口通道:字母、數字和下劃線組成| String|16 |A1 |否,pay_scene為1,2時必傳
query_order_no| 查詢價格編號:本次收費系統查詢價格的編號,返回時,原值返回,在預付通知中返回給收費系統 |String|48 |300022 |否,pay_scene為1,2時必傳
licence|無牌車車牌|String|10|AD42F3B|否,車場以出口待結算車輛為準;泊鏈下發當前掃碼車主產生過的無牌車牌號,如當前掃碼車主沒產生過無牌車牌號,則不下發該字段;當車場本地不存在待結算有牌車訂單且存在該無牌車的在場訂單的情況下,才使用licence車牌來進行結算
pay_app| 支付APP,枚舉值 : 0微信、1支付寶、2農行 | Number | 2 | 0 |否(只有SDK對接的車場且支付通道是農業銀行的才能在查詢價格的時候下發pay_app 字段)
|pay_user_id|微信openID或者支付寶的BuyerID|String|100| ouc2o01Annba-HFNNfij-3xBXHrEEWEW|否,當車主用微信或者支付寶APP掃碼支付時,并且支付通道是微信直連、支付寶直連、樂刷、匯付為必傳
> 示例:
> {"query_order_no":"218402018060000000p-863","park_id":"20003","car_number":"62000F9","service_name":"query_price","order_id":"15000001195","pay_scene":0,"licence":"AD42F3B"}
* * * * *
**返回:調用UploadUtil.uploadData(String jsonData)返回上傳結果,方法返回描述如下**
| 名稱 | 說明 | 類型|最大長度 | 示例 | 是否必傳字段 |
| --- | --- | --- | --- | --- | --- |
service_name| 接口名稱| String|64 |query_price| 是
data_target| **傳輸位置,SDK模式必傳,HTTP模式不傳**| String|8 |bolink |是
state| 狀態| Number|2| 0失敗1成功| 是
free_out_time| 免費離場時間(分鐘)| Number|15| 10 |否(默認顯示10分鐘)
query_time |查詢價格時間 |Number(unix時間戳格式,精確到秒) |15|1490875218 |否
duration |停車時長(分鐘)| Number|15 |50 |是
derate_money |減免金額(元) |String|15 |5| 否
derate_duration | 減免時長(分鐘) |Number|15| 5 |否
park_id |車場編號| String| 24|20003| 是
order_id |訂單記錄號(車輛在停車場停車唯一訂單編號,對應入場訂單編號)| String|48 |10000|是
query_order_no |查詢價格編號:本次收費系統查詢價格的編號,返回時,原值返回,在預付通知中返回給收費系統 |String|48 |300022| 否,查詢調用pay_scene為1,2時必傳
errmsg |方法返回描述 |String|48 |State=0時不能為空 |否(有值時必傳)
price |當前應收金額(元)| String| 15|4.0 |是
total| 訂單總金額(元)| String|15 |6.0 |否
position| 停車位置| String| 24|A001 |否
in_time |進場時間,unix時間戳格式,精確到秒| Number|15 |1490875218| 否, pay_scene為0,2時必傳;(與car_number同時返回,可以支付未上傳的訂單)
car_number |車牌| String| 8|京GH0093 |否, pay_scene為0,2時必傳;(與in_time同時返回,可以支付未上傳的訂單)
hide_inpark_info |有了這字段我們就不顯示入場時間和停車時長等需要入場信息的字段| Number|2| 1是 0否| 否(pay_scene為1,2時,返回hide_inpark_info值為1,可以隱藏入場時間和停車時長等需要入場信息)
|multiple_prepay | 車場返回價格時加上這個參數,0不支持多次預付,1支持多次預付;默認0。| Number |1 |0不支持,1支持|否|
||||
**discount_info**|**本地積分電子券,以下為discount_info 的字段參數**|json| | | 否,本地有已對接的積分電子券時返回
member_id |會員編號| String| 50 |Adad123123123123123 |是
use_type| 使用方式:1:積分與電子券只能使用其中一種;2:積分與電子券均可使用| Number |1 |1 |否,當積分信息和電子券信息并存時必傳
limit_hour| 最大兌換小時| Number| 10 |5 |否
limit_count |電子券最大使用張數 |Number| 10 |5 |否
||||
**member_points_info**| **會員積分信息,以下為member_points_info 的字段參數**| json || | 否
member_points |總積分數| Number| 10| 10000| 是
points_per_hour| 兌換每小時所用積分| Number |10| 100 |是
coupon_list| 電子券列表,以下為具體的字段 |JsonArray| || 否
coupon_id| 電子券id |String| 64| Qwqe1231231231 |是
amount |電子券面額| Number| 30| 10 |是
unit |單位 1-小時 2-元 |Number| 10| 1 |是
expires_time |過期時間| Number(unix時間戳格式,精確到秒) |20| 1564419661 |否
attach | 附加信息,回調時返回 |Json |128 | {"should_pay":"0.08"} |否
||||
**park_info_detail** |**子車場停車詳情列表 ,以下為具體的字段** |JsonArray | | | 否
area_name | 子車場名稱 | String | 30 | 地庫一層 | 是
duration? | 子車場停車時長說明 | String | 30 | 1天3小時10分鐘 | 是
|isEscape| 是否強繳,0不顯示逃單 ,1顯示逃單不強繳 ,2顯示逃單并強繳,默認傳0不顯示逃單| Number |1 |0 |否
||||
|is\_report|數據是否上傳到上海路政平臺,0 不上報,1 上報| Number|2|1|否
|empty\_plot|空閑車位數|Number|12|20|否
> 示例:
>{"service_name":"query_price","data_target":"bolink","errmsg":"我查詢成功啦","state":1,"park_id":"21840","order_id":"38320","price":"0.01","duration":1,"query_time":1564538334,"derate_money":"2.00","derate_duration":123,"query_order_no":"2184020190731095912-426","car_number":"","in_time":1561676330,"discount_info":{"member_id":"liu20190729id001","use_type":1,"limit_hour":3,"limit_count":1,"member_points_info":{"member_points":999999666,"points_per_hour":100},"coupon_list":[{"amount":2,"unit":2,"coupon_id":"200002","expires_time":1560000000},{"amount":1,"unit":1,"coupon_id":"100001","expires_time":1564374975}],??"park_info_detail":[{"area_name":"地庫一層","duration":"1天3小時10分鐘"},{"area_name":"地庫二層","duration": "3天3小時10分鐘"}],"multiple_prepay":1,"attach":{"should_pay":"0.08"},"position":"A2-1層","isEscape":"1"}
### **http方式返回字段信息**
| 名稱 | 說明 | 類型|最大長度 | 示例 | 是否必傳字段 |
| --- | --- | --- | --- | --- | --- |
service_name| 服務 |String|64 |query_price| 是
token| 令牌| String|64 |b1ce1026cb794d8ca515159b4b5cecea |是
sign| 數據簽名| String|64 |50BE7B01F8531AE4346B1170BE8E90DA |是
data| 數據,下列字段組成的json對象| Json| 48|{} |是
state| 狀態 | Number|2 |0失敗1成功| 是
free_out_time |免費離場時間(分鐘)| Number| 15|10 |否(默認顯示10分鐘)
query_time| 查詢價格時間 |Number(unix時間戳格式,精確到秒)|15 |1490875218|否
duration |停車時長(分鐘)| Number| 15|50 |是
derate_money| 減免金額(元) |String| 15|5| 否
derate_duration |減免時長(分鐘) |Number| 15|5| 否
park_id |車場編號 |String|24 |20003| 是
order_id |訂單記錄號(車輛在停車場停車唯一訂單編號,對應入場訂單編號) |String| 48|10000| 是
query_order_no |查詢價格編號:本次收費系統查詢價格的編號,返回時,原值返回,在預付通知中返回給收費系統 |String| 48|300022 |否,查詢調用pay_scene為1,2時必傳
errmsg |方法返回描述 |String|48 |State=0時不能為空 |否(有值時必傳)
price| 應收金額(元)| String|15| 6.0| 是
total| 訂單金額(元)| String|15 |6.0| 否
position |停車位置 |String|24 |A001| 否
in_time |進場時間unix時間戳格式,精確到秒| Number|15 |1490875218| 否, pay_scene為0,2時必傳;(與car_number同時返回,可以支付未上傳的訂單)
car_number |車牌| String| 8|京GH0093 |否, pay_scene為0,2時必傳;(與in_time同時返回,可以支付未上傳的訂單)
|multiple_prepay | 車場返回價格時加上這個參數,0不支持多次預付,1支持多次預付;默認0。| Number |1 |0不支持,1支持|否|
attach | 附加信息,回調時返回 |Json |128 | {"should_pay":"0.08"} |否
- 停車收費系統對接協議(車場管理+支付)
- 修訂記錄
- SDK開發包下載
- 一、系統集成
- 1.1初始化(廢棄版本)
- 1.2 車場初始化(SDK 4.2 及后續版本)
- 1.2.1 加密說明
- 1.3反初始化
- 1.4 http退出登錄接口
- 二、上行接口(收費系統調用 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崗亭交易訂單查詢(泊鏈返回h5 url)
- 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.37 ETC扣費
- 2.38 逃單查詢
- 2.39停車場停車業務糾正
- 2.40在停業務總數查詢
- 2.41在停業務詳情查詢
- 2.42市級車入場判定
- 2.43獲取車道屏幕文字
- 2.44離線訂單(先走后付)
- 三、下行接口(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.26 查詢車場停車位通知(停車云)
- 3.27 內部車同步(停車云)
- 3.28 手動結算(停車云)
- 3.29 追繳訂單異步返回結果(泊鏈)
- 3.30 積分電子券信息同步(泊鏈)
- 3.31 車道監控抓拍下發(停車云)
- 3.32 通知上傳收費系統日志(泊鏈)
- 3.33 下發收費系統升級通知(泊鏈)
- 3.34 公眾號新建月卡查詢價格(停車云)
- 3.35 車場有效期下發(停車云)
- 3.36 充電樁充電通知(泊鏈)
- 3.37 逃單補繳異步返回結果(泊鏈)
- 3.38 車輛包月賬單信息查詢
- 3.39 修改道閘余位
- 3.40 查詢月卡車、特殊車
- 3.41 門禁讀取的健康碼狀態下發(停車云)
- 3.42 補錄訂單手動入場
- 3.43 在場訂單車牌校正
- 3.44 無在場訂單固定收費
- 四、查詢免密及電子支付(SDK提供)
- 4.1獲取車牌是否支持免密和SDK心跳
- 4.2推送當前車牌余額及是否支持無感支付(http)
- 五、常見問題與數據定義
- 5.1 數據定義
- 5.1.1車型:car_type
- 5.1.2 入場/出場車型:c_type/out_type
- 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(收費系統調用SDK)
- 7.2 初始化連接智慧屏(收費系統調用SDK)
- 7.3 推送出場訂單(收費系統調用SDK)
- 7.4 接收被掃數據(SDK回調收費系統)
- 7.5 車場生成出口支付碼
- 7.6 推送語音播報
- 7.7 推送進場訂單