割引コード
チェックアウト時に入力された割引コードを使って、注文金額を一定の割合で割り引く方法を説明します。
割引コードを使うと、カタログ内の有料商品の購入金額を割り引くことができます。ギフトコードや無料アイテムが無償で報酬を付与するのに対し、割引コードは有料商品の都度購入に適用されます。Tokenz は各商品の単価に割引率を適用し、割引後の価格を基に税額を計算して、合計金額を請求します。
Tokenz Dashboard でキャンペーンを作成し、購入者を Tokenz Checkout に誘導します。購入者は支払い前に割引コードを追加・削除できます。
概要
割引コードキャンペーンには、次の設定と制限があります。
- 割引率:キャンペーンに設定する割引率です。注文全体に適用されます。
- コード:同じ割引率、実施期間、キャンペーン上限を共有する、1 つ以上のコードです。
- 注文あたり 1 コード:別のコードを適用するには、先に適用済みのコードを削除する必要があります。
- 都度購入のみ:サブスクリプションのチェックアウトや、決済ゲートウェイ方式の注文には適用できません。
キャンペーンの設定と管理
割引コードキャンペーンは Tokenz Dashboard で作成・管理します。Dashboard に割引コードがまだ表示されない場合は、お客様のアカウントで利用できるか、Tokenz サポートにお問い合わせください。
Tokenz Dashboard では、次の操作ができます。
- キャンペーン名と説明の設定
- 割引率の設定(1〜99%)
- 同じ割引率を共有するコードの追加
- キャンペーン全体の利用上限、受取人ごとの利用上限、キャンペーン予算の設定
- 個別コードの利用上限の設定(キャンペーン全体の利用上限以下)
- キャンペーンの公開、一時停止、再開、終了
割引コードキャンペーンは、ギフトコードキャンペーンと同じステータスを使用します。
draft:下書きです。コードは適用できません。すべてのフィールドを編集できます。scheduled:公開済みで開始待ちです。設定した開始時刻になると、コードを適用できます。active:実施中です。コードを適用できます。paused:手動で一時停止しています。コードは適用できません。再開するとactiveに戻ります。ended:終了しています。コードは適用できません。この状態からは戻せません。
割引コード自体のステータスは active または deactivated です。deactivated のコードは、キャンペーンが active でも適用できません。
受取人識別子
受取人ごとの利用上限は、チェックアウトの受取人識別子 customerInfo.recipientId を使って管理します。Tokenz はこれを、購入を受け取るアカウントに対してマーチャントが管理する識別子として扱い、マーチャントのゲームに問い合わせて照合することはありません。
マーチャントが運営するショップでは、チェックアウトの作成時に customerInfo.recipientId を指定してください。デフォルトの Merchant of Record モデルでは、これを指定せずに作成したチェックアウトは API で拒否されます。Tokenz Web Shop では、ショップセッションから受取人識別子を取得します。
受取人ごとの利用上限の有無にかかわらず、指定したすべての受取人識別子に次のルールが適用されます。
- 先頭と末尾の空白を除去します。
- 空の値は受け付けません。
- 100 文字以内で指定してください。
- 大文字と小文字を区別し、完全一致で照合します。
受取人識別子は大文字と小文字を区別します。 Player_123 と player_123 は別の受取人として扱われ、利用上限も別々に適用されます。同じ受取人のすべてのチェックアウトで、大文字・小文字も含めて同じ識別子を使用してください。プレイヤーが別のデバイスやセッションからチェックアウトしても、識別子が一致すれば同じ受取人として扱われます。
チェックアウトに受取人識別子がある場合、キャンペーンに受取人ごとの利用上限がなくても、その受取人のキャンペーン利用が記録されます。
チェックアウトに渡す情報
購入対象の有料商品を指定してチェックアウトを作成します。customerInfo.recipientId には購入を受け取るアカウントを指定してください。コードの利用はその受取人に紐づけられ、受取人ごとの利用上限もその受取人に対して数えられます。
商品価格には、マーチャントが設定した販売価格を使用します。割引コードによって価格プランが作成・変更されることはありません。
チェックアウトに指定したクーポンとポイントを先に注文金額から差し引き、その残額に割引率を適用します。割引コードとクーポン・ポイントは併用され、互いに置き換わることはありません。
税抜き価格を例にすると、¥1,000 の商品に ¥100 分のポイントを適用した場合、割引コード適用前の金額は ¥900 です。購入者にクーポンやポイントがない場合は、指定を省略してください。
チェックアウト中の操作
Tokenz Checkout では、購入者は割引コードを入力して変更後の合計金額を確認したり、コードを削除したり、別のコードに変更したりできます。1 つの注文に同時に適用できる割引コードは 1 つだけです。Tokenz はコードの前後の空白を除去し、残りの文字列を大文字・小文字も含めて完全一致で照合します。
購入者がコードを適用すると、Tokenz は有効性を確認し、キャンペーンの利用枠と予算から、その注文に必要な分を確保します。コードを削除すると確保が解除され、価格が元に戻ります。支払いが成功すると、確保した利用回数と予算が使用済みとして計上されます。注文が失敗、キャンセル、ブロック、または未払いのまま期限切れになった場合も、確保は解除されます。確保期間と利用上限を参照してください。
先ほどの税抜き価格の例で 20% の割引コードを適用すると、ポイント差し引き後の ¥900 から ¥180 が割り引かれます。割引後の税抜き金額は ¥720 で、この ¥720 を基に税額を計算します。¥100 分のポイントも引き続き注文に適用されます。割引コードによる割引額は ¥180 です。
価格と税
割引率は、クーポンとポイントを差し引いた各商品の単価に適用されます。既存の税込み・税抜き設定は維持され、税込み価格では割引後の金額に税が含まれ、税抜き価格では割引後の金額に税が加算されます。端数処理は商品 1 点ごとに行うため、注文合計に割引率を一度だけ適用した場合とは、割引総額がわずかに異なることがあります。
予算
キャンペーン予算は、キャンペーンで提供できる割引額の合計の上限です。予算通貨で指定します。1 件の注文に対する上限ではなく、キャンペーン全体の上限です。
コードを適用すると、その注文の割引額全額を予算通貨に換算し、キャンペーン予算から確保します。残りの予算でその全額をまかなえない場合、コードは適用できません。Tokenz が残りの予算に合わせて割引率を下げることはありません。
支払いが成功すると、確保した予算は消費された状態になります。コードを削除した場合や、注文が失敗、キャンセル、ブロック、期限切れになった場合は、予算の確保が解除されます。返金しても、消費した予算は戻りません。
割引の適用範囲と制限
割引率は 1〜99% の範囲で指定します。支払額がゼロになるコードは適用できません。固定額の割引、特定商品のみの割引、最低注文金額、注文ごとの最大割引額、1 つの注文への複数コードの適用には対応していません。
確保期間と利用上限
購入者がチェックアウトでコードを適用すると、Tokenz はその注文に必要な利用枠と予算を確保します。確保した利用枠と予算は、支払いを待たずに、すぐに上限の計算に含まれます。これにより、複数の購入者が同時にチェックアウトしても、利用上限を超えることを防ぎます。
確保する利用回数と金額は次のとおりです。
- キャンペーン全体の利用上限に対して、利用 1 回分
- コードに独自の上限がある場合は、コードごとの利用上限に対して、利用 1 回分
- チェックアウトに受取人識別子があり、キャンペーンにその上限がある場合は、受取人ごとの利用上限に対して、利用 1 回分
- キャンペーン予算に対して、割引額の全額
支払い待ちの注文では、利用枠と予算の初回の確保期間は 5 分間です。期限内に延長が成功すると、その時点から 5 分間に更新されます。延長には 30 秒間のクールダウンがあり、その間のリクエストでは期限は延びません。期限切れの確保を延長して復元することもできません。
支払いが拒否された場合など、注文が再び支払い待ちになるたびに、5 分間の保持期間が最初から始まります。
支払い処理中は、その試行が成功、失敗、または期限切れになるまで利用枠と予算を確保したままにします。現在の確保期限が過ぎ、処理中の支払いがない場合は、確保を解除してコードを削除します。価格は割引コードを適用する前の金額に戻ります。
確保した利用回数は、次の上限にカウントされます。
- キャンペーン全体の利用上限:すべてのコードと受取人の利用回数を合計した上限です。上限に達すると、それ以降はコードを適用できません。
- コードごとの利用上限:コードに独自の上限がある場合に適用されます。確保中の利用回数は、キャンペーン全体とコードごとの両方の利用上限にカウントされます。支払いが成功すると使用済みとなり、コードの削除や確保の解除によって、確保していた利用枠が戻ります。コードごとの利用上限を、キャンペーン全体の利用上限より高く設定することはできません。
- 受取人ごとの利用上限:1 人の受取人の利用回数の上限です。その受取人が上限に達すると、以降はコードを適用できません。他の受取人には影響しません。この上限があるキャンペーンでは、チェックアウトに受取人識別子がないとコードを適用できません。
有効性の確認に失敗したコードでは、利用枠と予算は確保されません。
注文と返金
注文が成功すると、キャンペーン、コード、割引率、割引額が注文に保持されます。通常の支払い済み注文と同じ手順で、購入された商品を提供してください。コード利用に関する別の通知や、追加で付与する報酬はありません。
返金額には、購入者が実際に支払った金額を使用します。部分返金は、割引後の単価を基に計算します。返金しても、キャンペーン全体、コードごと、受取人ごとの利用枠や予算は戻りません。
コードが使えない場合
チェックアウトにエラーが表示され、価格は変更されません。次の場合はコードを適用できません。
- 注文に割引コードがすでに適用されている場合。別のコードを入力するには、先に適用済みのコードを削除する必要があります。
- チェックアウトがサブスクリプション用の場合。
- 注文が決済ゲートウェイ方式の場合。割引コードは、マーチャント・オブ・レコード(MoR)方式の購入にのみ適用できます。
- コードを適用すると支払額がゼロになる場合。
- 受取人ごとの利用上限があるのに受取人識別子が指定されていない場合、または指定された識別子が無効な場合(利用上限の有無にかかわらず)。
- チェックアウトに地域が指定されておらず、税額を再計算できない場合。
- アカウントに税額の自動計算が設定されていない場合。
- 注文がすでに支払い待ちの状態ではない場合。
- このアカウントでコードが見つからない場合、またはコードと注文のモード(テスト・本番)が異なる場合。
- コードがアクティブではない場合。
- コードが独自の利用上限に達している場合。
- キャンペーンが利用できない場合。下書き、一時停止、終了、開始時刻を迎えていない
scheduled状態のキャンペーンが含まれます。 - キャンペーンの終了時刻を迎えた、または過ぎている場合。
- コードが割引コードキャンペーンに属していない場合。
- キャンペーンが全体の利用上限に達している場合。
- 受取人が受取人ごとの利用上限に達している場合。
- キャンペーンの残り予算で、この注文の割引額全額をまかなえない場合。
テスト
キャンペーンを試す際は、テストモードを使用してください。
- Tokenz Dashboard のテストモードで、キャンペーンとコードを作成します。
- テスト用のキャンペーンとコードは、本番データから分離されます。テスト用のチェックアウトではテストコードのみ、本番用のチェックアウトでは本番コードのみ使用できます。
- Tokenz Checkout でコードを適用・削除し、テスト支払いを完了します。コード適用中は割引後の合計金額が表示され、コードを削除すると割引前の金額に戻ることを確認します。また、テスト支払いが成功した注文には、割引後の金額が保持されていることを確認してください。