
Os recursos chegaram, mas a transferência falhou: como ler o recibo TRON
Identifique o txID da transferência, diferencie transmissão de confirmação solidificada e verifique a execução. Distinga REVERT, OUT_OF_ENERGY e resultado indefinido antes de pagar de novo.
Receber recursos não confirma a transferência
A energia exibida na conta remetente mostra os recursos no momento da consulta; não comprova o sucesso de uma transferência de USDT TRC-20. A entrega do aluguel e a transferência do token são eventos distintos. Consulte o identificador da transferência efetiva (txID), sem substituí-lo pelo registro de pagamento ou de delegação de recursos.
Confira a rede, o remetente e a transferência pretendida em uma carteira ou explorador confiável. Os campos abaixo seguem a documentação da TRON e não pressupõem um botão específico de carteira ou plataforma.
Confirme a transação e consulte a execução
Uma resposta de transmissão com result: true indica apenas que a chamada não relatou erro. Não comprova confirmação nem execução bem-sucedida do contrato. GetTransactionById retorna os dados da transação; GetTransactionInfoById retorna taxas, consumo de recursos, estado e logs após a execução.
Para confirmação final, consulte dados solidificados: /walletsolidity/gettransactionbyid para a transação e, no caso de contratos, /walletsolidity/gettransactioninfobyid para o recibo. As rotas /wallet mostram a visão mais recente do nó, que pode ainda não estar solidificada. O suporte confiável da carteira pode ajudar a interpretar esses estados; a consulta não exige assinatura nem transferência.
Decida conforme o resultado
- Sem recibo ou sem resultado essencial: registre o resultado como indefinido e continue consultando o txID original. Uma resposta vazia não prova falha. Primeiro verifique a existência da transação solidificada; não faça outro pagamento imediatamente.
- Com o recibo solidificado do contrato, confira se o result no nível principal não é FAILED e depois leia receipt.result. SUCCESS indica execução bem-sucedida. Para confirmar a transferência do token, confira também token, destinatário, valor e logs de transferência correspondentes.
- REVERT indica reversão da execução, possivelmente por uma condição do contrato não atendida. Analise contractResult e os detalhes do erro. Os dados retornados podem não conter uma explicação legível; não conclua que faltou energia.
- OUT_OF_ENERGY indica falta de energia durante a execução. Reestime considerando recursos, TRX e fee_limit aplicáveis naquele momento. Outros erros exigem diagnóstico específico; comprar mais energia não resolve todos os casos.
Guarde evidências antes de tentar novamente
Em registros privados, guarde horário da consulta, rede, txID original, estado de solidificação, receipt.result, erro e consumo de recursos. Oculte dados sensíveis nas capturas e não publique endereços completos ou dados de pagamento em grupos públicos. Consultar o recibo não exige frase de recuperação nem chave privada.
Exemplo didático: há energia suficiente agora, mas o recibo original mostra REVERT. Verifique as condições do contrato em vez de apenas adicionar energia. Se o resultado for indefinido, continue consultando a transação original. Avalie uma nova transação somente após confirmar a falha e corrigir a causa. Recursos recebidos depois não alteram o resultado de uma transação já executada; uma falha ainda pode consumir recursos ou gerar taxas.