停車場收費系統智慧屏應用
SDK 對接的車場使用智慧屏,滿足下列幾個前提條件,可實現斷網時的進出場及支付。
1、車場登錄云平臺,在設備管理中添加本地使用的通道(如果已有使用中的通道,可調用接口2.14上傳本地的通道至云端)
2、車場賬號登錄小程序“車場云管家”,在“車場信息”中給指定通道添加智慧屏,建立屏與通道的連接
3、車場軟件更換SDK 的 3.2.0.0 及以上版本,與智慧屏在同一個局域網中,獲取指定通道的智慧屏 ip(接口 7.1),并初始化連接智慧屏(接口 7.2),之后可推送出場訂單(接口 7.3)、獲取掃碼槍數據(接口 7.4)等操作
獲取智慧屏 ip(收費系統調用SDK)
應用場景:
車場登錄“云車場管家”小程序給指定通道綁定了智慧屏之后,可調用該接口獲取智慧屏的 ip 地址
字段信息:
名稱 | 說明 | 類型 | 示例 | 是否必傳字段 |
---|---|---|---|---|
service_name | 接口名稱 | String | screen_info | 是 |
data_target | 上傳位置 | String | cloud | 是 |
channel_id | 通道編號 | String | A11 | 是 |
示例:
{"service_name": "screen_info","data_target":"cloud","channel_id": "A11"}
同步返回:
字段信息:
名稱 | 說明 | 類型 | 示例 | 是否必傳字段 |
---|---|---|---|---|
service_name | 接口名稱 | String | screen_info | 是 |
state | 初始化狀態,0 失敗 1 成功 | Number | 1 | 是 |
errmsg | 返回描述 | String | 查詢成功 | 是 |
device_ip | 智慧屏 ip | String | 192.168.199.199 | 否 |
device_id | 智慧屏設備號 | String | 9528166666999999 | 否 |
device_name | 智慧屏名稱 | String | 東門出口 | 否 |
park_id | 車場編號 | String | 21000 | 是 |
channel_id | 通道編號 | String | A11 | 是 |
示例:
{"device_ip":"192.168.199.199","device_name":"東門出口","device_id":"9528166666999999","service_name":"screen_info","park_id":"21000","errmsg":"獲取成功","state":1,"channel_id":"A11"}
初始化連接智慧屏(收費系統調用SDK)
應用場景:
車場獲取到指定通道的智慧屏的 ip 地址后,調用該接口與智慧屏建立連接
字段信息:
名稱 | 說明 | 類型 | 示例 | 是否必傳字段 |
---|---|---|---|---|
service_name | 接口名稱 | String | init_screen | 是 |
data_target | 上傳位置 | String | wisdom_screen | 是 |
channel_id | 通道編號 | String | A11 | 是 |
device_ip | 設備IP | String | 192.168.199.199 | 是 |
示例:
{ "service_name": "init_screen","data_target": "wisdom_screen","device_ip": "192.168.199.199", "channel_id": "A11"}
初始化同步返回:
字段信息:
名稱 | 說明 | 類型 | 示例 | 是否必傳字段 |
---|---|---|---|---|
service_name | 接口名稱 | String | init_screen | 是 |
state | 初始化狀態,0 失敗 1 成功 | Number | 1 | 是 |
errmsg | 返回描述 | String | success | 是 |
示例:
{"errmsg":"success","service_name":"init_screen","state":1}
推送出場訂單(收費系統調用SDK)
應用場景:
車輛出場,計費系統核算出價格后,調用該接口推送訂單詳情顯示到智慧屏,車主可掃描該信息里的支付二維碼進行支付
注:如果長時間未收到支付成功回調,建議車場及時發送其他信息(比如完成頁 10秒后會刷新回到主頁),避免該信息一直顯示,被其他車主誤掃
字段信息:
名稱 | 說明 | 類型 | 示例 | 是否必傳字段 |
---|---|---|---|---|
service_name | 接口名稱,出場消息 | String | out | 是 |
data_target | 上傳位置 | String | wisdom_screen | 是 |
channel_id | 通道編號 | String | A11 | 是 |
type | 1:月卡,2:無需繳費,3:繳費成功,4:待支付繳費金額信息 | Number | 4 | 是 |
car_number | 車牌號 | String | 京ABC9991 | 是 |
total | 總金額 | String | 2.15 | 否 ( type=3,4時 必傳 ) |
out_pic | 出場圖片的base64 編碼格式, | String | data:image/jpg;base64,/9j/4AAQSkZJRgABAQAASABIAAD/4RnnRXhpZ... | 否 |
in_pic | 進場圖片的 base64 編碼格式 ,前綴“data:image/jpg;base64,” | String | data:image/jpg;base64,/9j/4AAQSkZJRgABAQAASABIAAD/4RnnRXhpZ... | 否 |
price | 需要繳費的金額 | String | 0.01 | 否( type=4 必傳 ) |
reduce_amount | 減免金額 ,需帶單位“元” | String | 4.56元 | 否( type=4 必傳 ) |
in_time | 入場時間 'yyyy-MM-dd HH:mm:ss' | String | 2020-10-16 08:08:08 | 否 |
duration | 停車時長,單位分鐘 | String | 22 | 否( type=4 必傳 ) |
code | 出口支付碼地址,按接口 7.5 生成 | String | http://s.bolink.club/unionapi/thirdtopayorder?params=[1602751210742%2C0.01%2C臨BF4E338%2C20.15%2C1602815671%2C200160%2C21782%2CA11%2C1602815671]&sign=d2cdd57437f520735fe27c0ef50a0199 | 否( type=4 必傳 ) |
prepay | 已預付金額 | String | 0.01 | 否( type=4 必傳 ) |
state | 結果狀態,1 成功,0 失敗 | Number | 1 | 是 |
tts | 語音播報內容 | string | 64 | 否 |
示例:
{"service_name":"out","data_target":"wisdom_screen","type":4,"car_number":"京ABC9991","channel_id":"A11","total":"2.15","price":"0.01","reduce_amount":"4.56元","in_time":"2020-10-16 08:08:08","duration":"22","code":"http://s.bolink.club/unionapi/thirdtopayorder?params=[1602751210742%2C0.01%2C臨BF4E338%2C20.15%2C1602815671%2C200160%2C21782%2CA11%2C1602815671]&sign=d2cdd57437f520735fe27c0ef50a0199 ","prepay":"0.01","state":1,"tts":"京ABC123,請繳費2.15元"}
初始化同步返回:
字段信息:
名稱 | 說明 | 類型 | 示例 | 是否必傳字段 |
---|---|---|---|---|
service_name | 接口名稱 | String | out | 是 |
state | 初始化狀態,0 失敗 1 成功 | Number | 1 | 是 |
errmsg | 返回描述 | String | success | 是 |
接收被掃數據(SDK回調收費系統)
應用場景:
車場推送出場訂單到智慧屏后
1、車主可出示付款碼被掃,車場接收該支付碼再調用接口 2.2 上傳 pay_type=auth_code發起扣費;
2、車主支付完成后,在斷網情況下,車場無法收到接口 3.4 下發的支付成功消息,此時車主可出示手機上的支付成功二維碼被掃,車場收到該信息后可抬桿放行
字段信息:
名稱 | 說明 | 類型 | 示例 | 是否必傳字段 |
---|---|---|---|---|
service_name | 接口名稱,被掃 | String | sweepcode | 是 |
type | 被掃碼類型 | Number | 1 、手機付款碼 ; 2 、支付成功二維碼被掃 | 是 |
pay_info | 支付成功二維碼 | String | 否(type=2 時必傳) | |
authcode | 微信或支付寶的付款碼 | String | 234567874567654 | 否(type=1 時必傳) |
channel_id | 通道號 | String | A11 | 是 |
示例:
{"service_name":"sweepcode","type":1,"channel_id":"A11","authcode":"234567874567654"}
初始化同步返回:
字段信息:
名稱 | 說明 | 類型 | 示例 | 是否必傳字段 |
---|---|---|---|---|
service_name | 接口名稱 | String | sweepcode | 是 |
state | 初始化狀態,0 失敗 1 成功 | Number | 1 | 是 |
errmsg | 返回描述 | String | success | 是 |
示例:
{"errmsg":"success","service_name":"init_screen","state":1}
車場生成出口支付碼
應用場景:
車場調用接口 7.3 推送出場訂單到智慧屏,type 為 4 時 信息中包含該訂單的支付信息鏈接,調用該接口生成這個支付鏈接,在智慧屏展示為二維碼形式,方便車主掃碼支付
注:
1、請求地址 https://s.bolink.club/unionapi/thirdtopayorder
2、sign簽名規則是 params 的信息 直接拼接廠商秘鑰 ukey 進行md5加密
3、params 有序 數組格式,utf-8編碼后傳入(獲取sign 簽名時無需 utf-8 編碼)
字段信息:
名稱 | 說明 | 類型 | 示例 | 是否必傳字段 |
---|---|---|---|---|
params | 有序數組格式(utf-8編碼后傳入) | String | [A1_2C1600858624,2.12,京A11111,0.1,1600863147,200279,21000,A1,1600863147] | 是 |
sign | 簽名,32位小寫 | String | a7cd3d7c8f30a3e32435aefc88650887 | 是 |
示例:
sign 獲取:
[A1_2C1627291675,2.12,京DTTT222,0.1,1627291740,200002,21840,A1,1627350591]EA2D90FEEF1E9F8E 進行MD5加密后取32位小寫,得到:542b570d75859a64e3642edfc4285334
params 參數拼接:A1_2C1627291675,2.12,京DTTT222,0.1,1627291740,200002,21840,A1,1627350591 進行 utf-8 編碼,得到:
A1_2C1627291675%2C2.12%2C%E4%BA%ACDTTT222%2C0.1%2C1627291740%2C200002%2C21840%2CA1%2C1627350591
備注:params 參數依次為
名稱 | 是否必傳字段 | 示例 | 空值 |
---|---|---|---|
訂單編號 | 是 | A1_2C1600858624 | 不可空 |
價格 | 是,單位 元 ,最多兩位小數 | 2.12 | 不可(0元直接放行不需掃碼) |
車牌號 | 是 | 京A11111 | 不可空 |
優惠金額 | 是 | 0.01 | 0 |
入場時間 | 是(unix時間戳格式到秒) | 1600863147 | 不可空 |
廠商編號 | 是 | 200279 | 不可空 |
車場編號 | 是 | 21000 | 不可空 |
通道編號 | 是 | A1 | 不可空 |
當前時間 | 是(unix時間戳格式到秒) | 1600863147 | 不可空, 1 分鐘內有效,超時需重新生成 code |
推送語音播報
應用場景:
車場向指定通道的智慧屏推送語音播報
字段信息:
名稱 | 說明 | 類型 | 示例 | 是否必傳字段 |
---|---|---|---|---|
service_name | 接口名稱 | String | tts | 是 |
data_target | 上傳位置 | String | wisdom_screen | 是 |
channel_id | 通道編號 | String | A11 | 是 |
content | 語音播報內容 | String | 請使用微信支付寶掃碼查詢 | 是 |
示例:
{ "service_name": "tts","data_target": "wisdom_screen","channel_id":"A11","content": "請使用微信支付寶掃碼查詢"}
推送進場訂單
應用場景:車輛進場,車場調用該接口推送車輛詳情顯示到智慧屏。可在智慧屏入口顯示車牌和歡迎光臨等文字同時語音播報
字段信息:
名稱 | 說明 | 類型 | 示例 | 是否必傳字段 |
---|---|---|---|---|
service_name | 接口名稱,進場消息 | String | in | 是 |
data_target | 上傳位置 | String | wisdom_screen | 是 |
channel_id | 通道編號 | String | A11 | 是 |
car_number | 車牌號 | String | 京ABC9991 | 是 |
in_time | 入場時間,'yyyy-MM-dd HH:mm:ss' | String | 2021/11/05 21:09:09 | 否 |
text | 文本顯示內容 | String | 您好,歡迎光臨 | 否 |
tts | 語音播報內容 | String | 您好,歡迎光臨 | 否 |
示例:
{ "service_name": "in","data_target": "wisdom_screen","car_number": "京HJ9900","channel_id": "1890","in_time": "2021-11-05 08:08:08","tts": "您好,歡迎光臨","text": "您好,歡迎光臨"}
同步返回:
字段信息:
名稱 | 說明 | 類型 | 示例 | 是否必傳字段 |
---|---|---|---|---|
service_name | 接口名稱 | String | in | 是 |
state | 初始化狀態,0 失敗 1 成功 | Number | 1 | 是 |
errmsg | 返回描述 | String | success | 是 |
- 上一篇:倍加信停車場在線支付,支持的銀行清單 2022/12/13
- 下一篇:倍加信停車場系統寧夏交警數據上報 2022/12/12