正在加载搜索…

正在加载搜索…

跳至内容
营销活动折扣码

折扣码

了解如何让购物者在结账时使用折扣码,按比例减免付费订单金额。

折扣码可降低购物者购买商品目录中付费商品时所需支付的金额。礼品码和免费物品则用于免费发放奖励。折扣码适用于这些付费商品的一次性购买: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 状态。
  • 折扣码已达到自身的使用次数上限。
  • 活动不可用,例如仍为草稿、已暂停、已结束,或已排期但尚未开始。
  • 活动已达到或超过结束时间。
  • 该码不属于折扣码活动。
  • 活动已达到总使用次数上限。
  • 该接收者已达到每位接收者的使用次数上限。
  • 活动剩余预算不足以覆盖本订单的全部折扣金额。

测试

试用活动时请使用测试模式:

  1. 在 Tokenz 控制台的测试模式下创建活动及其折扣码。
  2. 测试模式下的活动和折扣码与正式数据相互隔离。测试结账只能使用测试折扣码,正式结账只能使用正式折扣码。
  3. 在 Tokenz Checkout 中应用折扣码、移除折扣码并完成测试付款。应用折扣码后应显示折后总金额;移除折扣码后应恢复原价;测试订单成功后应保留折扣信息。