Solução de problemas

Depósitos

Meu depósito não chegou

Siga esta lista:

1. Dê um tempo para a rede. O crédito acontece depois que o depósito é confirmado na blockchain, não quando você clica em enviar.
2. Verifique a rede. O endereço de depósito é da TRON (TRC-20). USDT enviado da Ethereum, da BNB Chain ou da rede interna de uma corretora nunca chega até ele — e não pode ser recuperado.
3. Verifique o mínimo. Depósitos abaixo do mínimo mostrado na janela Adicionar saldo podem não ser creditados.
4. Verifique o endereço. Ele deve ser o endereço da sua própria janela Adicionar saldo, não um de um guia ou de uma captura de tela.

Quando o crédito acontece, você recebe uma notificação deposit.credited e ele aparece em Carteira.

Posso depositar TRX diretamente?

Sim. Os saldos são mantidos em TRX, então um depósito em TRX dispensa a conversão. O USDT-TRC20 é convertido na taxa do momento da chegada.

Ordens

Minha ordem está como Created, não Filled

Isso é normal por um instante. Uma ordem fica Created quando recebemos o pagamento e iniciamos a entrega, e passa a Filled quando a entrega é confirmada — geralmente em poucos segundos.

Não fique consultando em loop. Ela se resolve sozinha, e você recebe uma notificação (ou um webhook order.filled).

Minha ordem falhou — cadê meu dinheiro?

De volta ao seu saldo. Uma ordem com falha é reembolsada automaticamente; você verá o reembolso em Carteira e receberá uma notificação order.failed. Se o saldo não refletir isso, nos informe o id da ordem.

Por que custou mais do que a prévia mostrou?

Quase sempre por causa da ativação do endereço: um endereço que nunca fez uma transação na TRON precisa ser ativado uma vez, o que custa 2 TRX a mais. A prévia só sabe incluir isso se você preencheu o endereço antes de ler o número. Faça a prévia de novo com o endereço preenchido e o valor vai bater.

A energia chegou, mas depois sumiu

A energia alugada é temporária — ela volta quando o período de aluguel que você escolheu termina. Se você precisa que ela fique, alugue por mais tempo ou use uma automação para que seja reposta.

Automações

Minha regra pausou sozinha

Seu saldo não cobria a próxima entrega, então pausamos a regra em vez de deixá-la falhar. Adicione saldo e depois retome.

Ative Retomar automaticamente e isso se resolve sozinho: uma regra pausada pelo sistema recomeça quando seu saldo puder cobrir uma entrega de novo. Uma regra que você pausou nunca é retomada automaticamente — isso é proposital.

Adicionei saldo, mas ela não retomou

Verifique três coisas:

1. A retomada automática está ativada? Ela é opcional, por regra.
2. Há saldo suficiente para uma entrega completa? Retomar com um saldo que não cobre um disparo faria a regra pausar de novo, então ela não retoma.
3. Quem a pausou? Se você a pausou manualmente, só você pode reiniciá-la.

Minha regra está ativa, mas nada está sendo entregue

Uma regra ativa que fica em silêncio por mais tempo do que a sua agenda indica é algo que detectamos e sinalizamos internamente. Se um endereço não está recebendo energia e a regra parece saudável, fale com a gente informando a regra e o endereço — não apague e recrie a regra, pois isso perde o histórico que usaríamos para diagnosticar.

Posso automatizar a bandwidth?

Não. As automações são somente de energia — a bandwidth está disponível como compra avulsa. Peça-a manualmente em Comprar energia.

API e agentes

403 api_key.insufficient_scope

A chave não tem permissão para isso. Os escopos são aninhados: full ⊇ purchase ⊇ read. Ler exige read, gastar (ordens, automações) exige purchase, gerenciar webhooks exige full. Emita uma chave com o escopo certo — veja Autenticação.

403 api_key.spend_limit_exceeded

A chave atingiu o seu limite de gasto diário. O limite é por chave, por dia do calendário UTC, e conta tanto as ordens feitas pela chave quanto as entregas de automações criadas por ela. Aumente o limite ou espere o dia virar.

Isso está funcionando como projetado — é a proteção que torna seguro entregar uma chave a um agente.

402 wallet.insufficient_balance

TRX insuficiente. Isso também ocorre ao criar uma renovação ou ativar o modo inteligente, porque ambos exigem saldo suficiente para pelo menos uma entrega logo de início.

Perdi minha API Key

As chaves são exibidas uma única vez e armazenadas com hash — não conseguimos recuperá-la. Revogue-a e emita uma nova.

Webhooks

Não estou recebendo entregas

Veja primeiro o registro de entregas do endpoint no painel — ele mostra cada tentativa e a resposta que recebemos. Depois:

1. O endpoint está ativado? Endpoints desativados são ignorados em silêncio.
2. Você está retornando 2xx? Qualquer outra resposta conta como falha e é reenviada (cerca de 30 s → 6 h, até 6 tentativas), após o que a entrega é marcada como falha.
3. Você está inscrito nesse evento? Um endpoint só recebe os tipos de evento que você selecionou para ele.
4. Envie um ping de teste para verificar o caminho de ponta a ponta.

Falhou ao adicionar o endpoint?

Aceitamos apenas URLs HTTPS públicas. http://, localhost e endereços IP privados ou internos são rejeitados ao adicionar o endpoint — então, se você está desenvolvendo localmente, coloque um túnel na frente do seu receptor.

A verificação da assinatura falha

Quase sempre é um destes casos:

1. Você verificou um corpo já processado. Assine os bytes brutos, antes de qualquer parse de JSON ou nova serialização — um corpo recodificado tem espaços em branco diferentes e o HMAC não vai bater.
2. Você esqueceu o timestamp. A string assinada é {timestamp}.{rawBody}, não só o corpo.
3. Você rotacionou o segredo e o receptor ainda tem o antigo.

O formato e um exemplo prático estão na referência de Webhooks.

Recebi o mesmo evento duas vezes

É proposital — as novas tentativas significam entrega ao menos uma vez. Faça a deduplicação pelo cabeçalho X-TronGas-Delivery.