商户创建商品代金券

开发环境

POST

/v3/koubei/marketing/campaign/item/merchantactivity/create

koubei.marketing.campaign.item.merchantactivity

商户创建商品代金券

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/koubei/marketing/campaign/item/merchantactivity/create' \
--header 'Content-Type: application/json' \
--data-raw ''

响应示例

200 - 示例 1

{
  "activity_id": "208888888"
}

请求参数

Body 参数application/json

voucher_info

object (MerchantActivityVoucherInfo)

可选

logo

string

可选

券logo 券logo最大字符数不能超过64

sub_title

string

可选

子标题券子标题最大字符数不能超过256 券子标题最小字符数不能低于2

user_introductions

string

可选

使用须知券使用须知最大字符数不能超过1000

valid_days_range_from

integer

可选

领取后, 第几天开始生效 valid_time_type=RELATIVE时有效且必填

valid_days_range_to

integer

可选

领取后, 第几天失效 valid_time_type=RELATIVE时有效且必填

valid_time_range_from

string

可选

有效期开始时间 valid_time_type=FIXED时有效且必填券有效开始时间格式必须为yyyy-MM-dd HH:mm:ss

valid_time_range_to

string

可选

有效期截止时间 valid_time_type=FIXED时有效且必填券有效结束时间格式必须为yyyy-MM-dd HH:mm:ss

valid_time_type

string

有效期类型

可选

count_limit

integer

可选

活动优惠次数限制，必须设置。说明：活动优惠总次数限制不能小于1，且不能大于99999999。

示例值:

count_limit_per_day

integer

可选

活动优惠单日次数限制。说明：活动优惠单日次数限制不能为负数，不能大于99999999；0表示不限制。

示例值:

count_limit_per_user

integer

可选

活动单用户限次。说明：活动单用户总限次不能为负数，不能大于999。0表示不限制。

示例值:

count_limit_per_user_per_day

integer

可选

活动单用户单日限次。说明：活动单用户单日限次不能为负数，不能大于999。0表示不限制。

示例值:

crowd

string

可选

群规则，枚举支持： * DEFAULT：全部用户； * ONLINE_NEWCOMER：在线购买新人； * MEMBER：会员。

示例值:

DEFAULT

deduct_amount

string

可选

代金券面额，单位为元。说明：代金券面额格式必须为#.##，代金券面额需小于49999。

示例值:

5.00

external_callback_url

string

可选

外部回调地址，最大字符数不能超过500。

示例值:

xxxx

external_unique_id

string

可选

外部id，需保证同一账户下唯一。说明：最小长度不能低于13，最大长度不能超过64。

示例值:

4b203fe6c11548bcabd8da5bb087a83b

memo

string

可选

备注。说明：备注最大字符数不能超过500。

示例值:

备注

min_cost

string

可选

使用门槛，即满 min_cost 元可用，使用门槛必须大于券面额，单位为元。说明：使用门槛格式必须为#.##。

示例值:

5.00

obtain_manually

boolean

可选

是否手动领取，本期只支持true

示例值:

true

gmt_end

string

可选

活动结束时间。活动结束时间需大于活动开始时间。格式为"yyyy-MM-dd HH:mm:ss"。

示例值:

{}

gmt_start

string

可选

活动开始时间。格式为"yyyy-MM-dd HH:mm:ss"。

示例值:

{}

item_ids

array[string]

可选

商品列表。说明：参加活动的商品列表不能为空，最大个数不能超过100。

示例值:

["2088xxxxx","2088xxxx"]

示例

返回响应

🟢200common response

application/json

Body

activity_id

string

运营活动id

可选

示例值:

208888888

🔴500请求失败

修改于 2023-11-27 07:47:50

招商门店分页查询接口

商户下架代金券