折扣碼
了解如何讓購物者在結帳時使用折扣碼,依比例減免付費訂單金額。
折扣碼可降低購物者購買商品目錄中付費商品時所需支付的金額。禮品碼與免費物品則用於免費發放獎勵。折扣碼適用於這些付費商品的一次性購買:Tokenz 依折扣比例減免每件商品的單價,再依折後價格計算稅費並收款。
在 Tokenz 控制台建立活動,再將購物者引導至 Tokenz Checkout。購物者可在付款前新增或移除折扣碼。
概覽
折扣碼活動包含:
- 折扣比例:為活動設定統一的折扣比例,適用於整筆訂單。
- 折扣碼:一個或多個折扣碼,共用相同的折扣比例、活動有效期間與活動上限
- 每筆訂單限用一個折扣碼:必須先移除目前的折扣碼,才能使用另一個
- 僅限一次性購買:訂閱結帳與支付閘道訂單不支援折扣碼
活動設定與管理
在 Tokenz 控制台建立並管理折扣碼活動。若控制台中尚未顯示折扣碼,請聯絡 Tokenz 支援確認您的帳戶是否已開通。
在 Tokenz 控制台,您可以:
- 命名活動並新增描述
- 設定 1% 至 99% 的折扣比例
- 新增共用該折扣比例的一個或多個折扣碼
- 設定活動總使用次數上限、每位接收者的使用次數上限與活動預算
- 為個別折扣碼設定使用次數上限,但不得超過活動的總使用次數上限
- 發布、暫停、恢復或結束活動
折扣碼活動使用與禮品碼活動相同的狀態:
draft:草稿,尚未完成設定。折扣碼不可使用,所有欄位皆可編輯。scheduled:已發布,等待活動開始。到達設定的開始時間後,即可使用折扣碼。active:活動進行中,可使用折扣碼。paused:已手動暫停,折扣碼不可使用。可恢復為active。ended:活動已結束,折扣碼不可使用。此狀態不可逆。
折扣碼本身的狀態為 active 或 deactivated。即使活動處於 active 狀態,已停用(deactivated)的折扣碼也不可使用。
接收者識別碼
每位接收者的使用次數上限依據結帳工作階段中的接收者識別碼 customerInfo.recipientId 計算。Tokenz 將其視為您為接收此次購買的帳號分配的識別碼,不會到遊戲系統中查詢。
若使用商戶自有商店,請在建立結帳工作階段時設定 customerInfo.recipientId。在預設的 Merchant of Record 模式下,未提供該欄位建立的結帳工作階段會被 API 拒絕。若使用 Tokenz Web Shop,Tokenz 會從商店工作階段中取得接收者識別碼。
無論活動是否設定每位接收者的使用次數上限,傳入的接收者識別碼均須遵循以下規則:
- 去除首尾空白
- 空值會被拒絕
- 長度不得超過 100 個字元
- 依完整內容比對,區分大小寫
接收者識別碼區分大小寫。 Player_123 與 player_123 會被視為不同的接收者,各自擁有獨立額度。同一接收者的每次結帳都應使用固定且一致的識別碼,包括大小寫。即使玩家從其他裝置或工作階段結帳,只要識別碼一致,仍會被視為同一接收者。
只要結帳工作階段中有接收者識別碼,即使活動未設定每位接收者的使用次數上限,Tokenz 也會將該接收者記錄在活動中。
結帳所需資訊
依購物者選購的付費商品建立結帳工作階段。請將 customerInfo.recipientId 設定為接收此次購買的帳號。折扣碼的使用會記錄到該接收者名下,每位接收者的使用次數上限也依該接收者計算。
商品價格為您的售價。折扣碼不會建立或變更價格方案。
結帳工作階段中提供的優惠券與點數會先從訂單金額中扣除,再依折扣碼的比例減免剩餘金額。折扣碼與優惠券、點數不會相互取代。
以未稅定價為例,一件售價 ¥1,000 的商品,使用價值 ¥100 的點數折抵後,在套用折扣碼前的金額為 ¥900。購物者沒有優惠券或點數時,無需傳入相應資訊。
結帳過程中
在 Tokenz Checkout 中,購物者可輸入折扣碼、查看更新後的總金額、移除折扣碼,或改用另一個折扣碼。每筆訂單同時只能使用一個有效的折扣碼。Tokenz 會去除折扣碼首尾的空白,其餘內容須完全相符,包括大小寫。
購物者套用折扣碼時,Tokenz 會驗證其有效性,並從活動的可用次數與預算中為該訂單預留額度。移除折扣碼會釋放預留額度,並恢復原價。付款成功後,預留的使用次數與預算會正式計為已使用。若訂單失敗、取消、遭阻擋或因未付款而過期,預留額度也會釋放。請參閱預留與上限。
在上述未稅定價的例子中,使用折扣比例為 20% 的折扣碼,可從點數折抵後剩餘的 ¥900 中再減免 ¥180。折後的稅前金額為 ¥720,稅費依 ¥720 計算。價值 ¥100 的點數折抵仍保留在訂單中,折扣碼本身帶來的減免金額為 ¥180。
價格與稅費
折扣依每件商品折抵優惠券與點數後的單價計算,並沿用您現有的含稅或未稅設定:含稅價格的折後金額已包含稅額;未稅價格則在折後金額上另加稅額。由於金額按每件商品分別進行捨入,總折扣金額可能與直接依訂單總額計算的折扣略有差異。
預算
活動預算是整個活動可提供的折扣金額上限,以預算幣別計價。此上限適用於整個活動,而非單筆訂單。
套用折扣碼時,Tokenz 會將該訂單的全部折扣金額換算為預算幣別,並預留相應預算。如果剩餘預算不足以涵蓋全部折扣金額,折扣碼將遭拒絕。Tokenz 不會為了配合剩餘預算而降低折扣比例。
付款成功後,預留預算會正式計為已使用。移除折扣碼,或訂單失敗、取消、遭阻擋或過期時,預留預算會釋放。退款不會返還已使用的預算。
折扣限制
折扣比例必須介於 1%–99%。如果折扣碼會使應付金額降為零,則無法使用。此類活動不支援固定金額折扣、僅針對單一商品的折扣、最低訂單金額限制、單筆訂單最高折扣金額限制,也不支援疊加使用多個折扣碼。
預留與上限
購物者在結帳時套用折扣碼後,Tokenz 會為該訂單預留額度。預留額度會立即占用可用次數與預算,而非等到付款時才扣除。這樣可以避免多名購物者在結帳尚未完成時,同時占用同一份額度而突破上限。
預留生效期間,會占用以下額度:
- 占用活動總使用額度中的 1 次
- 折扣碼設有獨立上限時,占用該碼使用額度中的 1 次
- 結帳工作階段中有接收者識別碼且活動設有每位接收者上限時,占用該接收者使用額度中的 1 次
- 從活動預算中預留相應的折扣金額
訂單等待付款時,初始預留有效期限為 5 分鐘。成功延長預留期限後,會從該時刻起重新計時。延長期限有 30 秒冷卻時間;冷卻期間的請求不會延長期限,已到期的預留也無法透過此方式恢復。
每當訂單重新進入等待付款狀態(包括付款遭拒後),這 5 分鐘的期限都會重新計算。
付款處理期間,預留額度會保留,直到該次付款成功、失敗或過期。如果目前的預留期限已過且沒有正在處理的付款,Tokenz 會釋放預留額度並移除折扣碼,價格將恢復為未使用折扣碼時的金額。
預留額度會計入以下上限:
- 活動總使用次數上限:涵蓋所有折扣碼與接收者的使用次數。達到上限後,將無法再套用折扣碼。
- 單碼使用次數上限:適用於設有獨立上限的折扣碼。預留生效期間,會同時占用單碼與活動的可用次數。付款成功後計為已使用;移除折扣碼或釋放預留時,會恢復預留的可用次數。單碼上限不得超過活動總上限。
- 每位接收者的使用次數上限:適用於個別接收者。達到上限後,該接收者將無法再使用折扣碼,其他接收者不受影響。如果活動設有此上限,結帳時未提供接收者識別碼也將無法使用折扣碼。
未通過驗證的折扣碼不會產生額度預留。
訂單與退款
訂單成功後,會保留活動、折扣碼、折扣比例與折扣金額等資訊。請依現有的成功訂單處理流程交付已付款的商品。系統不會另行傳送折扣碼使用通知,您也無需發放獎勵。
退款以購物者實際支付的金額為準,部分退款依折後單價計算。退款不會恢復已扣除的活動總使用額度、折扣碼使用額度、接收者使用額度或預算。
無法使用折扣碼的情況
折扣碼無法使用時,購物者會在結帳時看到錯誤提示,價格保持不變。以下情況會導致折扣碼遭拒絕:
- 訂單已有折扣碼。必須先移除才能輸入另一個。
- 結帳工作階段用於訂閱。
- 訂單為支付閘道訂單。折扣碼僅適用於 Merchant of Record(MoR)模式下的購買。
- 折扣碼會使應付金額降為零。
- 活動設有每位接收者的使用次數上限,但結帳工作階段中未提供接收者識別碼;或傳入的識別碼無效(無論是否設定每位接收者上限)。
- 結帳工作階段未提供地區資訊,無法重新計算稅費。
- 帳戶尚未設定自動稅費計算。
- 訂單不再處於等待付款狀態。
- 目前帳戶中找不到該折扣碼,或該碼屬於另一模式(測試或正式)。
- 折扣碼未處於
active狀態。 - 折扣碼已達自身的使用次數上限。
- 活動不可用,例如仍為草稿、已暫停、已結束,或已排程但尚未開始。
- 活動已達或超過結束時間。
- 該碼不屬於折扣碼活動。
- 活動已達總使用次數上限。
- 該接收者已達每位接收者的使用次數上限。
- 活動剩餘預算不足以涵蓋本訂單的全部折扣金額。
測試
試用活動時請使用測試模式:
- 在 Tokenz 控制台的測試模式下建立活動及其折扣碼。
- 測試模式下的活動與折扣碼和正式資料相互隔離。測試結帳只能使用測試折扣碼,正式結帳只能使用正式折扣碼。
- 在 Tokenz Checkout 中套用折扣碼、移除折扣碼並完成測試付款。套用折扣碼後應顯示折後總金額;移除折扣碼後應恢復原價;測試訂單成功後應保留折扣資訊。