# 创建优惠券活动

创建一个新的优惠券活动。

  注意此API调用不包含project_id路径参数，因此您需要使用在您公司的所有项目中都有效的API密钥来设置授权。

Endpoint: POST /merchants/{merchant_id}/coupon_promotions
Version: 2.0
Security: basicAuth

## Path parameters:

  - `merchant_id` (integer, required)
    商户ID。

## Request fields (application/json):

  - `campaign_code` (string, required)
    优惠券活动名称。

  - `campaign_names` (object, required)
    包含优惠券活动本地化名称的对象。

  - `campaign_names.ar` (string)
    阿拉伯语。

  - `campaign_names.bg` (string)
    保加利亚语。

  - `campaign_names.cn` (string)
    中文（简体）。

  - `campaign_names.cs` (string)
    捷克语。

  - `campaign_names.de` (string)
    德语。

  - `campaign_names.en` (string)
    英语。

  - `campaign_names.es` (string)
    西班牙语。

  - `campaign_names.fr` (string)
    法语。

  - `campaign_names.he` (string)
    希伯来语。

  - `campaign_names.it` (string)
    意大利语。

  - `campaign_names.ja` (string)
    日语。

  - `campaign_names.ko` (string)
    韩语。

  - `campaign_names.pl` (string)
    波兰语。

  - `campaign_names.pt` (string)
    葡萄牙语。

  - `campaign_names.ro` (string)
    罗马尼亚语。

  - `campaign_names.ru` (string)
    俄语。

  - `campaign_names.th` (string)
    泰语。

  - `campaign_names.tr` (string)
    土耳其语。

  - `campaign_names.tw` (string)
    中文（繁体）。

  - `campaign_names.vi` (string)
    越南语。

  - `campaign_redeems_count_for_user` (integer)
    每个用户在一个优惠券活动中最多可兑换的优惠券数量。如传入null，则可兑换数量不限。

  - `expiration_date` (string)
    按照[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)规定的YYYY-MM-DD’T’HH:MM:SS格式的活动到期日。

  - `project_id` (integer, required)
    项目ID。

  - `redeems_count` (integer)
    可兑换优惠券的最大数量。如传入null，则数量不限。

  - `redeems_count_for_user` (integer)
    每个用户最多可兑换的优惠券数量。如传入null，则可兑换数量不限。

  - `subscription_coupon` (object)
    奖励中包含订阅参数的对象。

  - `subscription_coupon.plan_id` (integer, required)
    订阅计划ID。

  - `subscription_coupon.product_id` (integer, required)
    订阅产品ID。

  - `subscription_coupon.trial_period` (integer, required)
    以天为单位的试用期长度。

  - `virtual_currency_amount` (number)
    奖励中的虚拟货币数。

  - `virtual_items` (object)
    奖励中的虚拟物品参数数组。

  - `virtual_items.quantity` (integer, required)
    虚拟物品数量。

  - `virtual_items.sku` (string, required)
    虚拟物品SKU。

## Response 201 fields (application/json):

  - `id` (integer)
    Example: 9134