クーポン

チェックアウト時にお客様が使用できる割引コードを作成します。割合または固定金額、期間限定またはキャップ付き、一回限りまたは継続利用に対応。

クーポンは、アプリの Admin > Commerce > Products 内の Coupons セクション、および公開済みアプリの管理パネルの Cupones タブで管理します。

クーポンの構成要素

フィールド	説明
code	チェックアウト時にお客様が入力するプロモコード（例：LAUNCH20）
percent_off または amount_off	互いに排他的です。パーセントは1〜100。金額は最小通貨単位（セント）で指定します。
currency	amount_off 割引には必須（3文字のISOコード）。作成時に受け付けられ Stripe に転送されますが、その後はAPIによる保存・返却は行われません。
duration	once（初回支払いのみ）、repeating（duration_in_months の期間中）、または forever
duration_in_months	duration が repeating の場合に必須
max_redemptions	全顧客を合計した上限回数
redeem_by	クーポンが無効になる有効期限
name	お客様に表示される名称
active	削除せずに有効・無効を切り替えるトグル

クーポンを作成する

Coupons サブタブから Add coupon をクリックし、各フィールドを入力します。よくある設定例を以下に示します。

目的	設定
永続20%オフ	percent_off: 20、duration forever
$10オフ、一回限り、30日後に有効期限切れ	amount_off: 1000、currency USD、duration once、max redemptions 1、redeem-by 30日後
サブスクリプションの最初の3ヶ月間50%オフ	percent_off: 50、duration repeating、duration in months 3

AIに直接依頼することもできます："Create a LAUNCH20 coupon for 20% off forever."

チェックアウト時にクーポンを適用する

お客様がコードを使用する方法は2つあります。

• Stripe のチェックアウトページ上 — プロモコードのフィールドが自動的に表示されるため、お客様はそこでコードを入力するだけで、追加の実装は不要です。
• 独自のカート内 — カートにプロモコード入力フィールドを追加し、入力された値を couponCode としてチェックアウト呼び出しに渡します。サーバーがコードを検証し、コマースデータ（ブラウザが提供する金額ではなく）から割引額を計算してオーダーに記録し、対応する Stripe クーポンを紐付けることで正確な請求が行われます。

AIに依頼する場合："Add a promo code field to the cart and apply it at checkout."

一覧表示・更新・無効化

Coupons サブタブには、すべてのクーポンが上限回数に対して何回使用されたかとともに一覧表示されるため、キャンペーンのパフォーマンスをひと目で確認できます。編集できる項目は意図的に制限されています（下記参照）が、クーポンを削除せずに無効化することができ、即座にチェックアウトでの使用を停止できます。

注意事項と制限

• コードと割引金額は変更できません。 表示用の name の変更や active の切り替えは可能ですが、percent_off、amount_off、code 自体は変更できません。条件を変更したい場合は新しいクーポンを作成してください。
• times_redeemed は自動的にインクリメントされる読み取り専用の値で、キャンペーンのパフォーマンス追跡に役立ちます。
• クーポンは注文単位ではなく顧客単位で適用されます — クーポンが forever に設定されている場合、そのお客様がサブスクリプションを継続する限り、更新のたびに割引が適用されます。