割引

​

割引コードとは？

​

主な利点

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

​

割引コードの作成

​

Dashboardでの設定

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

​

一般的なユースケース

• Intro offers：新商品の期間限定ローンチプロモーション
• Bulk or B2B：選択した商品セット向けの契約割引
• Retention plays：解約防止ワークフローで使用する顧客呼び戻しコード
• Seasonal campaigns：祝日やイベントに合わせたプロモーション

​

統合例

​

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

​

ベストプラクティス

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