> ## 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.

# 割引とプロモーション

> クーポンとプロモーションコードで販促を行う：公開コード、チャネル別コード、使い切りコード、サブスクリプション割引

## 概要

Waffo Pancake には**クーポン**と**プロモーションコード**が組み込まれています。クーポンは「いくら割引するか」を定義します。割合または固定額の割引で、対象商品、合計利用回数、有効期限を制限できます。プロモーションコードは「誰が使えるか」を定義します。1 枚のクーポンに複数のプロモーションコードを発行でき、コードごとに購入者の制限を設定できます。どちらも **Dashboard → クーポン** で作成でき、API や SDK からも作成できます。

割引は**単品商品、新規サブスクリプション、プラン変更**に適用されます。クーポンは 1 つのストア・1 つの環境に属し、テストモードで作成したコードは本番モードでは使えません。

***

## クーポンとプロモーションコード

| ルール | 設定先 | 説明 |
| - | - | - |
| 割引方法 | クーポン | 割合、または通貨ごとの固定額 |
| 対象商品 | クーポン | ストア全体、または一部の商品のみ |
| 有効期限 | クーポン、プロモーションコード | 期限後は使用不可。プロモーションコードの期限はクーポンより後にできません |
| 合計利用回数 | クーポン、プロモーションコード | 全購入者の合計利用回数 |
| 対象購入者 | プロモーションコード | 指定した購入者メールアドレスのみ |
| 購入者ごとの回数 | プロモーションコード | 1 人の購入者が使える回数 |
| 最低注文額 | プロモーションコード | 通貨ごとに設定し、割引前・税抜の金額で判定 |

コードは大文字と小文字を区別しません。クーポン詳細ではコードごとの利用回数を確認でき、CSV のエクスポートや、他のコードに影響させずに特定のコードだけを無効化することもできます。

***

## 購入者の利用方法

> [card] チェックアウトで入力
>
> ストアに利用可能なクーポンがあると、商品ページにコード入力欄が表示され、購入者がコードを入力します。

> [card] コード付きリンク
>
> 商品リンクに `?discount_code=XXX` を付けると、開いた時点で割引が適用されます。広告やメール配信に最適です。

> [card] サーバー側で適用
>
> Checkout Session の作成時にクーポンまたはプロモーションコードを指定します。会員価格やパートナー価格などコードを見せたくない場合は `couponId` で適用すると、購入者にはコードが表示されず、解除もできません。

***

## よくあるシナリオ

| シナリオ | 設定方法 |
| - | - |
| 新商品の期間限定セール | クーポン 1 枚に公開コード、有効期限と利用上限を設定 |
| インフルエンサー・チャネル連携 | クーポン 1 枚にパートナーごとのプロモーションコードを発行し、それぞれ上限を設定。コード別の利用数で精算 |
| メルマガや抽選 | クーポン上で使い切りコードを一括生成（1 回最大 500 件、プレフィックス可）し、CSV をメールに差し込む |
| 休眠顧客の呼び戻し・VIP リスト | 購入者メールアドレスを限定したプロモーションコード。コードが漏れても問題なし |
| 会員価格・パートナー価格 | 購入者の資格に応じてサーバー側で `couponId` を付けてセッションを作成。コードは表示されない |
| 最初の数か月割引、年額への誘導 | 割引期間（初回のみ、複数期間、サブスクリプション全期間）を設定するか、クーポンを年額プランに限定 |

各シナリオの具体的な設定とコード例は[割引とプロモーションガイド](https://docs.waffo.ai/ja/guides/discounts.md)をご覧ください。

***

## サブスクリプションの割引

サブスクリプションの割引には**期間**を設定できます。初回のみ、指定した請求期間数、またはサブスクリプション全期間です。無料トライアルは割引を消費せず、最初の有料期間から割引が始まります。購入者がポータルでプランを変更する際は、新しいコードを入力して現在の割引を置き換えられます。コードを入力しない場合、引き継げる範囲で現在の割引が継続します。領収書、更新、プラン変更のメールには定価、割引行、次回の請求予定額が表示されます。

***

## 関連リンク

* [割引とプロモーションガイド](https://docs.waffo.ai/ja/guides/discounts.md) — ルールの詳細、マーケティングシナリオ、SDK サンプル
* [Dashboard クーポンページ](https://docs.waffo.ai/ja/dashboard/discounts.md) — クーポンの作成、コードの一括生成、利用状況の確認
* [クーポン API](https://docs.waffo.ai/ja/api-reference/endpoints/coupons/overview.md) · [プロモーションコード API](https://docs.waffo.ai/ja/api-reference/endpoints/promotion-codes/overview.md)


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