測試地址:https://beta.bolink.club/unionapi/paymonthcard
正式地址:https://s.bolink.club/unionapi/paymonthcard
**應該場景:**
1、 用戶微信掃碼在微信中打開訂單網址,云平臺服務器調用此接口,取回預下單信息,當返回的狀態(state)為1時,取出payurl參數,把用戶微信請求跳轉到payurl,完成下單,調起微信支付頁面。
2、 云平臺服務調用此接口,取回payurl后,生成二維碼,用戶掃碼后發起支付。
**說明:當前支持微信、支付寶來發起支付**
請求數據:json字符串
| 字段名稱 | 類型 | 說明 | 是否必傳 | 示例 |
| --- | --- | --- | --- | --- |
| union_id | Number | 廠商平臺賬戶 | 是 | 200159 |
| sign | String | 數據data的簽名值 32位 | 是 | 51582ADA1872E38884E6119673021F7D |
| data | json | 包含下面的所有字段的json對象 | 是 | {“park_id”:”21787”,”amount”:”0.01”…} |
| park_id | String | 車場編號 | 是 | 21787 |
| amount |String | 金額,單位是元,保留兩位小數 | 是 | 0.01 |
| card_id | String |月卡編號,32位以內,字母數字和下劃線組成 | 否 | A1_2C1528943355 |
| trade_no | String |交易流水號,由數字組成的字符串,建議16-32位,不低于16位,不可重復。 | 是 | 201712125566359777 |
|notify_url | String | 支付結果異步回調地址,以http或https開頭,回調是以post方法請求,地址不要包含參數信息 ; |是 | http://beta.bolink.club/unionapi/monthpaynotify |
| back_url | String | 支付成功后用戶返回地址,為空時,返回到泊鏈默認頁面 |否 | https://beta.bolink.club/unionapi/paysuccess?trace_no=201712125566359777 |
| cancel_url | String | 支付失敗用戶返回地址,為空時,返回到泊鏈默認頁面 |否 |https://beta.bolink.club/unionapi/paysfail?trade_no=201712125566359777 |
| car_number | String |車牌 | 否 | 蘇HHH000 |
| attach |Json | 附加信息,回調時返回 | 否 |{“order_id”:”abc123”} |
| pay_channel | String | 支付通道,微信(weixin)或支付寶(ali),接受weixin或ali兩個參數值,默認微信 | 否 | weixin |
| time_temp | String | 時間戳,每次調用要改變,確保簽名不一樣。 | 是 | 1533035031600 |
|server_id | Number| 接收分賬方互聯互通工程服務商編號 ; 如車場不支持樂刷分賬請勿傳此字段| 否 ,is_separate_accounts為1時必傳 | 800251 |
| split_amount | String | 分賬金額 單位:元,保留兩位小數 ; 如車場不支持樂刷分賬請勿傳此字段| 否,is_separate_accounts為1時必傳 | 0.01 |
| is_separate_accounts |Number | 訂單是否分賬,0不分賬,1 分賬; 如車場不支持樂刷分賬請勿傳此字段 | 否 | 0 |
| useButton| Number| 是否啟用自定義按鈕,1-開啟,0、不填\-關閉| 否,展示自定義按鈕時必填|1
|
|buttonJson|Json| 小票按鈕, 包含下面的所有字段的json對象|否| buttonJson:{"h5Url":"https://s.bolink.club/login.html","buttonName":"新按鈕"}
| h5url|String| H5跳轉鏈接 | 否,useButton為1時必填|https://www.baidu.com
| buttonName|按鈕名稱|String| 否 |查看詳情
**示例:**
{"sign":"51582ADA1872E38884E6119673021F7D","union_id":200159,"data":{"back_url":"https://beta.bolink.club/unionapi/paysuccess?trace_no=201712125566359777","amount":"0.01","trade_no":"201712125566359777","cancel_url":"https://beta.bolink.club/unionapi/paysfail?trade_no=201712125566359777","park_id":"21787","attach":{"order_id":"abc123"},"car_number":"蘇HHH000","notify_url":"http://beta.bolink.club/unionapi/monthnotify","pay_channel":"weixin","card_id":"A1_2C1528943355","time_temp":1533035031600,"buttonJson":{"h5Url":"www.baidu.com","buttonName":"測試按鈕ABCDEFG"},"useButton":"1"}}
**泊鏈收到處理后,同步返回:json字符串**
| 字段名稱 | 類型 | 說明 | 是否必傳 | 示例 |
| --- | --- | --- | --- | --- |
| state | Number |調用結果 0失敗,1成功 | 是 | 1 |
| errmsg |String | 錯誤提示信息 | 否 | Status為0時必傳 |
|trade_no | String | 調用支付接口時傳入的trade_no | 是 | 201712125566359777 |
| payurl | String | 支付地址,收到后,跳轉,發起支付 | 是 | https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx85e16a11d32ee2e1&redirect_uri=https%3A%2F%2Fbeta.bolink.club%2Funionapi%2Fpaymonthcard%3Fkfc_id%3d9127&response_type=code&scope=snsapi_base&state=123#wechat_redirect |
**示例:**
{"trade_no":"201712125566359777","payurl":"https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx85e16a11d32ee2e1&redirect_uri=https%3A%2F%2Fbeta.bolink.club%2Funionapi%2Fpaymonthcard%3Fkfc_id%3d9127&response_type=code&scope=snsapi_base&state=123#wechat_redirect","state":1}
- 新版*泊鏈API接口文檔(車場平臺)
- 修訂記錄
- 一、概述
- 1.1接口協議
- 1.2數據簽名
- 1.3請求地址
- 二、停車場相關接口
- 2.1發布停車場信息
- 2.2更新停車場信息
- 2.3 二維碼獲取
- 2.4車場進件頁面接口
- 2.5 無牌車入場設置短信驗證接口
- 2.6車場接口進件
- 三、交易與結算
- 3.1提交停車進場紀錄
- 3.2提交停車出場記錄
- 3.3月卡續費
- 3.4臨停繳費
- 3.5獲取樂刷分賬簽約地址接口
- 3.6接收分賬方綁定接口
- 3.7ETC支付接口
- 3.8 逃單查詢
- 3.9 逃單補繳
- 3.10 紅包找零接口
- 3.11充電減免結果上傳
- 四、訂單對賬接口
- 4.1 查詢歷史訂單
- 4.2 訂單退款
- 4.3車場訂單電子支付狀態查詢接口
- 4.4提現查詢接口
- 五、需要廠商平臺實現的接口
- 5.1 查詢實時訂單金額
- 5.2 車牌無感狀態及變更通知
- 5.3預付訂單通知
- 5.4獲取車輛進場圖片
- 5.5電子收費異步返回結果
- 5.6電子訂單退款異步返回結果
- 5.7無牌車入場請求
- 5.8月卡續費回調
- 5.9追繳訂單異步返回結果
- 5.10 臨停繳費回調
- 5.11 逃單補繳回調
- 5.12找零支出下發通知
- 5.13無牌車入場獲取短信驗證碼接口
- 5.14 繳費減免通知
- 六、電子發票接口
- 6.1、電子發票開票訂單上傳接口
- 6.2、開票方信息查詢接口
- 6.3、開取發票接口
- 6.4、發票狀態回調接口
- 6.5、查詢開票狀態接口
- 七、無牌車開放接口
- 八、智慧社區上行通用接口文檔
- 8.1接口協議
- 8.2數據簽名
- 8.3登錄接口
- 8.4小區數據采集接口
- 8.5設備信息采集
- 8.6人臉數據傳輸接口
- 8.7人員進出記錄
- 8.8上報狀態查詢接口
- 8.9人臉門禁數據上報平臺
- 九、智慧社區下行通用接口文檔
- 9.1接收人員照片信息
- 十、數據上報上行接口
- 10.1停車場停車業務糾正
- 10.2在停業務總數查詢
- 10.3在停業務詳情查詢
- 10.4市級車入場判定
- 10.5獲取車道屏幕文字
- 10.6獲取包月車信息(全量更新)
- 十一、數據上報下行接口
- 11.1抬桿指令下發通知
- 11.2車輛包月賬單信息查詢
- 11.3修改道閘余位
- 11.4新增\刪除特殊車
- 11.5新增\刪除\修改月卡車
- 11.6查詢月卡車、特殊車
- 11.7開票記錄通知