---
title: Promoções
description: Emita códigos de recarga: bônus de carteira, crédito para serviços e descontos percentuais com teto e pedido mínimo — crie, distribua e acompanhe.
url: https://nexcmp.com/pt/docs/billing/promotions/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Promoções {#promotions}

> **Onde encontrar no painel:** Finance › Billing › Vouchers (`/billing/vouchers`). **Onde encontrar no portal:** Billing › Redeem code (também dentro do painel lateral de depósito).

## O que faz {#what-it-does}

Um **código de recarga** (voucher) é um segredo de uso único fornecido aos clientes. Dependendo de como você o cria, ele pode:

| Tipo | O que o cliente recebe | Para onde o valor vai |
|---|---|---|
| **Bonus credit** para todos os serviços | Dinheiro adicionado à carteira | Saldo da carteira. Utilizável em qualquer item. |
| **Bonus credit** para serviços selecionados | Um crédito de serviço | Um bolso separado que só pode pagar por esses serviços. |
| **Discount %** | Uma porcentagem de desconto no primeiro pedido dos serviços selecionados | Nenhum crédito é concedido; o desconto é aplicado no checkout. |

Use-os para campanhas, créditos de cortesia, acordos com parceiros ou desconto no primeiro pedido.

## Requisitos {#requirements}

