---
title: Moeda e taxas de câmbio
description: Como o NexCMP mantém os valores em dólares americanos, exibe outras moedas por idioma e como o administrador publica a taxa USD/VND e as taxas de exibição.
url: https://nexcmp.com/pt/docs/catalog/currency-and-exchange-rates/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Moeda e taxas de câmbio {#currency-and-exchange-rates}

> **Onde no admin:** Finance › Payment channels › Exchange rates (`/payments/fx`) para as taxas. System › Settings › Brand (`/settings/branding`) para o botão **Site currency**.

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

O NexCMP mantém carteiras e faturas em USD. Os preços dos planos de VM são armazenados em microdólares por hora. As moedas de exibição permitem que os clientes visualizem valores em USD na sua própria moeda a uma taxa publicada; elas não alteram o saldo da carteira. Alguns serviços aceitam preços inseridos em VND, incluindo add-ons de largura de banda, S3, Private Cloud e planos Bare Metal existentes que mantêm a precificação em VND. Transferências bancárias via Sepay são pagas em VND.

As taxas são **publicadas por um administrador**. Nada é atualizado automaticamente, portanto as taxas salvas permanecem exatamente como estão até que você pressione o botão de atualização.

## Requisitos {#requirements}

| Item | Requisito |
|---|---|
| Acesso à internet | O servidor do painel precisa conseguir acessar `open.er-api.com` (para USD/VND) e `api.frankfurter.dev` (para as outras moedas) quando você clica em **Update exchange rates**. |
| Permissões | Um administrador para alterações; cada alteração solicita um motivo. |
| Depende de | Nada. [Plans](https://nexcmp.com/pt/docs/catalog/plans/), [Bandwidth](https://nexcmp.com/pt/docs/catalog/bandwidth/), [S3](https://nexcmp.com/pt/docs/infrastructure/s3/) e transferências bancárias em VND usam a taxa. |

## Preparar a infraestrutura {#prepare-the-infrastructure}

Não obrigatório. Se o seu servidor filtrar o tráfego de saída, permita HTTPS para os dois serviços acima.

## Conectar no NexCMP {#connect-in-nexcmp}

### 1. Escolher a moeda do site {#_1-choose-the-site-currency}

Abra **System › Settings › Brand** e defina **Site currency**:

| Escolha | O que os clientes veem |
|---|---|
| **Language-based (auto)** (o padrão em uma nova instalação) | O portal seleciona uma moeda de exibição com base no idioma (tabela abaixo). O cliente pode optar por USD em vez disso. |
| **USD** | Preços e saldos apenas em USD. Sem seletor de moeda e sem valores convertidos. |
| **VND** | Configuração legada; segue as mesmas regras de exibição com base no idioma do Auto. |

Salvar. As páginas do cliente são atualizadas em cerca de um minuto.


Quando o site segue o idioma do cliente:

| Idioma | Moeda de exibição |
|---|---|
| Inglês | USD |
| Vietnamita | VND |
| Chinês (simplificado / tradicional) | CNY / TWD |
| Japonês, coreano | JPY, KRW |
| Francês, alemão, espanhol, italiano | EUR |
| Português, russo | BRL, RUB |
| Árabe, híndi | SAR, INR |
| Indonésio, tailandês | IDR, THB |

Uma moeda cuja taxa não tenha sido publicada não é oferecida: o portal recorre ao USD como padrão.

### 2. Publicar as taxas {#_2-publish-the-rates}

1. Abra **Finance › Payment channels › Exchange rates**.
2. O cartão **Currency by language** lista as 11 moedas de exibição com suas taxas por USD, a origem (Frankfurter) e a hora da última atualização. Clique em **Update exchange rates**.

   O botão realiza duas ações em uma única etapa: ele lê a tabela do mercado público para **USD/VND** e lê as outras 11 taxas. Ambas são verificadas antes que qualquer uma seja salva. Se uma falhar, nada é alterado e as taxas anteriores permanecem.


3. O card **Active exchange rate** mostra a taxa de USD/VND em vigor, sua tag de origem (mercado público ou fixa), a margem e os valores de referência do mercado com seus timestamps.
4. O cartão **Config** (salve com um motivo):

   | Campo | Significado | Intervalo |
   |---|---|---|
   | Margem (bp, 100 = 1 %) | Adicionado sobre a taxa de referência de mercado. A taxa efetiva é a taxa de referência mais a margem, arredondada para cima. | 0 a 1000 |
   | Taxa fixa (VND por USD, 0 = seguir mercado) | Uma taxa definida por você. Ela substitui o valor de mercado. | 0 ou 15,000 a 50,000 |
   | Limite de salto (bp) | Uma nova taxa de mercado que diferir da atual por mais do que isso fica **retida** até que você a confirme. | 50 a 2000 (padrão 500) |
   | Etapa de arredondamento de VND | Arredonda preços em VND e valores de transferência bancária. | 1, 100, 1,000 (default) ou 10,000 |

5. Se uma nova taxa de mercado variar mais do que o limite definido, o card **Pending exchange rate** será exibido e a taxa **não será aplicada**. Verifique-a em relação à sua referência escolhida e clique em **Apply this rate**.

   Uma taxa de mercado fora da faixa de 15,000 a 50,000 VND por USD é rejeitada como inconsistente. As atualizações manuais são limitadas a uma solicitação a cada cinco minutos, portanto o botão pode solicitar que você aguarde.

6. A tabela **Exchange rate history** lista cada taxa consultada ou confirmada com seu horário, taxa efetiva, referência de mercado, fonte, se foi aplicada, quem a executou e uma observação (variações retidas são marcadas como **held**).

## Como uma taxa é usada {#how-a-rate-is-used}

| Local | Regra |
|---|---|
| Carteira e faturas | Centavos de USD. A taxa nunca altera um saldo. |
| Planos de VM inseridos em VND | Convertidos **uma única vez** à taxa vigente no momento em que você salva, sendo então armazenados em USD. Alterações posteriores na taxa não alteram os preços desses planos de VM. |
| Transferência bancária via Sepay | O cliente paga `ceil(USD × rate)`, arredondado para cima conforme a etapa de arredondamento. O Sepay fica **bloqueado** até que exista uma taxa USD/VND. |
| Planos Bare Metal | Novas instalações usam USD diretamente. Planos existentes em VND mantêm sua unidade de preço e necessitam de uma taxa no momento da cobrança; consulte [Servidores dedicados](https://nexcmp.com/pt/docs/infrastructure/dedicated/). |
| Outros pagamentos internacionais inseridos em VND | Arredondado para o centavo mais próximo. |
| Exibição no portal | USD multiplicado pela taxa publicada da moeda de exibição, formatada para o idioma. |

## Verificar {#verify}

1. **Active exchange rate** mostra um valor USD/VND com um horário recente de "fetched".
2. A grade **Currency by language** mostra taxas não vazias.
3. No portal do cliente, altere o idioma para vietnamita (moeda do site em Auto): os preços são exibidos em dong; altere para japonês: iene. Com a moeda do site em USD, apenas dólares são exibidos.
4. Em um formulário de plano (Plans & pricing), a lista **Enter price by** oferece **VND / month**.

## Limites e observações {#limits-and-notes}

- Sem atualização automática. Pressione **Update exchange rates** quando quiser novas taxas e defina um lembrete se as taxas forem importantes para você.
- A taxa de mercado pública é usada para USD/VND; trata-se de uma taxa de referência, e não de uma cotação bancária de compra ou venda. As outras moedas de exibição vêm do Frankfurter; uma data com mais de 14 dias ou uma tabela incompleta é rejeitada.
- A margem e a taxa fixa afetam apenas USD/VND. As 11 moedas de exibição não possuem margem.
- Cada idioma de cliente possui uma moeda. Mudar o idioma redefine para a moeda daquele idioma, a menos que o cliente tenha escolhido USD para o mesmo idioma.
- Os sites de revendedores seguem as mesmas taxas.

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

| Sintoma | Causa | Correção |
|---|---|---|
| "Nova taxa de câmbio diverge além do limite — EM ESPERA, requer confirmação manual" | A variação é maior do que o limite estabelecido | Verifique e clique em **Apply this rate**, ou altere o limite. |
| "Servidor rejeitou a nova taxa de câmbio" | O valor de mercado está fora de 15,000 a 50,000 ou está malformado | Aguarde e tente novamente, ou defina uma taxa fixa. |
| A atualização solicita que você aguarde antes de tentar novamente | Atualizações muito frequentes | Aguarde e tente novamente. |
| "não foi possível buscar a taxa: …" | O servidor do painel não consegue acessar os serviços de taxa | Permita tráfego HTTPS de saída e tente novamente. |
| Tag **Sepay blocked** | Nenhuma taxa USD/VND foi publicada ainda | Pressione **Update exchange rates** ou defina uma taxa fixa. |
| Uma moeda está faltando no portal | A taxa correspondente está ausente | Pressione **Update exchange rates**. |
| Os clientes veem os preços apenas em USD | A moeda do site é USD ou a taxa está ausente | Defina **Site currency** como Auto e publique as taxas. |
| "Tabela de taxas de câmbio incompleta; taxas anteriores mantidas" | O Frankfurter retornou menos de 11 moedas | Tente novamente mais tarde; nada foi alterado. |
| A opção VND está ausente no formulário do plano | Nenhuma taxa USD/VND | Publique uma taxa primeiro. |