五、获取优惠券二维码接口

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