优惠券领取接口 - shoufuyou/Shoufuyou-SDK-Doucument-for-core-client GitHub Wiki
method: coupon.obtain
用户请求信用飞领取优惠券。
| 参数 | 参数名称 | 类型 | 必填 | 描述 | 范例 |
|---|---|---|---|---|---|
| mobile | 领取用户手机号 | String | 必填 | 领取用户手机号 | 136****3636 |
| coupon_template_id | 优惠券模板id | String | 必填 | 信用飞这里给到的优惠券模板id，可接收多个优惠券id，用英文,隔开，如:124,125 | 145 |
###请求参数示例
{
"mobile": "139055842147",
"coupon_template_id": "124"
}| 参数 | 参数名称 | 类型 | 必填 | 描述 | 范例 |
|---|---|---|---|---|---|
| code | 返回的结果码 | String | 是 | 10000- 成功生成订单；非10000为错误码 | 10000 |
| message | 返回结果码对应的字符串解释 | String | 是 | 如code参数里的描述 | 请求成功 |
| 如果成功生成交易单则应答里包含下述结果 | |||||
| id | 用户优惠券id | String | 是 | 用户优惠券id | 1001001 |
| discount_type | 优惠类型 | String | 是 | 优惠类型 | 立减:price_reduce;利息折扣:fee_discount;总价折扣:price_discount |
| discount_rate | 折扣率 | String | 是 | 折扣率 | 0.5(0-1) |
| discount_amount | 优惠金额（分） | String | 是 | 优惠金额 | 100 |
| periods | 可使用期数 | String | 是 | 可使用期数 | 3,6或者all |
| start_time | 可使用起始时间 | String | 是 | 可使用起始时间 | 2018-01-26 15:32:00 |
| end_time | 可使用截止时间 | String | 是 | 可使用截止时间 | 2018-03-23 14:14:00 |
| product_type | 可使用产品类型 | String | 是 | 可使用产品类型 | flight,freetour或者all |
| tourist_number | 可使用出行成人数 | String | 是 | 可使用出行成人数 | 2或者all |
| departure | 可使用出发地 | String | 是 | 可使用出发地 | 上海 |
| destination | 可使用目的地 | String | 是 | 可使用目的地 | 北京 |
| product_name | 可使用产品名中需要包含字串 | String | 是 | 可使用产品名中需要包含字串 | #特惠产品# |
| status | 优惠券状态 | String | 是 | 优惠券状态：未只用 unused；已使用 used；已强制失效 invalid； | unused |
| upper_price | 可使用订单金额上限（分） | String | 是 | 可使用订单金额上限（分） | 200000 |
| lower_price | 可使用订单下限（分） | String | 是 | 可使用订单下限（分） | 100000 |
| valid_used_times | 当前优惠券可使用次数 | String | 是 | 当前优惠券可使用次数 | 1 |
| used_times | 已使用次数 | String | 是 | 已使用次数 | 0 |
| template_id | 优惠券模板id | String | 是 | 优惠券模板id | 124 |
| terminal | 可使用终端类型 | String | 是 | 可使用终端类型：pc，ios，android，wap | all |
"coupons":[
{
"discount_amount":500,
"created_time":"2018-03-23 15:12:37",
"valid_used_times":1,
"periods":"all",
"upper_price":99999900,
"lower_price":0,
"start_time":"2018-01-01 00:00:00",
"end_time":"2019-01-01 00:00:00",
"product_type":"all",
"tourist_number":"all",
"terminal":"all",
"departure":"all",
"destination":"all",
"discount_type":"order",
"status":"unused",
"id":"889",
"template_id":1
}
],
"code":"10000",
"message":"请求成功"
}