> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waffo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# クーポン

> クーポンとプロモーションコードを作成し、チャネルごとにコードを配布して、利用状況を確認する

## クーポン管理

クーポンページでは、ストアの割引を設定します。**クーポン**は割引そのものを定義します：割引額、対象商品、有効期限、利用上限。各クーポンには購入者がチェックアウトで入力する**プロモーションコード**が 1 つ付属します。同じ割引をチャネルや対象者ごとに配布するには、クーポンにプロモーションコードを追加します。コードごとに独自の条件を設定できます。チェックアウトやサブスクリプションでの割引の動作は[割引とプロモーション](https://docs.waffo.ai/ja/guides/discounts.md)を参照してください。

クーポンは 1 つの環境にのみ属します。ページは上部の**テストモード**スイッチに従い、テストモードで作成したクーポンは本番モードでは使えません。準備ができたら[本番環境へコピー](#copy-to-live)してください。

![Coupons list](https://mintcdn.com/waffo/fzyQe5Jh5yF_yUiY/images/dashboard/discounts-list.png?fit=max\&auto=format\&n=fzyQe5Jh5yF_yUiY\&q=85\&s=997ad1e53892442a1a6cd14a0f056120)

## クーポン一覧

上部の概要カードには、有効なクーポン数、全クーポンの累計利用回数、最も使われたクーポン、追加したプロモーションコード数が表示されます。その下の一覧には次の列があります。

| 列 | 説明 |
| - | - |
| 名前 | クーポン名（自分にだけ表示）と、割引・期間・制限 |
| プロモーションコード | クーポンのデフォルトコード。行を展開すると追加コードを確認できます |
| ステータス | 有効、使い切り、期限切れ、無効化、作成失敗。ホバーすると意味を確認できます |
| 使用 / 上限 | クーポンの全コードの累計利用回数と総上限 |
| 有効期限 | クーポンの利用期限、または期限なし |
| 商品 | すべての商品、または限定している商品数 |

**すべて / 有効 / 終了 / 無効化 / 作成失敗**タブで絞り込むか、名前またはプロモーションコードで検索します。コードで検索すると、クーポンの追加コードにも一致します。

### クーポンのステータス

| ステータス | 意味 |
| - | - |
| 有効 | 購入者はいずれかのコードをチェックアウトで入力して今すぐ利用できます |
| 使い切り | 利用回数が上限に達し、コードはチェックアウトで拒否されます |
| 期限切れ | 利用期限を過ぎ、コードは拒否されます。期限は変更できないため、延長するには新しいクーポンを作成します |
| 無効化 | 自分で無効化したもので、コードは拒否されます。すでにサブスクリプションに適用されている割引は、そのサブスクリプションの次回プラン変更まで続きます |
| 作成失敗 | クーポンを作成できませんでした。コードは解放されているので、同じコードで再作成できます |

## クーポンの作成

![Create coupon](https://mintcdn.com/waffo/fzyQe5Jh5yF_yUiY/images/dashboard/discounts-create.png?fit=max\&auto=format\&n=fzyQe5Jh5yF_yUiY\&q=85\&s=e28dc699e3ebfceea1892fda047e679b)

**1. 「新しいクーポン」をクリック**

クーポンページの右上にあります。

**2. 名前を付ける**

名前は一覧でクーポンを見分けるためのものです。購入者にはプロモーションコードしか表示されません。

**3. 商品を選ぶ**

デフォルトではすべての商品に適用されます。**特定の商品に限定**をオンにすると、対象商品を選べます。

**4. 割引を設定する**

パーセント割引、または固定額割引。固定額は、選択した商品の価格通貨ごとに 1 つずつ金額を設定します。

**5. 期間を設定する**

サブスクリプションのみ：初回の支払いだけ、最初の N 請求サイクル、またはすべての支払いを割引します。

**6. プロモーションコードと制限を設定する**

コードは自動生成されます。そのまま使うか、自分のコードに変更できます。任意で有効期限、総利用上限、追加のプロモーションコードを設定します。

**7. 作成する**

右側のサマリーにクーポンの内容が表示されます。**クーポンを作成**をクリックします。

> [!WARNING]
>
> 作成後に変更できるのは名前だけです。プロモーションコード、割引、商品、有効期限、利用上限を変更するには、新しいクーポンを作成してください。

### クーポンの項目

| 項目 | 必須 | 説明 |
| - | - | - |
| 名前 | はい | 内部用の名前。購入者には表示されません |
| 商品 | いいえ | デフォルトはすべての商品。現在の環境に公開されていない商品は選べません |
| 種類 | はい | パーセントまたは固定額 |
| 割引率 | パーセントの場合 | 0 より大きく 100 以下、小数は 2 桁まで |
| 割引額 | 固定額の場合 | 通貨ごとに 1 つの金額。通貨は商品の価格通貨に従います。記載のない通貨には割引が適用されず、換算もされません |
| 期間 | はい | 1 回のみ（初回の支払いだけ）、複数の請求サイクル、または永続。単発商品は常に 1 回のみ割引されます |
| プロモーションコード | はい | 3〜32 文字の英数字または `-`、大文字小文字は区別しません。このストアの他の有効なコードと重複できません |
| 有効期限 | いいえ | その日（自分のタイムゾーン）の終わりまで利用可能。クーポンが期限切れになると、サブスクリプションに適用済みの割引も終了します |
| 利用上限 | いいえ | クーポン全体で利用できる回数。すべてのプロモーションコードで共有されます |

> [!NOTE]
>
> 有料トライアル期間は割引を消費します。「1 回のみ」のクーポンはトライアルで使い切られ、複数サイクルのクーポンはトライアルを最初のサイクルとして数えます。無料トライアルは割引を消費しません。

### 作成時にプロモーションコードを追加する

**プロモーションコードを追加**をオンにすると、作成時に同じクーポンの追加コードを配布できます。条件付きの個別コードを最大 20 個、またはプレフィックス付きで一括生成します。追加コードはどれも同じクーポン・同じ割引を適用し、利用回数と有効期限はクーポンを超えられません。作成後にクーポンの詳細から追加することもできます。

## クーポンの詳細

一覧の行をクリックすると詳細が開きます。パネルには割引、デフォルトのプロモーションコード、期間、利用回数と上限、有効期限、対象商品、すべてのプロモーションコードが表示されます。

![Coupon details](https://mintcdn.com/waffo/fzyQe5Jh5yF_yUiY/images/dashboard/discounts-detail.png?fit=max\&auto=format\&n=fzyQe5Jh5yF_yUiY\&q=85\&s=073f24c5e9fa5a0e15b7d36eb4f4a19f)

ここでできること：

* クーポンの**名前を変更**
* **プロモーションコードを追加**（個別または一括、後述）
* プロモーションコードを **CSV でエクスポート**
* クーポンまたは個別のプロモーションコードを**無効化**
* テストモードのクーポンを**本番環境へコピー**

### プロモーションコード

購入者がクーポンのどのコードをチェックアウトで入力しても、適用されるのはそのクーポンです。プロモーションコードは独自の条件を追加するだけです。

| 条件 | 説明 |
| - | - |
| 特定の購入者のみ利用可能 | 購入者のメールアドレス。カンマまたは改行で区切ります |
| このコードは最大 N 回まで利用可能 | クーポンの上限を超えられません |
| 各購入者は最大 N 回まで利用可能 | 購入者ごとの累計利用回数 |
| このコードの有効期限 | クーポンの有効期限より後にはできません |
| 最低注文金額 | 通貨ごと、割引前・税抜きの金額。その他の通貨には最低額がありません |

コードは**すべて / 有効 / 無効化**で絞り込むか、コードで検索できます。コードは個別に無効化できます。無効化は取り消せず、そのコードは新しいプロモーションコードで再利用できます。

> [!NOTE]
>
> 無効化済み、期限切れ、または作成に失敗したクーポンには、プロモーションコードを追加できません。

### コードの一括生成

**プロモーションコードを追加**で**一括生成**に切り替えると、一度に最大 500 個のコードを生成できます。任意のプレフィックス（最大 12 文字）を付け、すべてのコードに同じ条件を設定します。たとえばニュースレター向けの 1 回限りコードなどに使えます。生成後はすべてコピーするか CSV でダウンロードでき、CSV はクーポンの詳細からいつでも再エクスポートできます。

![Generated promotion codes](https://mintcdn.com/waffo/fzyQe5Jh5yF_yUiY/images/dashboard/discounts-generated.png?fit=max\&auto=format\&n=fzyQe5Jh5yF_yUiY\&q=85\&s=810ffc9166b0e92141b693a93c6c1458)

### クーポンの無効化

無効化は取り消せません。クーポンとそのすべてのプロモーションコードは新規注文で使えなくなり、コードは再利用のために解放されます。すでにサブスクリプションに適用されている割引は、そのサブスクリプションの次回プラン変更まで続きます。[割引とプロモーション](https://docs.waffo.ai/ja/guides/discounts.md#when-the-discount-ends)を参照してください。

## 本番環境へコピー

ストアの審査に通過すると、テストモードで作成したクーポンを詳細から本番環境へコピーできます。コピーは同じ設定の新しいクーポンで、利用回数は 0 から始まります。任意で、有効かつ期限内のプロモーションコードを同じ条件のまま一緒にコピーできます。

* 本番環境に未公開の商品はコピーに含まれません。クーポンの商品がどれも公開されていない場合は、先に商品を公開してください。
* クーポンの有効期限がすでに過ぎている場合、本番のクーポンは期限なしになり、期限切れのプロモーションコードはコピーされません。
* 本番ですでに使われているコードがあるとコピーは中止されます。先に本番でそのコードを無効化するか、プロモーションコードなしでコピーしてください。

## 次のステップ

> **[割引とプロモーション](https://docs.waffo.ai/ja/guides/discounts.md)**
>
> チェックアウトでのコードの検証と、サブスクリプションの割引

> **[クーポンエンドポイント](https://docs.waffo.ai/ja/api-reference/endpoints/coupons/overview.md)**
>
> サーバーからクーポンとプロモーションコードを作成


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.