割引

​

割引コードとは？

​

主な利点

• 柔軟な割引：割合ベースまたは定額の割引
• 組み合わせ可能なコード：1回のチェックアウト、支払い、またはサブスクリプションに最大20個のコードを適用
• 対象を絞った管理：商品、サブスクリプションのサイクル、顧客の利用資格による制限
• キャンペーン管理：開始日の予約、有効期限、全体および顧客ごとの使用回数上限
• 通貨ごとの価格設定：通貨ごとに定額の割引額、割引上限、最低小計を設定

​

割引コードの作成

​

Dashboardでの設定

• Discount Name（必須）：Dashboard内で使用する内部ラベル。
• Code（必須）：顧客がチェックアウト時に入力する文字列。ランダムなコードを生成するか、独自のコードを入力できます（3文字以上。自動的に大文字に変換されます）。
• Type（必須）：Percentage（割合による割引）または Amount（定額の減額）。
• Amount（必須）：Percentageの場合、Dashboardでの割引率（例：15（15%の場合））。APIでは、同じ値をベーシスポイントで指定します（1500）。Amountの場合、コードのデフォルト通貨での定額の減額。
• Start Date（任意）：将来の日付にコードを有効化するよう予約します。すぐに有効化する場合は空欄にします。
• Expiration Date（任意）：この日付を過ぎるとコードは利用できなくなります。
• Usage Limit（任意、Advanced内）：全顧客を通算した最大利用回数。
• Per-Customer Usage Limit（任意、Advanced内）：1人の顧客が利用できる最大回数。両方を設定する場合、全体の使用回数上限以下である必要があります。
• Customer Eligibility（任意）：利用できる顧客を限定します — すべての顧客、初回購入の顧客、既存顧客、または指定した顧客リストから選択できます。
• Currency Options（任意）：販売する各通貨での割引額。通貨ごとのオプションを参照してください。
• Product Restriction（任意）：コードを特定の商品に限定します。
• Subscription Cycle Limit（任意、Advanced内）：割引を適用する請求サイクル数。無期限にする場合は空欄にします。
• Preserve on Plan Change（任意）：サブスクリプションのプラン変更後も割引を有効にします（preserve_on_plan_change）。
• Metadata（任意）：内部トラッキング用のカスタムキーと値のペアを付加します。
• Require a minimum order value（任意、Advanced内）：コードを適用するために必要なカートの最低小計（通貨ごと）。

​

割引の種類

​

顧客の適用対象

​

通貨ごとのオプション

• Amount — Amount割引の場合は、その通貨での定額の減額。Percentage割引の場合は、最大割引額の上限。APIでは max_amount_possible に対応します。
• Default — 1つの通貨をデフォルトとして指定します。設定されていない通貨には、このデフォルト通貨から換算した値が使用されます。

• Minimum subtotal — カートがその通貨でこの小計に達した場合にのみコードが適用されます。0 は最低額がないことを意味します。

​

チェックアウト体験

​

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

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を付けてDiscountを作成

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

​

Checkout SessionsにDiscountを適用

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'
});

​

プラン変更時にDiscountを適用

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

​

Discount Codeフィールドを非表示にする

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'
});

​

ベストプラクティス

• 明確な名前を付ける：キャンペーン名に対応した、認識しやすいコードを使用します。
• 期間を限定する：緊急性を高め、不正利用を防ぐために有効期限を設定します。
• 適用範囲を適切に設定する：利益率の低下を防ぐため、特定の商品に限定します。
• 早期に検証する：チェックアウトを確定する前に、コードを適用できるか確認します。
• 影響を監視する：キャンペーンごとに利用状況とコンバージョンを追跡します。