--- title: "折扣碼" description: "了解如何讓購物者在結帳時使用折扣碼,依比例減免付費訂單金額。" source: "https://docs.tokenz.one/zh-TW/v3/campaigns/discount-codes" api_version: "v3" locale: "zh-TW" version_status: "current" docs_stage: "prod" --- # 折扣碼 了解如何讓購物者在結帳時使用折扣碼,依比例減免付費訂單金額。 折扣碼可降低購物者購買商品目錄中付費商品時所需支付的金額。禮品碼與免費物品則用於免費發放獎勵。折扣碼適用於這些付費商品的一次性購買:Tokenz 依折扣比例減免每件商品的單價,再依折後價格計算稅費並收款。 在 Tokenz 控制台建立活動,再將購物者引導至 Tokenz Checkout。購物者可在付款前新增或移除折扣碼。 ## 概覽 折扣碼活動包含: - **折扣比例**:為活動設定統一的折扣比例,適用於整筆訂單。 - **折扣碼**:一個或多個折扣碼,共用相同的折扣比例、活動有效期間與活動上限 - **每筆訂單限用一個折扣碼**:必須先移除目前的折扣碼,才能使用另一個 - **僅限一次性購買**:訂閱結帳與支付閘道訂單不支援折扣碼 ## 活動設定與管理 在 Tokenz 控制台建立並管理折扣碼活動。若控制台中尚未顯示折扣碼,請聯絡 Tokenz 支援確認您的帳戶是否已開通。 在 Tokenz 控制台,您可以: - 命名活動並新增描述 - 設定 1% 至 99% 的折扣比例 - 新增共用該折扣比例的一個或多個折扣碼 - 設定活動總使用次數上限、每位接收者的使用次數上限與活動預算 - 為個別折扣碼設定使用次數上限,但不得超過活動的總使用次數上限 - 發布、暫停、恢復或結束活動 折扣碼活動使用與[禮品碼活動](https://docs.tokenz.one/zh-TW/v3/campaigns/gift-codes)相同的狀態: - `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 會驗證其有效性,並從活動的可用次數與預算中為該訂單**預留額度**。移除折扣碼會**釋放預留額度**,並恢復原價。付款成功後,預留的使用次數與預算會**正式計為已使用**。若訂單失敗、取消、遭阻擋或因未付款而過期,預留額度也會釋放。請參閱[預留與上限](https://docs.tokenz.one/zh-TW/v3/campaigns/discount-codes#reservations-and-limits)。 在上述未稅定價的例子中,使用折扣比例為 20% 的折扣碼,可從點數折抵後剩餘的 ¥900 中再減免 ¥180。折後的稅前金額為 ¥720,稅費依 ¥720 計算。價值 ¥100 的點數折抵仍保留在訂單中,折扣碼本身帶來的減免金額為 ¥180。 ## 價格與稅費 折扣依每件商品折抵優惠券與點數後的單價計算,並沿用您現有的含稅或未稅設定:含稅價格的折後金額已包含稅額;未稅價格則在折後金額上另加稅額。由於金額按每件商品分別進行捨入,總折扣金額可能與直接依訂單總額計算的折扣略有差異。 ### 預算 活動預算是整個活動可提供的折扣金額上限,以預算幣別計價。此上限適用於整個活動,而非單筆訂單。 套用折扣碼時,Tokenz 會將該訂單的全部折扣金額換算為預算幣別,並預留相應預算。如果剩餘預算不足以涵蓋全部折扣金額,折扣碼將遭拒絕。Tokenz 不會為了配合剩餘預算而降低折扣比例。 付款成功後,預留預算會正式計為已使用。移除折扣碼,或訂單失敗、取消、遭阻擋或過期時,預留預算會釋放。退款不會返還已使用的預算。 ### 折扣限制 折扣比例必須介於 1%–99%。如果折扣碼會使應付金額降為零,則無法使用。此類活動不支援固定金額折扣、僅針對單一商品的折扣、最低訂單金額限制、單筆訂單最高折扣金額限制,也不支援疊加使用多個折扣碼。 ## 預留與上限 購物者在結帳時套用折扣碼後,Tokenz 會為該訂單**預留額度**。預留額度會立即占用可用次數與預算,而非等到付款時才扣除。這樣可以避免多名購物者在結帳尚未完成時,同時占用同一份額度而突破上限。 預留生效期間,會占用以下額度: - 占用**活動總使用額度**中的 1 次 - 折扣碼設有獨立上限時,占用**該碼使用額度**中的 1 次 - 結帳工作階段中有接收者識別碼且活動設有每位接收者上限時,占用**該接收者使用額度**中的 1 次 - 從**活動預算**中預留相應的**折扣金額** 訂單等待付款時,初始預留有效期限為 5 分鐘。成功延長預留期限後,會從該時刻起重新計時。延長期限有 30 秒冷卻時間;冷卻期間的請求不會延長期限,已到期的預留也無法透過此方式恢復。 每當訂單重新進入等待付款狀態(包括付款遭拒後),這 5 分鐘的期限都會重新計算。 付款處理期間,預留額度會保留,直到該次付款成功、失敗或過期。如果目前的預留期限已過且沒有正在處理的付款,Tokenz 會釋放預留額度並移除折扣碼,價格將恢復為未使用折扣碼時的金額。 預留額度會計入以下上限: - **活動總使用次數上限**:涵蓋所有折扣碼與接收者的使用次數。達到上限後,將無法再套用折扣碼。 - **單碼使用次數上限**:適用於設有獨立上限的折扣碼。預留生效期間,會同時占用單碼與活動的可用次數。付款成功後計為已使用;移除折扣碼或釋放預留時,會恢復預留的可用次數。單碼上限不得超過活動總上限。 - **每位接收者的使用次數上限**:適用於個別接收者。達到上限後,該接收者將無法再使用折扣碼,其他接收者不受影響。如果活動設有此上限,結帳時未提供接收者識別碼也將無法使用折扣碼。 未通過驗證的折扣碼不會產生額度預留。 ## 訂單與退款 訂單成功後,會保留活動、折扣碼、折扣比例與折扣金額等資訊。請依現有的成功訂單處理流程交付已付款的商品。系統不會另行傳送折扣碼使用通知,您也無需發放獎勵。 退款以購物者實際支付的金額為準,部分退款依折後單價計算。退款不會恢復已扣除的活動總使用額度、折扣碼使用額度、接收者使用額度或預算。 ## 無法使用折扣碼的情況 折扣碼無法使用時,購物者會在結帳時看到錯誤提示,價格保持不變。以下情況會導致折扣碼遭拒絕: - 訂單已有折扣碼。必須先移除才能輸入另一個。 - 結帳工作階段用於訂閱。 - 訂單為支付閘道訂單。折扣碼僅適用於 Merchant of Record(MoR)模式下的購買。 - 折扣碼會使應付金額降為零。 - 活動設有每位接收者的使用次數上限,但結帳工作階段中未提供接收者識別碼;或傳入的識別碼無效(無論是否設定每位接收者上限)。 - 結帳工作階段未提供地區資訊,無法重新計算稅費。 - 帳戶尚未設定自動稅費計算。 - 訂單不再處於等待付款狀態。 - 目前帳戶中找不到該折扣碼,或該碼屬於另一模式(測試或正式)。 - 折扣碼未處於 `active` 狀態。 - 折扣碼已達自身的使用次數上限。 - 活動不可用,例如仍為草稿、已暫停、已結束,或已排程但尚未開始。 - 活動已達或超過結束時間。 - 該碼不屬於折扣碼活動。 - 活動已達總使用次數上限。 - 該接收者已達每位接收者的使用次數上限。 - 活動剩餘預算不足以涵蓋本訂單的全部折扣金額。 ## 測試 試用活動時請使用測試模式: 1. 在 Tokenz 控制台的測試模式下建立活動及其折扣碼。 2. 測試模式下的活動與折扣碼和正式資料相互隔離。測試結帳只能使用測試折扣碼,正式結帳只能使用正式折扣碼。 3. 在 Tokenz Checkout 中套用折扣碼、移除折扣碼並完成測試付款。套用折扣碼後應顯示折後總金額;移除折扣碼後應恢復原價;測試訂單成功後應保留折扣資訊。