--- title: USDT (Binance) description: Aceite recargas em USDT monitorando endereço de depósito da Binance — chave de API somente leitura, escolha de rede e depósitos não reconciliados. url: https://nexcmp.com/pt/docs/billing/usdt/ applies_to: NexCMP 1.6.1 updated: 2026-11-02 --- # USDT (Binance) {#usdt-binance} > **Onde no admin:** Finance › Payment channels › USDT (`/payments/usdt`). Alternar e taxa: Finance › Payment channels › Fees & limits (`/payments/fees`). Depósitos não correspondidos: Finance › Payment channels › Gateway events › PayPal & USDT (`/payments/events?tab=gateways`). ## O que faz {#what-it-does} Os clientes enviam USDT para **seu endereço de depósito da Binance**; o NexCMP lê o histórico de depósitos por meio de uma chave de API da Binance **somente leitura** e credita a carteira quando um depósito corresponde a uma solicitação aberta. Não há taxa de processamento de pagamento do seu lado, além do que a Binance cobra, e nenhuma chave privada é armazenada pelo NexCMP. ## Requisitos {#requirements} | Item | Requisito | |---|---| | Conta Binance | Uma conta da Binance verificada com depósitos de USDT habilitados na rede escolhida. | | Chave de API | Uma chave de API da Binance apenas com **Enable Reading** ativado. Os recursos Enable Withdrawals, Internal Transfer e Spot/Margin Trading devem estar **desativados**. | | Restrição de IP | Altamente recomendável: restrinja a chave ao IP de saída do servidor (a caixa de diálogo **Test & verify address** o exibe). | | Rede | HTTPS de saída para `api.binance.com`. Nenhuma porta de entrada é necessária. | | Redes suportadas | `TRX` (Tron, TRC20), `BSC` (BNB Smart Chain, BEP20), `SOL` (Solana), `ETH` (Ethereum, ERC20). A criptomoeda é fixa em USDT. | | Dependências | Nenhum. | ::: warning Escolha a rede uma única vez Os clientes que enviarem pela rede errada perderão os fundos. Escolha a rede com taxas baixas suportada pelas corretoras dos seus clientes (TRX e BSC são as opções habituais) e não a altere com frequência. ::: ## Preparar a infraestrutura {#prepare-the-infrastructure} 1. Na Binance, abra **Account › API Management** e crie uma nova chave de API (gerada pelo sistema). Dê a ela um rótulo como "NexCMP". 2. Edite as permissões: deixe marcado apenas **Enable Reading**. Não ative saques, transferências ou negociações. 3. Em **Restrict access to trusted IPs only**, adicione o endereço IP público do seu servidor NexCMP. Se ainda não souber qual é, crie a chave sem a restrição, execute o primeiro teste no NexCMP (ele exibirá o IP de saída) e adicione o IP em seguida. 4. Copie a **API key** e a **Secret key** (a chave secreta é exibida apenas uma vez). 5. Abra **Wallet › Deposit › Crypto**, escolha **USDT** e a **rede** que você vai usar, e copie o **endereço de depósito** (por exemplo, um endereço `T...` em TRX ou `0x...` em BSC/ETH). ## Conectar no NexCMP {#connect-in-nexcmp} 1. Abra **Finance › Payment channels › USDT** (`/payments/usdt`). 2. Em **API key (Binance › API Management)**, cole a **API key** e o **API secret**. Ambos devem ser inseridos juntos. 3. Em **Deposit address**, escolha a **Network** e cole o **endereço de depósito USDT na rede selecionada**. O formato é validado de acordo com a rede (`T` + 33 caracteres para TRX, `0x` + 40 caracteres hexadecimais para BSC e ETH, base58 para SOL). 4. Clique em **Save**. Alterar o endereço ou a rede redefine a verificação e pausa o canal até que você o verifique novamente; a página pedirá confirmação. 5. Clique em **Test & verify address**. (Alterações não salvas são recusadas — a verificação é executada com base na configuração salva.) O diálogo exibe: - permissões da chave (leitura, saques, transferência interna, negociação, restrição de IP) — avisos em vermelho para permissões perigosas; - o IP de saída do servidor (para inserir na Binance); - a rede (depósitos abertos ou fechados, confirmações necessárias, poeira/dust); - o endereço que a Binance emite para essa rede e se ele **coincide** com o seu. 6. Quando o endereço coincidir, o NexCMP registra o horário da verificação. Só então você poderá abrir **Fees & limits**, ativar **USDT (Binance)**, verificar **USDT fee %** (padrão 1) e **USDT request expires after (mins)** (5–180, padrão 30), e clicar em **Save channels & fees**. ## Como um pagamento é correspondido {#how-a-payment-is-matched} 1. O cliente insere um valor em **Billing › Deposit › USDT** e clica em **Get deposit address**. 2. O NexCMP cria uma solicitação e exibe o endereço, a rede e um **valor exato** com seis casas decimais — por exemplo `19.173742`. Os últimos quatro decimais são um nonce aleatório que torna o valor exclusivo para essa solicitação. 3. O cliente deve enviar **exatamente** esse valor nessa rede. Um pagamento que não corresponda (valor arredondado, rede incorreta) não pode ser atribuído automaticamente. 4. A cada 60 segundos, o NexCMP lê os depósitos da Binance das últimas 24 horas. Um depósito correspondente move a solicitação para *confirming* e, assim que a Binance obtém as confirmações necessárias, credita a carteira. Uma solicitação que já recebeu fundos nunca expira enquanto as confirmações estiverem pendentes. 5. Uma solicitação não paga dentro do tempo de expiração (padrão de 30 minutos) é marcada como expirada. ## Verificar {#verify} 1. Depois que o endereço for verificado e o USDT estiver ativado, faça login como um cliente de teste e solicite um pequeno depósito (o valor mínimo de recarga). 2. Envie o valor exato de outra carteira ou corretora. Aguarde alguns minutos. 3. O portal exibe *Transfer seen — confirming*, seguido por *USDT received — balance updated*. 4. A página de USDT exibe um horário recente em **Last poll** e **Unmatched** em 0. ## Limites e notas {#limits-notes} - **Taxa.** 1 USDT = 1.00 USD. A taxa em **USDT fee %** é exibida ao cliente e deduzida ou adicionada ao valor, dependendo de **Customer pays top-up fee**. - **Sem reembolsos.** Os pagamentos em USDT nunca são reembolsados à origem pelo NexCMP (HTTP 409 `usdt_no_refund`). Faça o reembolso manualmente fora do sistema se necessário. - **Limite de pendências.** Um cliente tem um número limitado de solicitações abertas; além disso, o servidor responde com `too_many_pending` (HTTP 429). - **Resellers** podem usar sua própria conta da Binance; consulte [Resellers](https://nexcmp.com/pt/docs/customers/resellers/). - **Se você compartilhar a conta da Binance** com outro sistema, dê a cada sistema uma rede diferente para que dois coletores nunca vejam o mesmo depósito. ### Depósitos não correspondidos {#unmatched-deposits} Um depósito que não corresponde a nenhuma solicitação (valor incorreto, rede incorreta, solicitação expirada) cria um evento `deposit.unmatched` e um alerta de administrador. Abra **Payment channels › Gateway events › PayPal & USDT**, localize o evento, verifique a transação na Binance e clique na ação de atribuição para creditar o cliente correto. O contador **Unmatched** na página de USDT e na visão geral dos canais cai para 0 posteriormente. ## Resolução de problemas {#troubleshooting} | Sintoma | Causa | Correção | |---|---|---| | "A chave de API e o segredo devem ser inseridos juntos" | Apenas um campo preenchido | Preencha ambos. | | "O endereço não está no formato de rede ..." | O endereço não corresponde à rede selecionada | Copie-o novamente da Binance para a mesma rede. | | "Alterações não salvas — Salve primeiro e depois teste" | O teste é executado nas configurações salvas | Clique em **Save** e, em seguida, teste. | | Aviso "key has Enable Withdrawals" | Permissão excessiva | Remova-a no Gerenciamento de API da Binance. | | Aviso "key not restricted to IP" | `ipRestrict` está desativado | Adicione o IP de saída do servidor mostrado na caixa de diálogo. | | Aviso "key lacks Enable Reading" | Permissão ausente | Ative a Leitura (Enable Reading). | | Aviso "Binance has deposits disabled for USDT on the network" | Rede suspensa | Escolha outra rede ou aguarde. | | "PERIGO: o endereço configurado difere do endereço emitido pela Binance" | Endereço ou rede incorretos | Copie o endereço novamente da Binance para essa rede. | | Alternância de USDT esmaecida em Fees & limits | Endereço não verificado | Execute **Test & verify address** até que corresponda. | | Cliente pagou, nada creditado | Valor arredondado ou rede incorreta | Encontre o evento em Gateway events e atribua-o manualmente. | | Depósito visto, mas aguardando há muito tempo | Confirmações insuficientes ainda | Aguarde; a solicitação não expira durante a confirmação. |