---
title: 促销代码
description: 发放充值码：钱包彩金、专用服务额度以及带最高限额和最低订单要求的折扣百分比——创建、分发并进行追踪。
url: https://nexcmp.com/zh-cn/docs/billing/promotions/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# 促销代码 {#promotions}

> **后台位置：** Finance › Billing › Vouchers (`/billing/vouchers`)。**用户端位置：** Billing › Redeem code（也可在充值抽屉内找到）。

## 功能说明 {#what-it-does}

**充值代码**（代金券）是发放给客户的一次性使用密钥。根据创建方式的不同，它可以实现：

| 类型 | 客户获得的内容 | 价值去向 |
|---|---|---|
| 适用于所有服务的**Bonus credit** | 存入钱包的资金 | 钱包余额。可用于任何消费。 |
| 适用于指定服务的**Bonus credit** | 服务额度 | 只能用于支付这些服务的独立资金池。 |
| **Discount %** | 指定服务首单的百分比折扣 | 不予入账；折扣在结账时直接应用。 |

可将其用于营销活动、补偿额度、合作伙伴优惠或首单折扣。

## 前提条件 {#requirements}

| 项目 | 要求 |
|---|---|
| 角色 | 管理员。 |
| 客户 | 客户登录门户后（而非以访客身份）兑换代码。默认情况下客户必须已验证电子邮箱。 |
| VND代码 | 以VND创建的代码在兑换时会根据存储的汇率转换为USD（参见[Currency and exchange rates](https://nexcmp.com/zh-cn/docs/catalog/currency-and-exchange-rates/)）。 |

## 创建批次 {#create-a-batch}

1. 打开**Finance › Billing › Vouchers**并点击**Create vouchers**。
2. 填写表单。示例值位于括号中。

   | 字段 | 备注 |
   |---|---|
   | 批次名称 | 1–80个字符 (`Spring welcome`)。 |
   | 目标 | **Main site clients**、**Single reseller's customers**（需要客户列表）或**Reseller wallet**。 |
   | 符合条件的用户 | **All in target audience**或**Specified**——每行一个邮箱或客户ID，最多1,000个。对于转售商的客户，必须选择*Specified*。 |
   | 每个目标1个代码 | 选择*Specified*时，会为列出的每个客户创建一个代码。 |
   | 代码类型 | **Bonus credit**或**Discount %**。 |
   | 适用范围 | 选择一项或多项服务；留空则表示**All services**。 |
   | 币种，面值 | USD从$1.00起，或VND从10,000起且为1,000的整数倍（仅限彩金）。 |
   | 折扣 (%) | 1到100（仅限Discount %）。 |
   | 最大折扣上限 (USD) | Discount %必填项，从$1.00起。这也是单次兑换的最大减免额。 |
   | 最低订单金额 (USD) | `0` = 无。首单必须达到此金额。 |
   | 代码数量 | 1到1,000个随机代码。 |
   | 每个代码使用次数 | 1至100,000。`1`表示每个代码限一人使用；如需共享代码请调高此值。 |
   | 每个账户最大使用次数 | 至少为1。对于折扣%，必须为`1`。 |
   | 开始时间（可选）、过期时间 | 到期时间必须在今天之后、开始时间之后，最多提前2年。 |
   | 代码前缀（0–6个字符） | 仅限字母；留空则使用网站的前缀。 |
   | 自定义代码（仅当数量 = 1 时） | 6至32个字符，包含A–Z和0–9。易于分享但也容易被猜到：请保持使用次数较低。 |
   | 要求验证邮箱 | 默认开启。 |
   | 内部备注、原因 | 原因为必填项，并会记录到审计日志中。 |

3. 表单会显示**最大风险敞口**（面值 x 代码数 x 使用次数），以便您了解最坏情况。点击**Generate codes**。
4. **请立即复制代码。** 它们只显示一次：NexCMP仅存储哈希值和最后4个字符。使用**Copy all**或**Download CSV**，勾选确认并关闭窗口。



## 每种类型的行为方式 {#how-each-type-behaves}

### 钱包奖励（未选择服务） {#wallet-bonus-no-service-selected}

钱包将收到一笔**调整**条目（参考号`vch:...`）。该金额不可退款至银行卡、不产生分销佣金、不开发票，且在计算配额时计入钱包余额。VND代码使用兑换时的汇率。

### 服务信用额度（已选服务） {#service-credit-services-selected}

- 信用额度存放在**单独的口袋**中，只能用于支付所选服务的费用（新订单、续费、按小时或按天计费、升级），并且会**优先于**钱包扣除。
- 它不能被提现、转账或兑换成现金，且随代码一同过期。
- 账单中会显示全额费用以及对应的信用减免行，因此每项服务的收入保持正确，而钱包扣款额则仅为客户实际支付的部分。
- 它**不会**提升[quota](https://nexcmp.com/zh-cn/docs/billing/quotas/)层级，并且会被[auto top-up](https://nexcmp.com/zh-cn/docs/billing/auto-top-up/)忽略。
- 如果使用信用额度或折扣支付的费用发生退款，代码支付的部分将从钱包退款中扣回，并返还至信用额度口袋。

### 折扣 % {#discount}

1. 客户输入代码：代码变为**已激活**。百分比代码每个账户仅可使用一次。
2. 所选服务（非按小时计费）的**首笔费用**且达到**最低订单金额**时，将按百分比打折，折扣额绝不超过**最高折扣上限**。
3. 折扣由服务器在计费时重新计算；浏览器中显示的金额将被忽略。兑换行在实际使用代码时写入，并带有实际折扣。
4. 按小时使用费不适用该代码。

## 客户的操作步骤 {#what-the-customer-does}

1. 在控制面板中打开**Billing**并点击**Redeem code**，或在充值抽屉中使用**Have a top-up code?**。
2. 输入代码（不区分大小写；横杠可选）并点击**Check**。控制面板会显示其提供的优惠，例如*Valid code: +$5.00*、*$5.00 credit for VPN*或*20% off voucher for Virtual Machines (up to $5.00)*，以及*Valid for orders from $10.00*。
3. 点击**Redeem**并确认。每个代码每个账户仅可使用一次。

优惠码与站点绑定：来自一个站点的优惠码在另一个站点上会显示“无效”，并且不会提示其存在于别处。错误猜测会被限速，在尝试多次后，账户会被锁定几分钟（“N attempts left before a temporary lock”）。

## 跟踪与阻止 {#track-and-stop}

- **Batches**列出了每个批次及其状态（*active*、*disabled*、*expired*、*used up*）、已兑换次数和风险暴露额。打开批次可查看**Codes**（掩码显示）和**Redemptions**选项卡，并进行**Export CSV**。
- **Redemptions**列出了所有批次的每次兑换记录；**Resellers quotas**显示了每个分销商每月发放额度的使用情况；**Settings**用于开启或关闭分销商优惠码并设置默认月度限额。
- **Disable batch**会停用所有未使用的优惠码；已完成的兑换会保留。单个优惠码也可以被停用。

## 验证 {#verify}

1. 创建一个包含1个优惠码的批次：折扣率20%，封顶$5，最低订单金额$10，适用服务为Virtual Machines。
2. 以测试客户身份进行兑换。门户会提示已激活。
3. 订购一台费用至少为$10的VM（按月周期）：账单中将显示折扣（最多$5）。
4. 在批次中，该优惠码显示1次兑换记录以及实际折扣金额。

## 限制与注意事项 {#limits-notes}

- 优惠码在创建时即与**audience**和**site**绑定，事后无法更改。
- 分销商可以在每月风险暴露限额内向自己的客户发放优惠码；参见[Resellers](https://nexcmp.com/zh-cn/docs/customers/resellers/)。
- 面向客户的侧边栏促销幻灯片（**Marketing › Promo slides**）是一项独立功能，不提供任何折扣。
- 由于从不存储明文优惠码，丢失的批次无法恢复：请将其禁用并创建一个新批次。

## 故障排查 {#troubleshooting}

| 症状 | 原因 | 解决办法 |
|---|---|---|
| "百分比优惠码：每个账户限用一次" (`percent_one_per_account`) | Discount%的每个账户最大使用次数大于1 | 将其设为`1`。 |
| 表单提示必填上限 | Discount%未设置最大折扣上限 | 请输入至少$1.00。 |
| 未找到客户 | 列表中的某个电子邮箱或ID不存在 | 修正列表（错误信息会指出未知条目）。 |
| 客户提示“无效代码” | 站点错误、已过期、已禁用、已用完、非目标客户或电子邮箱未验证 | 检查批次和客户。 |
| 额度未被使用 | 扣费属于其他服务 | 额度仅可抵扣批次中选定的服务。 |
| 折扣未应用 | 订单低于最低金额、按小时计费，或代码是在其他服务中激活的 | 下一笔符合条件的首次订单。 |
| 客户被锁定无法兑换 | 错误尝试次数过多 | 等待锁定过期。 |