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
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
| 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. |
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
- Na Binance, abra Account › API Management e crie uma nova chave de API (gerada pelo sistema). Dê a ela um rótulo como "NexCMP".
- Edite as permissões: deixe marcado apenas Enable Reading. Não ative saques, transferências ou negociações.
- 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.
- Copie a API key e a Secret key (a chave secreta é exibida apenas uma vez).
- 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 ou0x...em BSC/ETH).
Conectar no NexCMP
- Abra Finance › Payment channels › USDT (
/payments/usdt). - Em API key (Binance › API Management), cole a API key e o API secret. Ambos devem ser inseridos juntos.
- 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). - 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.
- 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.
- 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
- O cliente insere um valor em Billing › Deposit › USDT e clica em Get deposit address.
- 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. - 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.
- 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.
- Uma solicitação não paga dentro do tempo de expiração (padrão de 30 minutos) é marcada como expirada.
Verificar
- 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).
- Envie o valor exato de outra carteira ou corretora. Aguarde alguns minutos.
- O portal exibe Transfer seen — confirming, seguido por USDT received — balance updated.
- A página de USDT exibe um horário recente em Last poll e Unmatched em 0.
Limites e notas
- 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.
- 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
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
| 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. |