Solución de problemas

Depósitos

Mi depósito no ha llegado

Sigue esta lista:

1. Dale un momento a la red. El abono ocurre cuando el depósito se confirma en la cadena, no cuando pulsas enviar.
2. Revisa la red. La dirección de depósito es TRON (TRC-20). El USDT enviado desde Ethereum, BNB Chain o la red interna de un exchange nunca llega, y no se puede recuperar.
3. Revisa el mínimo. Los depósitos por debajo del mínimo que muestra el cuadro Recargar podrían no abonarse.
4. Revisa la dirección. Debe ser la dirección de tu propio cuadro Recargar, no una de una guía o de una captura de pantalla.

Cuando se abona, recibes una notificación deposit.credited y aparece en Transacciones.

¿Puedo depositar TRX directamente?

Sí. El saldo se mantiene en TRX, así que un depósito en TRX se salta la conversión por completo. El USDT-TRC20 se convierte al tipo de cambio actual al llegar.

Órdenes

Mi orden dice Created, no Filled

Es normal por un momento. Una orden está en Created cuando recibimos el pago y empezamos la entrega, y pasa a Filled cuando se confirma la entrega, normalmente en unos segundos.

No la consultes en bucle. Se resuelve sola y recibirás una notificación (o un webhook order.filled).

Mi orden falló: ¿dónde está mi dinero?

De vuelta en tu saldo. Una orden fallida se reembolsa automáticamente; verás el reembolso en Transacciones y recibirás una notificación order.failed. Si el saldo no lo refleja, indícanos el id de la orden.

¿Por qué costó más de lo que decía la vista previa?

Casi siempre por la activación de la dirección: una dirección que nunca ha hecho una transacción en TRON debe activarse una vez, lo que cuesta 2 TRX adicionales. La vista previa solo sabe incluirlo si escribiste la dirección antes de leer la cifra. Vuelve a calcular la vista previa con la dirección ya escrita y coincidirá.

La energía llegó pero luego desapareció

La energía alquilada es temporal: vuelve cuando vence el período de alquiler que elegiste. Si necesitas que se quede, alquila por más tiempo o usa una automatización para que se reponga.

Automatizaciones

Mi regla se pausó sola

Tu saldo no cubría la siguiente entrega, así que la pausamos en lugar de dejarla fallar. Recarga y luego reanuda.

Activa Reanudar automáticamente y esto se arregla solo: una regla pausada por el sistema se reinicia en cuanto tu saldo vuelve a cubrir una entrega. Una regla que pausaste tú nunca se reanuda automáticamente: es a propósito.

Recargué pero no se reanudó

Revisa tres cosas:

1. ¿Está activada la reanudación automática? Es opcional, por regla.
2. ¿Hay suficiente para una entrega completa? Reanudar con un saldo que no cubre una activación solo volvería a pausarla, así que no lo hace.
3. ¿Quién la pausó? Si la pausaste a mano, solo tú puedes reiniciarla.

Mi regla está activa pero no se entrega nada

Una regla activa que se queda callada más tiempo del que implica su programación es algo que detectamos y marcamos internamente. Si una dirección no recibe energía y la regla parece sana, escríbenos con la regla y la dirección; no la borres y la vuelvas a crear sin más, porque eso pierde el historial que usaríamos para diagnosticarla.

¿Puedo automatizar el ancho de banda?

No. Las automatizaciones son solo de energía: el ancho de banda está disponible como compra puntual. Pídelo manualmente desde Comprar energía.

API y agentes

403 api_key.insufficient_scope

La clave no tiene permiso para eso. Los alcances están anidados: full ⊇ purchase ⊇ read. Leer requiere read, gastar (órdenes, automatizaciones) requiere purchase y gestionar webhooks requiere full. Emite una clave con el alcance correcto; consulta Autenticación.

403 api_key.spend_limit_exceeded

La clave alcanzó su límite de gasto diario. El límite es por clave y por día calendario UTC, y cuenta tanto las órdenes que hizo la clave como las entregas de las automatizaciones que esa clave creó. Sube el límite o espera a que cambie el día.

Esto funciona según lo diseñado: es la protección que hace seguro entregar una clave a un agente.

402 wallet.insufficient_balance

No hay suficiente TRX. También salta al crear una renovación o activar el modo inteligente, porque ambos requieren de antemano saldo suficiente para al menos una entrega.

Perdí mi API Key

Las claves se muestran una sola vez y se guardan con hash: no podemos recuperarla. Revócala y emite una nueva.

Webhooks

No estoy recibiendo entregas

Revisa primero el registro de entregas del endpoint en el panel: muestra cada intento y la respuesta que recibimos. Después:

1. ¿Está habilitado el endpoint? Los endpoints deshabilitados se omiten en silencio.
2. ¿Devuelves 2xx? Cualquier otra respuesta cuenta como fallo y se reintenta (de unos 30 s a 6 h, hasta 6 intentos), tras lo cual la entrega se marca como fallida.
3. ¿Estás suscrito a ese evento? Un endpoint solo recibe los tipos de evento que seleccionaste para él.
4. Envía un evento de prueba para comprobar el recorrido de extremo a extremo.

¿Falló al agregar el endpoint?

Solo aceptamos URLs HTTPS públicas. http://, localhost y las direcciones IP privadas o internas se rechazan al agregar el endpoint, así que si desarrollas en local, pon un túnel delante de tu receptor.

La verificación de la firma falla

Casi siempre es una de estas:

1. Verificaste un cuerpo ya procesado. Firma los bytes sin procesar, antes de cualquier análisis o reserialización de JSON: un cuerpo recodificado tiene otros espacios en blanco y el HMAC no coincidirá.
2. Omitiste la marca de tiempo. La cadena firmada es {timestamp}.{rawBody}, no solo el cuerpo.
3. Rotaste el secreto y el receptor sigue con el antiguo.

El formato y un ejemplo completo están en la referencia de Webhooks.

Recibí el mismo evento dos veces

Es a propósito: los reintentos implican una entrega al menos una vez. Elimina duplicados con la cabecera X-TronGas-Delivery.