割引

​

割引コードとは？

• 季節キャンペーン: ブラックフライデー、製品発売、または周年記念
• 獲得オファー: 初回購入インセンティブや紹介報酬
• 保持: 既存顧客に対する再獲得またはロイヤルティ報酬
• B2Bディール: プライベートコードを通じた契約または交渉による価格設定

​

主な利点

• 柔軟な割引: 割合ベースまたは定額の割引
• スタック可能なコード: 1回のチェックアウト、支払い、またはサブスクリプションで最大20個のコードを適用 — 個別のコードを作成せずにキャンペーンを組み合わせられます（例: WELCOME10 + BLACKFRIDAY20）
• 対象を絞った制御: 商品、サブスクリプションサイクル、顧客の利用資格による制限
• キャンペーン管理: 開始日の予約、終了日、全体および顧客ごとの利用上限
• 通貨ごとの価格設定: 通貨ごとに定額控除額、金額上限、最低小計を設定
• シームレスなチェックアウト: checkout sessions によるUIフィールドおよびAPIのサポート

​

割引コードの作成

​

ダッシュボードの設定

• Discount Name（必須）: 内部およびダッシュボードに表示する名前
• Code（必須）: 顧客がチェックアウト時に入力する文字列。表示されるボタンを使ってランダムなコードを生成することもできます
• Type（必須）: Percentage（割合による値引き）または Amount（定額控除）を選択
• Amount（必須）: 割合の値、または Amount 割引の定額
• Start Date（任意）: コードを後から有効にするよう予約。すぐに有効にする場合は空欄のままにします
• Expiration Date（任意）: コードが無効になる日付
• Usage Limit（任意）: すべての顧客を対象とした合計利用回数の上限
• Per-Customer Usage Limit（任意）: 1人の顧客が利用できる回数の上限。両方を設定する場合、全体の利用上限以下である必要があります
• Customer Eligibility（任意）: コードを利用できる顧客を制限 — すべての顧客、初回購入の顧客、既存の顧客、または指定した顧客リスト
• Currency Options（任意）: 通貨ごとの値 — Per-Currency Options を参照
• Product Restriction（任意）: 選択した商品にのみ適用を制限
• Subscription Cycle Limit（任意）: 割引を適用する請求サイクル数
• Preserve on Plan Change（任意）: サブスクリプションのプラン変更後も割引を有効なまま維持 (preserve_on_plan_change)
• Metadata（任意）: 内部追跡や統合のためにカスタムのキーと値のペアを付加

​

割引タイプ

​

顧客の利用資格

​

通貨ごとのオプション

• Amount — Amount 割引では控除額そのもの、Percentage 割引ではコードによる値引き額の上限です。API上では max_amount_possible に対応します。
• Minimum subtotal — カートの小計がこの金額に達した場合にのみコードが適用されます。0 は下限なしを意味します。
• Default — 未設定の通貨が変換元として使用するデフォルトとして、1つのエントリを指定できます。

​

チェックアウト体験

1. 購入者がチェックアウトフィールドにコードを入力します。
2. 利用可能な割引が適用され、合計額がすぐに更新されます。

​

割引コードのスタッキング

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  discount_codes: ['WELCOME10', 'BLACKFRIDAY20'], // applied in this order
  customer: { email: 'user@example.com' },
  return_url: 'https://yoursite.com/return'
});

​

API管理

​

一般的なユースケース

• 導入キャンペーン: 新商品の期間限定ローンチプロモーション
• 大量購入またはB2B: 特定の商品セット向けの契約割引
• リテンション施策: 解約防止ワークフローでの離脱顧客向けコード
• 季節キャンペーン: 祝日やイベントに基づくプロモーション

​

統合例

​

Metadata を使った割引の作成

const discount = await client.discounts.create({
  type: 'percentage',
  amount: 1500, // 15%
  code: 'SUMMER2025',
  metadata: {
    campaign: 'summer_promo',
    source: 'email_blast'
  }
});

​

Checkout Sessions での割引適用

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'pdt_abc', quantity: 1 }
  ],
  discount_codes: ['BLACKFRIDAY2024', 'NEWUSER5'], // stacked in array order
  customer: { email: 'user@example.com', name: 'Jane Doe' },
  return_url: 'https://yoursite.com/return'
});

​

プラン変更時の割引適用

await client.subscriptions.changePlan('sub_123', {
  product_id: 'pdt_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  discount_codes: ['UPGRADE20']
});

​

割引コードフィールドを非表示にする

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'pdt_abc', quantity: 1 }
  ],
  feature_flags: {
    allow_discount_code: false
  },
  return_url: 'https://yoursite.com/return'
});

​

ベストプラクティス

• 明確な名前を付ける: キャンペーン名と一致する、認識しやすいコードを使用
• 期間を限定する: 緊急性を高め、不正利用を防ぐために有効期限を設定
• 適用範囲を適切にする: 利益率の漏出を避けるため、特定の商品に限定
• 早期に検証する: チェックアウトを確定する前にコードの適用可否を確認
• 効果を監視する: キャンペーンごとに利用状況とコンバージョンを追跡