优惠活动
活动创建
优惠活动创建、挂载活动资源(优惠券等) -> 关联一个或者多个服务商(比如:饿了么、易到用车、铁友等)
活动上下线
创建活动 -- 挂载优惠券(折扣券、满减券)资源
活动可以进行上下线操作,未上线的活动支持修改操作,优惠券(未支付之前可以修改优惠券信息)支付后方可进行发券
活动一旦下线 平台不再支持重新上线,需要重新创建活动再上线
优惠券发放
提供根据活动Id、合作方在管理系统中生成的应用Id和合作方用户Id,给用户的券账户发券(此时用户的券账户在平台上)
用户在下单时 会从用户(根据合作方编码和合作方用户Id)的券账户选取最合适的优惠券 进行优惠券消费
按照某个优惠券资源发放接口
接口请求地址
/v1/activities/coupons/single_give
接口请求方法
POST
接口请求头
Content-Type:applicaiton/json;charset=utf-8
接口请求参数
参数名 | 类型 | 是否必须 | 示例 | 描述 |
---|---|---|---|---|
coupon_id | string | 是 | 181176 | 活动优惠券的id |
user_id | string | 是 | ac3142cb-6fc8-4e88-bff6-529ce067dcb4 | 用户的id |
app_id | string | 是 | 1001 | 合作方申请的应用Id,平台提供 |
优惠券发放接口响应
{
"code": 0,
"msg": "处理成功",
"data": [{
"coupon_id": 81,
"activity_coupon_id": 40
}]
}
响应说明
coupon_id: 是对应所发券的Id;
activity_coupon_id: 是对应活动或者资源的Id
data 是以数组的形式返回,因为某个券资源可以一次返回多张券(添加券资源可以设置)
按照活动发券接口
接口请求地址
/v1/activities/coupons/batch_give
接口请求方法
POST
接口请求头
Content-Type:applicaiton/json;charset=utf-8
接口请求参数
参数名 | 类型 | 是否必须 | 示例 | 描述 |
---|---|---|---|---|
activity_id | string | 是 | 1001010 | 活动id |
user_id | string | 是 | ac3142cb-6fc8-4e88-bff6-529ce067dcb4 | 用户id |
app_id | string | 是 | 1001 | 合作方申请的应用Id |
接口响应
{
"code": 0,
"msg": "处理成功",
"data": [{
"coupon_id": 81,
"activity_coupon_id": 40
}]
}
根据活动或者优惠券资源发券的区别就是,按照活动发券,会将该活动下挂载的所有券资源都发一遍
优惠券报表
为合作方提供 关于某个营销活动下优惠券使用记录报表