Como aceitar pagamentos em USDT TRC20

O que o USDT TRC20 realmente é

USDT é uma stablecoin emitida pela Tether e feita para acompanhar o dólar americano. Existe em várias blockchains, e a rede define como uma transferência se comporta. TRC20 é o padrão de tokens na TRON. Um endereço de USDT TRC20 começa com a letra T e uma transferência é uma transação TRON.

Por que é tão comum entre os clientes:

• as transferências são baratas em comparação com muitas outras redes, o que importa para pedidos pequenos e médios;
• a maioria das corretoras e carteiras aceita saques nessa rede, então ela é o padrão de muitos compradores;
• o valor é em dólares, então nem você nem o cliente assumem oscilações de preço entre o pedido e o pagamento.

Para você, como lojista, a consequência prática é que boa parte dos clientes que dizem «pago em USDT» se referem a USDT na TRON. Se você não o oferece, fica mais difícil para o cliente pagar.

A rede faz parte do pagamento

A mesma moeda em outra rede é outro pagamento. USDT na TRON, na Ethereum (ERC20) e na BNB Smart Chain (BEP20) usam endereços e vias diferentes, e fundos enviados pela rede errada não chegam onde o remetente espera. Este é o erro mais caro nos pagamentos com stablecoins, e é cometido pelos clientes, não pelos lojistas.

O que ajuda:

• deixar que a página de pagamento, e não o texto do seu checkout, defina a rede: o cliente escolhe ali o ativo e a rede e recebe o endereço correspondente;
• dizer claramente no seu checkout quais redes você aceita (veja as moedas compatíveis);
• se quiser direcionar todos para a TRON, passe o método de pagamento do USDT TRC20 ao criar o pagamento, para que a página abra com ele já selecionado.

A Qvard suporta, entre suas redes, TRON (TRC20), Ethereum (ERC20) e BNB Smart Chain (BEP20). Oferecer várias redes não é ruim, mas cada opção extra é mais uma chance de o cliente escolher por hábito uma rede diferente da pretendida; a página de pagamento mostra a rede e o endereço juntos para manter isso visível.

Como funciona um pagamento em USDT

O caminho do pedido ao pagamento:

1. O cliente escolhe pagar com cripto e seu servidor cria um pagamento para o pedido.
2. O gateway devolve uma página de pagamento hospedada. Seu cliente escolhe USDT e a rede TRC20 e vê o endereço e o valor exato.
3. Ele envia o valor da carteira ou da corretora. A cotação da página fica fixa por uma hora, então o valor não muda enquanto ele paga.
4. O gateway monitora a rede TRON. Quando o valor total chega e o pagamento é definitivo, ele chama seu webhook.
5. Seu sistema marca o pedido como pago.

Você nunca gera endereços TRON nem executa um nó. Criar o pagamento é uma única requisição: um POST para https://api.qvard.com/api/v1/payment com o cabeçalho x-api-key e um corpo com o id do seu pedido e o price em dólares americanos. A versão passo a passo com código está em como aceitar pagamentos em cripto em um site.

Taxas: quem paga o quê

Três custos diferentes costumam ser confundidos, e vale separá-los.

• A taxa de rede da transferência. Quem envia USDT na TRON paga a transação com os recursos da própria rede (TRX ou energia). É um custo do cliente quando ele paga você. Seu preço não precisa incluí-la, embora um cliente que paga de uma corretora possa ter uma taxa de saque descontada do que envia.
• A comissão do gateway. Pela página de preços, é individual para o seu projeto, começa em 1% e, por acordo, pode chegar a 0,1%. Não há mensalidade.
• A taxa de rede quando você saca. Sacar seu saldo para a sua própria carteira custa apenas a taxa de rede.

O ponto que importa no checkout é o primeiro: se um cliente envia menos porque uma corretora descontou uma taxa do valor, o pagamento está incompleto, não concluído.

Pagamentos a menor e outros casos limite

Um pagamento termina em um de quatro status: wait (criado), partial (chegou menos que o necessário), completed (chegou o valor total) e rejected. Somente completed aciona o webhook.

Com USDT TRC20, os problemas realistas são:

• Pagamento a menor vindo de uma corretora. A taxa de saque foi subtraída do valor. O status é partial. Decida de antemão se você pede a diferença ou reembolsa o cliente, e avise-o na página do pedido.
• Pagamento depois da janela da cotação. A cotação é fixa por uma hora. Se o cliente paga muito depois, trate como trabalho de suporte em vez de construir automação para isso.
• Rede errada. O cliente pagou numa rede diferente da mostrada na página. Isso exige análise manual e não se resolve com código; mantenha um contato de suporte claro no fluxo de pagamento.

Torne idempotente o tratamento do pedido, porque o webhook é repetido até que seu endpoint responda exatamente HTTP 200, e compare o cabeçalho x-api-key com a sua chave. Mais em como proteger webhooks de pagamentos em cripto.

O que configurar primeiro

Uma ordem de trabalho curta que leva a um checkout com USDT TRC20 funcionando:

1. Crie uma conta e um projeto e obtenha sua chave de API.
2. Veja uma fatura de demonstração para ver o que seu cliente verá.
3. Adicione ao checkout a chamada de criação de pagamento, com o número do pedido como id.
4. Adicione o endpoint do webhook, salve o endereço como callback URL e marque pedidos como pagos apenas em completed.
5. Pague um pequeno valor real em USDT na TRON e confira todo o caminho, inclusive um saque para a sua carteira.

Um sandbox separado está no roadmap, então por ora use pequenos valores reais. A documentação para desenvolvedores traz os formatos exatos de requisição e resposta.

Para onde você pode sacar

Os fundos dos pagamentos ficam no seu saldo da Qvard e você os saca para a sua própria carteira cripto; o custo é a taxa de rede. O saque para conta bancária em moeda fiduciária não está disponível, então planeje uma saída em cripto, por exemplo para uma corretora que você já usa, se precisar converter em dinheiro.

FAQ