Como aceitar pagamentos em USDT no seu site

Para aceitar USDT no seu site, prepare um endereço de recebimento na rede escolhida, conecte-o ao serviço adequado do Cryptanio e mostre ao comprador os dados daquele pagamento específico. Para um pagamento pontual, você pode publicar um link de pagamento. Em uma loja com controle automático de pedidos, é mais conveniente criar uma fatura separada para cada compra.

Este guia aborda as particularidades do USDT: como distinguir a rede, o token e a moeda do preço e, depois, verificar corretamente o recebimento. O processo geral de integração do site está em um guia separado.

Primeiro, defina qual versão de USDT você aceita

O USDT existe em várias blockchains. Por isso, a indicação “Pagar com USDT” não basta: a rede também precisa estar clara. Endereços com o mesmo formato e o mesmo símbolo em dois aplicativos não comprovam a compatibilidade da transferência.

Para a opção escolhida, verifique as três condições ao mesmo tempo:

• a carteira do destinatário aceita USDT nessa rede e fornece um endereço de recebimento adequado;
• o Cryptanio permite essa combinação de rede e ativo no serviço necessário do projeto;
• a carteira ou o serviço do remetente consegue enviar exatamente essa versão de USDT.

Confira o identificador do token no diretório oficial da Tether, sem confiar apenas no nome e no logotipo. O diretório também contém informações históricas sobre suporte descontinuado: a existência de uma seção antiga não significa que o protocolo continue sendo aceito. A disponibilidade no Cryptanio deve ser verificada separadamente. O diretório foi consultado em 14 de novembro de 2026.

Prepare o endereço e conecte o ativo correto

No painel, selecione o projeto do site com o serviço Payments ativo para faturas ou Links para links de pagamento. Adicione um endereço público de recebimento ou selecione-o no livro de endereços e conecte-o ao serviço escolhido. Salvar o registro apenas no livro não ativa o recebimento de pagamentos por esse serviço.

Nas configurações de uso do endereço, confira o campo “Ativo”. Para USDT, ele deve identificar o token aceito na rede selecionada. Um campo vazio significa a moeda nativa, não USDT. As denominações aceitas, como USDT, são resolvidas pelo catálogo do serviço; ao informar um contrato ou mint, use o identificador exato daquela rede. Não insira o endereço de um token de outra rede.

Essa conexão não exige uma frase de recuperação nem uma chave privada que permita gastar os fundos. Confira se o endereço pertence à sua carteira e se você poderá gerenciar por conta própria o USDT recebido.

Escolha um link ou uma fatura

Se o site apresenta um serviço e você confirma os pagamentos manualmente, abra “Links de pagamento” e clique em “Novo link de pagamento”. Defina um valor fixo e mantenha a versão de USDT desejada entre as formas de pagamento disponíveis. Publique no site o link permanente gerado. O projeto precisa dispor de endereços conectados especificamente a Links.

Para uma loja automatizada, crie as faturas pela API v1 no seu servidor. Com um ativo escolhido antecipadamente, informe project, chain, asset e uma string amount em unidades de USDT. O preço do pedido em dólares e o valor esperado em criptomoeda têm funções diferentes: uma cotação em USD não significa receber dólares nem trocar os tokens recebidos.

Salve a relação entre o pedido e o ID da fatura. Use um Idempotency-Key exclusivo para cada nova operação e mantenha o anterior ao repetir a mesma solicitação após uma falha. A chave API secreta deve permanecer no servidor.

Mostre os dados sem arredondamentos ou substituições

O comprador precisa da rede, do ativo, do endereço, do valor exato e do prazo de pagamento da página atual ou da resposta da fatura. Se houver memo, destination tag ou outros dados adicionais obrigatórios, eles também devem ser transmitidos. Para o QR, use o payment_uri retornado, quando houver: não o reconstrua apenas com o endereço nem perca os dados adicionais.

Não substitua o valor exato por um preço arredondado da vitrine. Não prometa aceitar USDC ou outro token no lugar de USDT por terem valor semelhante. Ao mudar a forma de pagamento, o comprador deve usar os dados atuais da tentativa, não um endereço salvo anteriormente.

Verifique separadamente a taxa de transferência de USDT: qual ativo a carteira precisa para pagar a taxa e quanto o vendedor realmente receberá. A taxa não pode reduzir silenciosamente o valor esperado para o pedido.

Verifique o pagamento pela fatura

Uma captura de tela, uma mensagem do comprador e uma transação detectada não comprovam o pagamento integral do pedido. Para o processamento automático, verifique o estado atual da fatura: o sucesso corresponde a paid. Um pagamento insuficiente, parcial ou excedente, ou uma transferência atrasada, pode exigir uma decisão específica.

O servidor pode receber um webhook assinado e conferir o resultado pela API ou consultar o estado pela API sem webhook. Um evento ou uma verificação repetidos não devem entregar o produto duas vezes. Se precisar de um manipulador de notificações, consulte o guia de webhook.

O que verificar antes do primeiro pedido

Abra o pagamento do ponto de vista do comprador e confira a rede, o ativo e os dados. Se testar com uma transferência real, considere a taxa e use fundos próprios: apenas abrir a página não verifica o recebimento.

Se a transferência foi enviada, mas o pedido continua sem pagamento, salve o TXID e confira a rede, o token exato, o valor recebido e as confirmações. O guia sobre pedidos não pagos explica como analisar pagamentos insuficientes e erros do site.