> 支持 SDK車場、4G 車場
測試地址:http://test.bolink.club/zld/qrcode/getticket
正式地址:http://yun.bolink.club/zld/qrcode/getticket
*****
### **普通平臺調用模式(返回優惠券鏈接):**
| 字段名稱 | 說明 | 類型 | 示例 | 是否必傳字段 |
| --- | --- | --- | --- | --- |
shop_id |在云平臺注冊的商戶編號 |String |3251 |是
comid |云平臺的車場編號| String |21782 |是
| union_id | 廠商平臺賬號 | String| 200002 | 是 |
type |優惠券類型:3時長券 ,4 全免券 5金額券|String |3 |是
time| 減免時長| Number| 5 |否(type為3時必傳)
amount| 減免金額 |Number| 4 |否(type為5時必傳)
remark |備注 |String |優惠券| 否
time_range| 如果一張全免券支持多次使用,該字段為這張全免券可以減免的有效時長,單位小時。此時有值。其它時候為0。 |Number |5| 否
示例:
測試地址:http://test.bolink.club/zld/qrcode/getticket
> json示例:
{"data":{"comid":"21782","union_id":"200160","shop_id":"476","type":"3","time":1},"sign":"A3489E5F11860763A6071CBFA751011E"}
> 發送Base64位數據:
ew0KCSJkYXRhIjogew0KCQkiY29taWQiOiAiMjE3ODIiLA0KCQkidW5pb25faWQiOiAiMjAwMTYwIiwNCgkJInNob3BfaWQiOiAiNDc2IiwNCgkJInR5cGUiOiAiMyIsDQoJCSJ0aW1lIjogMQ0KCX0sDQoJInNpZ24iOiAiQTM0ODlFNUYxMTg2MDc2M0E2MDcxQ0JGQTc1MTAxMUUiDQp9
*****
同步返回:Base64處理過的字符串
| 字段名稱 | 類型 | 說明 | 是否必傳字段 | 示例 |
| --- | --- | --- | --- | --- |
state |Number |調用結果, 0失敗,1成功 | 是| 1
message| String| 提示信息 |是 |獲取二維碼成功
url |String |二維碼url| 否(state為1時必傳) |http://test.bolink.club/zld/qr/c/df445381785BE753578
示例:
eyJkYXRhIjp7InN0YXRlIjoxLCJtZXNzYWdlIjoi55Sf5oiQ5LqM57u056CBdXJs5oiQ5YqfIiwidXJsIjoiaHR0cDovL3Rlc3QuYm9saW5rLmNsdWIvemxkL3FyL2MvZDcwQjcwRjEwQzUxRDk5Yjc2YyJ9LCJzaWduIjoiQTM0ODlFNUYxMTg2MDc2M0E2MDcxQ0JGQTc1MTAxMUUifQ==
*****
*****
### **POS機調用模式(返回用券頁面):**
適用于 車主使用微信或支付寶掃描該鏈接生成的二維碼獲取優惠券
| 字段名稱 | 說明 | 類型 | 示例 | 是否必傳字段 |
| --- | --- | --- | --- | --- |
shop_id |在云平臺注冊的商戶編號 |String |3251 | 否,傳了shop_number時可不傳
comid |云平臺的車場編號| String |21782 |是
| union_id | 廠商平臺賬號 | String| 200002 | 是 |
type |優惠券類型:3時長券 ,4 全免券 5金額券|String |3 |是
time| 減免時長| Number| 5 |否(type為3時必傳)
amount| 減免金額 |Number| 4 |否(type為5時必傳)
remark |備注 |String |優惠券| 否
time_range| 如果一張全免券支持多次使用,該字段為這張全免券可以減免的有效時長,單位小時。此時有值。其它時候為0。 |Number |5| 否
shop_number|本地商戶編號|String|64|否,shop_number與shop_id 同時上傳時,以shop_number為準
operate_type|獲取類型,1,返回用券頁面;0,返回券鏈接|Number|1|是
only_code|唯一碼,每張POS小票的唯一編號|String|20200616A-01|是,每個only_code 對應一張券
pay_time|交易時間,時間戳格式,精確到秒|Number|1592154061|是
> 注:該模式加密方式與前面不同:
> key 仍使用ckey, 車場秘鑰
> 所有參數按照參數名ASCII碼從小到大以k1=v1&k2=v2排序再拼接上&key=ckey生成待簽名串進行MD5加密生成32位大寫sign值
>
樣例:
> 待簽字符串:amount=2&comid=21782&only_code=123456A1-010ABC002&operate_type=1&pay_time=1592204374&shop_id=479&shop_number=ABDHD288282-002&time=1&type=3&union_id=200160&key=ABC01234567
> MD5 加密后的簽名值:28F448D7C0F67A084342A2DD7CA5FCC1
> 請求url:
http://test.bolink.club/zld/qrcode/getticket?amount=2&comid=21782&only_code=123456A1-010ABC002&operate_type=1&pay_time=1592204374&shop_id=479&shop_number=ABDHD288282-002&time=1&type=3&union_id=200160&sign=28F448D7C0F67A084342A2DD7CA5FCC1
>