| Item | Requisito |
|---|---|
| Função | Um administrador. |
| Clientes | Os clientes resgatam códigos enquanto estão autenticados no portal (não como convidados). Por padrão, o cliente deve ter um e-mail verificado. |
| Códigos em VND | Um código criado em VND é convertido para USD no resgate usando a taxa de câmbio armazenada (consulte [Currency and exchange rates](https://nexcmp.com/pt/docs/catalog/currency-and-exchange-rates/)). |

## Criar um lote {#create-a-batch}

1. Abra **Finance › Billing › Vouchers** e clique em **Create vouchers**.
2. Preencha o formulário. Os valores de exemplo estão entre colchetes.

   | Campo | Notas |
   |---|---|
   | Nome do lote | 1 a 80 caracteres (`Spring welcome`). |
   | Destino | **Main site clients**, **Single reseller's customers** (necessita de uma lista de clientes) ou **Reseller wallet**. |
   | Usuários elegíveis | **All in target audience** ou **Specified** — um e-mail ou ID de cliente por linha, até 1,000. Para clientes de revenda, deve ser *Specified*. |
   | 1 código por destino | Com *Specified*, cria um código por cliente listado. |
   | Tipo de código | **Bonus credit** ou **Discount %**. |
   | Aplica-se a | Escolha um ou mais serviços; campo vazio = **All services**. |
   | Moeda, Valor nominal | USD a partir de $1.00 ou VND a partir de 10,000 em múltiplos de 1,000 (apenas crédito de bônus). |
   | Desconto (%) | 1 a 100 (apenas para Desconto %). |
   | Teto máximo de desconto (USD) | Obrigatório para Desconto %, a partir de $1.00. É também o valor máximo que você pode perder por resgate. |
   | Pedido mínimo (USD) | `0` = nenhum. O primeiro pedido deve ser de pelo menos este valor. |
   | Quantidade de códigos | 1 a 1,000 códigos aleatórios. |
   | Usos por código | 1 a 100,000. `1` significa uma pessoa por código; aumente o valor para um código compartilhado. |
   | Máximo de usos por conta | Pelo menos 1. Para Desconto % deve ser `1`. |
   | Data de início (opcional), Expira | A expiração deve ser após hoje e após o início, no máximo 2 anos à frente. |
   | Prefixo do código (0–6 caracteres) | Apenas letras; vazio usa o prefixo do site. |
   | Código personalizado (apenas quando count = 1) | 6 a 32 caracteres A–Z e 0–9. Fácil de compartilhar, mas fácil de adivinhar: mantenha os usos baixos. |
   | Exigir e-mail verificado | Ativado por padrão. |
   | Nota interna, Motivo | O motivo é obrigatório e vai para o registro de auditoria. |

3. O formulário mostra a **Exposição máxima** (valor nominal x códigos x usos) para que você saiba o pior cenário. Clique em **Generate codes**.
4. **Copie os códigos agora.** Eles são exibidos apenas uma vez: o NexCMP armazena apenas um hash e os últimos 4 caracteres. Use **Copy all** ou **Download CSV**, marque a confirmação e feche a caixa.



## Como cada tipo se comporta {#how-each-type-behaves}

### Bônus de carteira (nenhum serviço selecionado) {#wallet-bonus-no-service-selected}

A carteira recebe um lançamento de **ajuste** (referência `vch:...`). Não é reembolsável para um cartão, não gera comissão de afiliado, não cria fatura e conta como saldo de carteira para cotas. Códigos em VND usam a taxa de câmbio no momento do resgate.

### Crédito de serviço (serviços selecionados) {#service-credit-services-selected}

- O crédito fica em um **compartimento separado**, só pode pagar cobranças dos serviços escolhidos (novos pedidos, renovações, taxas por hora ou diárias, upgrades) e é gasto **antes** da carteira.
- Não pode ser sacado, transferido ou convertido em dinheiro, e expira com o código.
- O razão mostra a cobrança completa mais uma linha de crédito correspondente, de modo que a receita por serviço permaneça correta enquanto a carteira cai apenas pelo que o cliente realmente pagou.
- Ele **não** eleva um nível de [quota](https://nexcmp.com/pt/docs/billing/quotas/) e é ignorado pelo [auto top-up](https://nexcmp.com/pt/docs/billing/auto-top-up/).
- Se uma cobrança paga com crédito ou desconto for reembolsada, a parte que o código pagou é retida do reembolso da carteira e devolvida ao compartimento de crédito.

### Desconto % {#discount}

1. O cliente insere o código: ele se torna **ativado**. Um código de porcentagem só pode ser usado uma vez por conta.
2. A **primeira cobrança** de um serviço selecionado que não seja uma taxa por hora, e pelo menos o **Pedido mínimo**, recebe o desconto percentual, nunca superior ao **Limite máximo de desconto**.
3. O desconto é recalculado pelo servidor no momento da cobrança; o valor no navegador é ignorado. A linha de resgate é gravada quando o código é realmente usado, com o desconto real.
4. Cobranças de uso por hora nunca utilizam o código.

## O que o cliente faz {#what-the-customer-does}

1. Abra **Billing** no portal e clique em **Redeem code**, ou use **Have a top-up code?** na gaveta de depósito.
2. Digite o código (não diferencia maiúsculas de minúsculas; hífens opcionais) e clique em **Check**. O portal informa o que ele concede, por exemplo *Valid code: +$5.00*, *$5.00 credit for VPN* ou *20% off voucher for Virtual Machines (up to $5.00)*, e *Valid for orders from $10.00*.
3. Clique em **Redeem** e confirme. Cada código pode ser usado uma vez por conta.

Os códigos são vinculados ao site: um código de um site é "inválido" em outro, sem nenhum indício de que ele exista em outro lugar. Tentativas incorretas sofrem limitação de taxa (throttling) e, após várias tentativas, a conta é bloqueada por alguns minutos ("N tentativas restantes antes de um bloqueio temporário").

## Acompanhar e interromper {#track-and-stop}

- **Batches** lista cada lote com seu status (*active*, *disabled*, *expired*, *used up*), contagem de resgates e exposição. Abra um lote para ver as abas **Codes** (mascarados) e **Redemptions**, além de **Export CSV**.
- **Redemptions** lista cada resgate em todos os lotes; **Reseller quotas** mostra quanto do limite mensal de emissão de cada revendedor foi utilizado; **Settings** ativa ou desativa códigos de revendedores e define o limite mensal padrão.
- **Disable batch** interrompe todos os códigos não utilizados; os resgates já efetuados permanecem. Um código individual também pode ser desativado.

## Verificar {#verify}

1. Crie um lote de 1 código: % de desconto 20, limite de $5, pedido mínimo de $10, serviço Virtual Machines.
2. Como cliente de teste, resgate-o. O portal informa que ele está ativado.
3. Peça uma VM que custe pelo menos $10 (ciclo mensal): a fatura exibe o desconto (no máximo $5).
4. No lote, o código exibe 1 resgate com o desconto real.

## Limites e notas {#limits-notes}

- Os códigos são vinculados ao **audience** e ao **site** no momento da criação; eles não podem ser movidos posteriormente.
- Revendedores podem emitir códigos para seus próprios clientes dentro de um limite de exposição mensal; consulte [Resellers](https://nexcmp.com/pt/docs/customers/resellers/).
- Os slides de promoção da barra lateral para clientes (**Marketing › Promo slides**) são um recurso separado e não concedem nenhum desconto.
- Como o código em texto simples nunca é armazenado, um lote perdido não pode ser recuperado: desative-o e crie um novo.

## Resolução de problemas {#troubleshooting}

| Sintoma | Causa | Correção |
|---|---|---|
| "Códigos percentuais: um uso por conta" (`percent_one_per_account`) | Usos máx. por conta acima de 1 para % de Desconto | Defina como `1`. |
| O formulário diz que o limite é obrigatório | % de Desconto sem limite máximo de desconto (Maximum discount cap) | Insira pelo menos $1.00. |
| Clientes não encontrados | Um e-mail ou ID na lista não existe | Corrija a lista (o erro nomeia as entradas desconhecidas). |
| Cliente diz "código inválido" | Site incorreto, expirado, desativado, esgotado, não direcionado ao cliente ou e-mail não verificado | Verifique o lote e o cliente. |
| O crédito não foi utilizado | A cobrança pertence a outro serviço | O crédito paga apenas os serviços escolhidos no lote. |
| Desconto não aplicado | Pedido abaixo do mínimo, cobrança por hora ou o código foi ativado para outro serviço | Faça um primeiro pedido qualificado. |
| Cliente bloqueado de resgatar | Muitas tentativas incorretas | Aguarde o término do bloqueio. |