← Voltar aos documentos
Lupa sobre um recibo em branco, cristal âmbar e portões coral fechado e verde-azulado aberto

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.

Lunaria Miri Energy

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.

Referências