Skip to main content

Como as moedas funcionam na Noxpay

Cada código de moeda na Noxpay representa um par de moeda e rede específico — não apenas um token. USDT na Tron e USDT na Ethereum são tratadas como moedas completamente separadas. Elas têm saldos separados, endereços de depósito separados e não podem ser usadas de forma intercambiável. Isso significa que:
  • Os saldos são rastreados por código. TRX_USDT_S2UZ e USDT_ERC20 são dois buckets de saldo distintos, mesmo que ambos sejam USDT.
  • Você não pode mover fundos entre dois códigos que compartilham o mesmo token subjacente, mas diferem em rede. Um saldo de USDT (TRX) não pode financiar uma operação que espera USDT (ERC-20).
  • Ao criar uma transação ou ler um response, sempre use o código exato para a rede em que pretende operar.
Escolha o código de moeda com base na rede que sua contraparte suporta, e certifique-se de que sua configuração (Templates, entradas de whitelist, endereços de saque) utilize consistentemente o mesmo código.

Códigos de moeda suportados


Onde esses códigos aparecem

O código aparece como está nos responses da API em campos como currency_exit_received_code, currency_entry_paid_code, currency_receive_code e deposit_currency. O nome exibido correspondente aparece na variante _pretty_name ou não-_code do mesmo campo (ex: currency_exit_received). No endpoint de saldo, as chaves de nível superior do objeto balances são os tickers — USDT, USDC, BTC, BRL — e as chaves aninhadas nomeiam a moeda-e-rede abaixo de cada uma (ex: USDT TRC20).
Essas chaves de saldo são rótulos de conta do ledger, não códigos de moeda. São configuradas por conta e não são identificadores estáveis — nunca indexe seu próprio armazenamento por elas, e nunca tente extrair um código delas. Para filtrar ou conciliar por código, use o campo account.currency do endpoint de extrato, que devolve os códigos da tabela acima.