---
title: Recarga mínima
description: Defina a menor e a maior recarga de carteira por pagamento e compreenda os outros limites de saldo que determinam se um cliente pode fazer pedidos.
url: https://nexcmp.com/pt/docs/billing/minimum-top-up/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Recarga mínima {#minimum-top-up}

> **Onde no admin:** Finance › Payment channels › Fees & limits (`/payments/fees`), cartão **Wallet & top-up (Billing › Policy)**.

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

Cada canal de pagamento rejeita um valor abaixo da **recarga mínima** ou acima da **recarga máxima por transação**. Os padrões são **$10.00** e **$5,000.00**. Use o mínimo para evitar pagamentos minúsculos cujas taxas de gateway superam o valor.

## Requisitos {#requirements}

| Item | Requisito |
|---|---|
| Função | Um administrador. |
| Dependências | Nenhum. |

## Definir os limites {#set-the-limits}

1. Abra **Finance › Payment channels › Fees & limits** (`/payments/fees`).
2. No cartão **Wallet & top-up (Billing › Policy)**, edite **Min top-up (USD)** e **Max top-up per transaction (USD)**.
3. Clique em **Save Wallet & top-up**.

![Cartão de carteira e recarga com a recarga mínima de 10.00 e a máxima de 5000.00](https://nexcmp.com/pt/docs/images/billing/minimum-top-up-01-limits.webp)

| Configuração | Padrão | Intervalo permitido | Regra |
|---|---|---|---|
| Min top-up (USD) | $10.00 | $0 a $10,000 | Deve ser menor ou igual ao máximo. |
| Recarga máxima por transação (USD) | $5,000.00 | $1 a $1,000,000 | Deve ser pelo menos o mínimo. |

Os valores são armazenados em centavos (`min_topup_cents`, `max_topup_cents`).

## Onde os limites se aplicam {#where-the-limits-apply}

| Local | Comportamento |
|---|---|
| Cartão, Apple/Google Pay, Link, Alipay, PayPal, USDT | Valores fora do intervalo são recusados pelo servidor. O portal exibe "Enter an amount between {min} and {max}". |
| Transferência bancária VN | O valor em VND deve estar dentro dos limites do Sepay **e** o seu valor em USD (o que a carteira recebe) dentro do mínimo e do máximo. O portal exibe o maior dos dois mínimos em VND. Consulte [Bank transfer (Vietnam)](https://nexcmp.com/pt/docs/billing/bank-transfer-vn/). |
| [Automatic top-up](https://nexcmp.com/pt/docs/billing/auto-top-up/) | Cada cobrança automática é de pelo menos o mínimo e no máximo o máximo. No modo fixo, o valor do cliente deve estar entre o mínimo e $1,000. |
| Códigos de recarga ([Vouchers](https://nexcmp.com/pt/docs/billing/promotions/)) | Não afetado. |
| Crédito / débito do admin | Não afetado. |
| Recarga da carteira de revendedor | Um mínimo separado (`rs_topup_min_cents`, padrão $20) em Resellers › Defaults. |

## Limites relacionados {#related-floors}

A recarga mínima não é a única regra de saldo. Elas estão em **Services › Virtual Machines › Policy** (`/vm/policy`):

| Regra | Padrão | Significado |
|---|---|---|
| Saldo mínimo (`min_balance_cents`) | $5.00 | O saldo de carteira mínimo que um cliente precisa para criar uma VM. |
| Quotas | Desligado | Quando as **Quotas** estão ativadas, a criação de uma VM também requer um saldo que cubra um número de horas dessa VM. Veja [Quotas](https://nexcmp.com/pt/docs/billing/quotas/). |

## Verificar {#verify}

1. No portal, abra **Billing › Deposit** e digite um valor logo abaixo do seu mínimo. O botão de pagamento é desativado e a mensagem de intervalo aparece.
2. Insira o mínimo e confirme que o pagamento é iniciado.

## Limites e notas {#limits-notes}

- Uma alteração se aplica a novos pagamentos. Os pedidos já criados mantêm os valores com os quais foram criados.
- A dica voltada para o cliente ("Minimum $10.00, maximum $5,000.00") e os botões de valor rápido seguem os novos limites automaticamente.
- Se você exibir VND (a página **Exchange rates**), o mínimo é convertido à taxa armazenada apenas para exibição; a carteira e os limites permanecem em USD.

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

| Sintoma | Causa | Correção |
|---|---|---|
| Minimum top-up must be less than or equal to the maximum | Valores cruzados | Diminua o mínimo ou aumente o máximo. |
| O cliente não pode pagar um valor pequeno por transferência bancária vietnamita | O mínimo em VND do Sepay ou o mínimo em USD é maior | Diminua **Min / order** na página do banco ou o mínimo em USD. |
| Erro de servidor `invalid_argument` em uma recarga | Valor fora do intervalo | Solicite um valor dentro do intervalo exibido. |