割引を追加

クーポンやプロモーションコードで小計を割引して、顧客への請求金額を減らします。

割引を使用して、顧客への請求額を減らすことができます。クーポンとプロモーションコードで、次のことができます。

購入全体の小計に対して割引を適用する
特定の商品に割引を適用する
パーセントや一定額を使用して請求の合計を減らす
クーポンに加えて顧客向けのプロモーションコードを作成し、顧客に直接提供する

クーポンを作成する

クーポンは固定額の割引を指定します。1 つのベースとなるクーポンにマッピングされる、顧客向けのプロモーションコードを作成できます。つまり、FALLPROMO と SPRINGPROMO の両方のコードを 1 つの 25% 割引のクーポンに関連付けることができます。クーポンは、ダッシュボードまたは API で作成できます。

クーポンを使用する

割引が適用されたセッションを作成するには、discounts 配列の coupon パラメーターにクーポン ID を渡します。Checkout セッションは、最大 1 つのクーポンまたはプロモーションコードをサポートします。

クーポンを設定する

クーポンには、使用可能な次のパラメーターがあります。

currency
percent_off または amount_off
max_redemptions
redeem_by (顧客がクーポンを適用できる最終日)
applies_to はクーポンが適用される商品を限定します

引き換えの使用を制限する

max_redemptions および redeem_by の値は、すべてのアプリケーションのクーポンに適用されます。たとえば、クーポンを最初の 50 回の使用に制限したり、クーポンを特定の日付までに期限切れにしたりできます。

対象の商品を制限する

Coupon オブジェクトの applies_to ハッシュに商品 ID を追加することで、クーポンを使用した割引の対象商品を限定できます。このクーポンにマッピングされたプロモーションコードも、この対象商品のリストにのみ適用されます。

クーポンを削除する

ダッシュボードまたは API を介してクーポンを削除できます。クーポンを削除すると、そのクーポンは以降の取引や顧客に適用できなくなります。

プロモーションコードを作成する

プロモーションコードは、クーポンに加えて作成される顧客向けのコードです。また、顧客がプロモーションを適用できる期間を管理する追加の制限を指定することもできます。これらのコードは顧客に伝えることができ、顧客が購入時に入力すると割引の適用を受けることができます。

promotion code (プロモーションコード) を作成するには、既存の coupon と制限 (たとえば、特定の customer に制限するなど) を指定します。顧客に提供したい特定のコードがある場合には (FALL25OFF など)、code を設定します。このフィールドを空白にすると、ランダムな code が生成されます。

この code では大文字小文字が区別され、すべての顧客向けの有効なプロモーションコードの中で一意になります。以下に例を挙げます。

同じ code を使用して、対象の顧客が制限された複数のプロモーションコードを作成できますが、その code を再利用して、すべての顧客が引き換えできるプロモーションコードを作成することはできません。
あらゆる顧客が引き換え可能なプロモーションコードを作成する場合、同じ code で別の有効なプロモーションコードを作成することはできません。
code: NEWUSER でプロモーションコードを作成し、active: false を渡してそれを無効化してから、code: NEWUSER で新しいプロモーションコードを作成できます。

プロモーションコードは、ダッシュボードのクーポンセクションまたは API で作成できます。

プロモーションコードを使用する

サーバーの Checkout セッションで allow_promotion_codes パラメーターを使用して、顧客が引き換えできるプロモーションコードを有効にします。

クライアントで、applyPromotionCode を使用して、顧客が入力するプロモーションコードを適用します。removePromotionCode を使用して、これまで適用されたすべてのプロモーションコードを削除します。

index.html
<input type="text" id="promotion-code" />
<button id="apply-promotion-code">Apply</button>
<button id="remove-promotion-codes">Remove</button>
<div id="promotion-code-error"></div>

checkout.js
stripe.initCheckout({fetchClientSecret}).then((checkout) => {
  const input = document.getElementById('promotion-code');
  document.getElementById('apply-promotion-code').addEventListener('click', () => {
    checkout.applyPromotionCode(input.value).then((result) => {
      if (result.error) {
        // Display an error message
        document.getElementById('promotion-code-error').textContent = result.error.message;
      } else {
        // Clear the input if the promotion code was successfully applied
        input.value = '';
      }
    });
  });
  document.getElementById('remove-promotion-codes').addEventListener('click', () => {
    checkout.removePromotionCode();
  });
});

プロモーションコードを設定する

プロモーションコードごとに、対象の顧客、引き換え回数、その他の制限をカスタマイズできます。

特定の顧客に限定する

プロモーションを特定の顧客に限定するには、プロモーションコードを作成する際に customer (顧客) を指定します。顧客が指定されていない場合、すべての顧客がコードを引き換えることができます。

初回注文に限定する

また、restrictions.first_time_transaction を使用して、プロモーションコードを初めての顧客のみに限定することもできます。customer が定義されていない場合、または定義された customer が過去に支払いをしたことがない場合や、無効化されていないインボイスがない場合は、初回の取引とみなされます。

注

セッションで Customer (顧客) が作成されない場合、代わりにゲスト顧客がダッシュボードに作成されます。新規の顧客に限定されたプロモーションコードも、これらのセッションでは受け付けられます。

最低金額を設定する

プロモーションコードでは、minimum_amount と minimum_amount_currency を設定して、割引対象の最低取引額を設定できます。プロモーションコードの制限は引き換え時に確認されるため、最低取引額はサブスクリプションの初回の支払いにのみ適用されます。

有効期限をカスタマイズする

expires_at を使用してプロモーションコードの有効期限を設定できます。ベースとなるクーポンにすでに redeem_by が設定されている場合には、プロモーションコードの期限をクーポンの期日よりも後にすることはできません。promotion_code[expires_at] が指定されていない場合は、クーポンの redeem_by が自動的に expires_at となります。

たとえば、クーポンを 1 年間サポートするプランがあり、引き換え期間を顧客がクーポンを受け取ってから 1 週間以内にするとします。その場合、coupon[redeem_by] を現在から 1 年後にし、各 promotion_code[expires_at] を作成日の 1 週間後に設定できます。

引き換え回数を制限する

max_redemptions を使用して引き換え回数を制限できます。これは coupon パラメーターと同様に機能します。ベースとなるクーポンにすでに max_redemptions が設定されている場合、プロモーションコードの max_redemptions をクーポンの上限値より大きくすることはできません。

たとえば、シーズンセールのクーポンの引き換えを先着 50 人の顧客に制限する一方で、冬のプロモーションで引き換えを利用できる対象を 20 人のみにすることができます。このシナリオでは、coupon[max_redemptions]: 50 および promotion_code[max_redemptions]: 20 を設定できます。

無効なプロモーション

active パラメーターを使用して、プロモーションコードが現在引き換え可能かどうかを設定できます。ただし、プロモーションのベースとなるクーポンが無効になると、そのプロモーションコードはすべて永久に無効になります。同様に、プロモーションコードが max_redemptions や expires_at に達した場合にも、永久に無効になります。これらのプロモーションコードを再度有効にすることはできません。

プロモーションを削除する

ダッシュボードまたは API を使用して、プロモーションを削除できます。プロモーションを削除すると、そのプロモーションは今後の取引や顧客に適用できなくなります。