> 支持 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
>