API de alquiler de energía TRON para automatizar transferencias de USDT TRC-20
Automatiza el alquiler de energía TRON para billeteras, exchanges, mesas OTC y servicios de pago. Consulta precios en directo, crea pedidos idempotentes y paga mediante una transferencia o con tu saldo de TronBid.
- Precios de paquetes en directo
- Pago en la blockchain o con saldo
- Creación idempotente de pedidos
- Versión de la API
- v2
- Última actualización
- 2026-11-14
- URL base de producción
- https://tronbid.com/api/v2/quick-rent
Obtén tu clave de Quick Rent API
Obtén una integración en Dashboard → Quick Rent API con al menos 50 TRX de saldo disponible en tu cuenta de TronBid. Inicia sesión con correo o cartera; las cuentas de correo no necesitan una cartera vinculada. Pulsa GET API KEY, guarda y activa la clave. El pago con saldo se habilita automáticamente. Los 50 TRX no se cobran ni se bloquean: es solo un requisito inicial. Si después el saldo baja de 50 TRX, la clave sigue activa.
GET API KEYEn esta página
Primeros pasos
Qué ofrece la API y a quién va dirigida
La API de Quick Rent permite alquilar energía TRON de forma automática. Utilizar energía puede reducir el coste de enviar USDT TRC-20 y de ejecutar otros contratos inteligentes frente a pagar quemando TRX.
Tu programa, ya sea un sitio web, un bot o un servicio, compra la energía cuando la necesita. Por ejemplo, antes de cada transferencia de USDT de un cliente.
El proceso es parecido al de una máquina expendedora: consultas el precio, pagas y recibes lo que has comprado. Con la API, es tu programa el que realiza esos pasos.
- 1Consulta el precio
Tu programa pregunta a la API cuánto cuesta en ese momento el paquete de energía que necesita.
- 2Crea el pedido y paga
Tu programa crea el pedido y lo paga enviando TRX a la dirección indicada o utilizando el saldo de TronBid.
- 3Recibe la energía
La energía llega a la billetera destinataria en segundos y permite enviar USDT con un coste menor.
La API es una herramienta para desarrolladores: para utilizarla hay que escribir código que envíe las solicitudes.
Si no vas a programar una integración, puedes alquilar desde Quick Rent en el sitio web o mediante el bot de Telegram. Obtendrás la energía realizando los pasos manualmente.
Glosario
Definiciones de los términos que aparecen en esta documentación.
- Energía (Energy)
- Recurso de TRON necesario para ejecutar contratos inteligentes. Si no hay suficiente, la red quema TRX para cubrir el coste, lo que puede resultar más caro que alquilar energía.
- TRX
- Moneda nativa de TRON. Se utiliza para pagar el alquiler de energía y las comisiones de la red.
- USDT TRC-20
- Versión de USDT en TRON, una stablecoin vinculada al dólar. Transferirla requiere ejecutar un contrato inteligente y consumir energía.
- Clave de API
- Credencial secreta para acceder a la API. Se envía con cada solicitud y debe guardarse únicamente en el servidor.
- Endpoint
- Ruta concreta de la API a la que tu programa envía una solicitud. Por ejemplo, /quote permite consultar un precio.
- GET / POST
- Métodos de solicitud. GET se utiliza para consultar datos; POST, para realizar una acción, como crear un pedido o calcular un precio.
- Token Bearer
- Forma de enviar la clave de API mediante la cabecera Authorization: Bearer YOUR_KEY.
- Pago en la blockchain
- Pago mediante una transferencia de TRX a la dirección indicada. Está disponible por defecto, sin activación previa.
- Pago con saldo
- Pago desde el saldo disponible de la cuenta TronBid. Se habilita automáticamente para nuevas integraciones de Quick Rent API obtenidas por autoservicio; las claves existentes mantienen sus permisos.
- Delegación
- Asignación temporal de la energía alquilada a la billetera destinataria durante el plazo contratado, por ejemplo, 15 o 60 minutos.
- Consulta periódica (polling)
- Consulta del estado del pedido cada pocos segundos hasta que pase a delegated o termine con un error.
- idempotency_key
- Identificador único que asignas al pedido. Si repites la solicitud, la API devuelve el mismo pedido en lugar de crear otro, para evitar pagos duplicados.
Antes de empezar
Prepara lo siguiente antes de enviar tu primera solicitud.
- 1Obtén una clave de API
Inicia sesión con correo o cartera y ten al menos 50 TRX de saldo disponible en TronBid. Las cuentas de correo no necesitan vincular una cartera. Abre Dashboard → Quick Rent API y pulsa GET API KEY. Guarda la clave y actívala. Una integración por cuenta, sin cobro ni bloqueo de fondos. Si después el saldo baja de 50 TRX, la clave sigue activa.
- 2Elige la billetera TRON destinataria
Determina qué dirección necesita la energía (target_address). Normalmente será la billetera desde la que tus clientes envían USDT.
- 3Elige un paquete del catálogo
Quick Rent ofrece paquetes de 65 000, 131 000, 196 500, 262 000, 524 000 y 1 048 000 unidades de energía durante 15 o 60 minutos. Consulta los paquetes disponibles en el endpoint del catálogo, que no requiere autenticación.
- 4Prepara el pago
Para pagar en la red, envía TRX desde cualquier cartera a la dirección asignada. Las nuevas claves de autoservicio tienen el pago con saldo activado; usa payment_mode: balance para pagar con el saldo disponible de TronBid.
Introducción
La API de Quick Rent permite a tu servicio alquilar energía TRON automáticamente para reducir el coste de enviar USDT TRC-20 y ejecutar otros contratos inteligentes frente a la quema de TRX.
Todos los endpoints utilizan la misma URL base.
https://tronbid.com/api/v2/quick-rentModalidades de pago
Puedes pagar de dos formas. Si omites payment_mode, se utiliza el pago en la blockchain. Para pagar con el saldo disponible de TronBid, envía payment_mode: balance. Las nuevas integraciones obtenidas por autoservicio tienen el pago con saldo habilitado automáticamente; no hace falta solicitarlo a soporte.
Las integraciones existentes y las concedidas manualmente conservan sus permisos configurados; un administrador puede habilitar o deshabilitar el pago con saldo. Si está deshabilitado para tu integración, payment_mode: balance devuelve 403 BALANCE_PAYMENT_NOT_ENABLED. En ese caso, contacta con soporte para cambiar el permiso o paga en la blockchain.
| Modalidad | Cómo activarla | Pago |
|---|---|---|
on-chain | Modalidad predeterminada: omite payment_mode o utiliza "onchain" | Envía una sola transferencia de TRX desde CUALQUIER cartera a pay_address antes de expires_at. El recurso llegará a target_address, no automáticamente al remitente. |
balance | payment_mode: balance; habilitado automáticamente en nuevas integraciones de autoservicio. Las existentes y manuales conservan sus permisos. | Se descuenta del saldo en TRX de tu cuenta de TronBid |
Catálogo de paquetes
energy_amount y duration_minutes deben coincidir con un paquete activo de Quick Rent. Los paquetes de energía son de 65000, 131000, 196500, 262000, 524000 y 1048000 unidades, durante 15 o 60 minutos. El paquete de 196500 durante 15 minutos cuesta tres veces el precio vigente del paquete de 65000 durante 15 minutos. Los precios son dinámicos: solicita una cotización actualizada antes de crear el pedido. Los pedidos ya creados conservan el precio fijado al crearlos.
También hay Bandwidth: usa resource_type: bandwidth, energy_amount: 5000, 10000, 15000, 25000, 50000 o 100000, y duration_minutes: 60 (1 hora), 1440 (1 día) o 4320 (3 días). Consulta su catálogo actual con ?resource_type=bandwidth. Custom Locked solo se aplica a Energy.
Puedes consultar el catálogo vigente en cualquier momento, sin autenticación:
curl -sS https://tronbid.com/api/public/quick-rent/skusPaquetes de Bandwidth
Utiliza los mismos métodos de cotización, pedido, estado, pago e idempotencia que para Energy. Envía resource_type: bandwidth explícitamente; energy_amount indica la cantidad de Bandwidth para este recurso. Cantidades admitidas: 5000, 10000, 15000, 25000, 50000 y 100000. Duraciones: 60, 1440 y 4320 minutos (1 hora, 1 día y 3 días).
Consulta el catálogo actual y solicita una cotización nueva antes de realizar el pedido. La cotización muestra la disponibilidad y price_trx, el precio total en TRX para la cantidad y duración elegidas. Los descuentos de Energy no se aplican a Bandwidth.
Un pedido conserva la cantidad, duración y precio registrados al crearlo. Para reintentar, utiliza el mismo idempotency_key y el mismo paquete. Si se agota el tiempo de espera, consulta el estado del pedido original en lugar de crear otra compra.
BANDWIDTH_SUPPLIER_UNAVAILABLE (HTTP 503) indica que el paquete de Bandwidth seleccionado no está disponible temporalmente. Reintenta más tarde o elige otro paquete disponible.
curl -sS "https://tronbid.com/api/public/quick-rent/skus?resource_type=bandwidth"curl -sS -X POST "https://tronbid.com/api/v2/quick-rent/quote" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json" \
-d '{"resource_type":"bandwidth","energy_amount":25000,"duration_minutes":4320}'curl -sS -X POST "https://tronbid.com/api/v2/quick-rent/orders" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"resource_type": "bandwidth",
"energy_amount": 25000,
"duration_minutes": 4320,
"payment_mode": "balance",
"target_address": "<ACTIVATED_TRON_ADDRESS>",
"idempotency_key": "partner-bandwidth-3days-001"
}'Flujos de trabajo
Inicio rápido: de la primera solicitud a la energía
Este ejemplo recorre el proceso completo con pago en la blockchain. En cuatro pasos, la billetera recibe la energía.
A continuación se explica cada paso y la respuesta de la API. Sustituye la clave, las direcciones y el ID del pedido por tus propios datos.
- 1Paso 1. Consulta el precio: POST /quote
Envía la cantidad de energía y la duración. Recibirás price_trx y los segundos durante los que la cotización es válida.
- 2Paso 2. Crea el pedido: POST /orders
Envía el paquete, idempotency_key y target_address (destinatario del recurso). La respuesta incluye pay_address, amount_trx, expires_at y payment_sender_mode.
- 3Paso 3. Paga
Envía una sola transferencia de TRX desde CUALQUIER cartera a pay_address antes de expires_at. El recurso llegará a target_address, no automáticamente al remitente.
- 4Paso 4. Espera la energía: GET /orders/:id
Consulta el estado cada pocos segundos hasta que sea delegated. Ese estado confirma que la energía ya se ha delegado a la billetera.
{
"price_trx": "3.200000",
"available": true,
"save_percent": 62,
"expires_in_sec": 30
}{
"id": "uuid",
"status": "pending_payment",
"payment_mode": "onchain",
"payment_sender_mode": "any_wallet",
"pay_address": "TDeposit...",
"amount_trx": "3.200000",
"energy_amount": 131000,
"duration_minutes": 15,
"expires_at": "2026-04-29T13:15:00.000Z",
"qr_payload": "tron:TDeposit...?amount=3.200000",
"duplicate": false,
"target_address": "TTarget..."
}# poll every 3s until the order is done
while true; do
STATUS=$(curl -sS "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID" \
-H "Authorization: Bearer $API_KEY" | jq -r .status)
echo "status: $STATUS"
case "$STATUS" in
delegated|failed|expired|cancelled) break ;;
esac
sleep 3
done{
"id": "uuid",
"status": "delegated",
"delivery_complete": true,
"txid_delegate": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"txids_delegate": ["aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"],
"payment_mode": "onchain",
"payment_sender_mode": "any_wallet",
"amount_trx": "3.200000",
"expected_amount_trx": "3.200000",
"paid_amount_trx": "3.200000",
"effective_price_trx": null,
"energy_amount": "131000",
"effective_energy_amount": null,
"duration_minutes": 15,
"pay_address": "TDeposit...",
"payer_address": "TPayer...",
"target_address": "TTarget...",
"error_code": null,
"error_message": null
}Flujo de pago en la blockchain
Envía el paquete, idempotency_key y target_address (destinatario del recurso). La respuesta incluye pay_address, amount_trx, expires_at y payment_sender_mode.
Envía una sola transferencia de TRX desde CUALQUIER cartera a pay_address antes de expires_at. El recurso llegará a target_address, no automáticamente al remitente.
Usa target_address para el destinatario. Por compatibilidad, payer_address se usa como destinatario cuando se omite target_address; los pedidos nuevos no restringen la cartera que paga.
Cada pedido recibe una dirección disponible durante 15 minutos. Si no hay ninguna, HTTP 503 PAYMENT_WALLETS_BUSY indica que debes repetir la misma solicitud más tarde. Un pago menor o mayor ajusta effective_energy_amount; no se suman pagos separados. El pago mínimo detectado es de 0,9 TRX.
No envíes después de expires_at ni reutilices una dirección de pago. Las direcciones se reasignan: una transferencia posterior corresponde al pedido que use esa dirección en ese momento.
{
"energy_amount": 131000,
"duration_minutes": 15,
"idempotency_key": "your-unique-key-001",
"target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}{
"id": "uuid",
"status": "pending_payment",
"payment_mode": "onchain",
"payment_sender_mode": "any_wallet",
"pay_address": "TDeposit...",
"amount_trx": "3.200000",
"energy_amount": 131000,
"duration_minutes": 15,
"expires_at": "2026-04-29T13:15:00.000Z",
"qr_payload": "tron:TDeposit...?amount=3.200000",
"duplicate": false,
"target_address": "TTarget..."
}Flujo de pago con saldo
Paso 1: consulta tus TRX con GET /balance. Paso 2: obtén el precio con POST /quote. Paso 3: envía POST /orders con payment_mode: balance para descontar el importe e iniciar la delegación. Paso 4: consulta GET /orders/:id hasta que el estado sea delegated. Si falla la delegación, el estado pasa a failed y los TRX se devuelven al saldo.
No necesitas payer_address: paga la cuenta vinculada a tu clave de API. La bonificación del 1% solo se aplica a los paquetes de 524000 y 1048000 Energy durante 15 o 60 minutos: recibirás 529240 y 1058480 Energy, respectivamente. Los demás paquetes no tienen bonificación. Los pedidos ya creados conservan la cantidad de Energy acordada.
Para añadir TRX, envía POST /balance-topups con un UUID client_request_id guardado, realiza una sola transferencia a payment_address y consulta GET /balance-topups/:id hasta credited. Después consulta GET /balance y continúa con el presupuesto y los pedidos pagados con saldo.
{
"energy_amount": 131000,
"duration_minutes": 15,
"idempotency_key": "your-unique-key-balance-001",
"payment_mode": "balance",
"target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}{
"id": "uuid",
"status": "delegating",
"payment_mode": "balance",
"payment_sender_mode": null,
"pay_address": null,
"amount_trx": "3.200000",
"energy_amount": 131000,
"duration_minutes": 15,
"expires_at": null,
"qr_payload": null,
"duplicate": false,
"target_address": "TTarget..."
}Custom Locked: bloqueo de 1 a 15 minutos (API de energía)
Añade custom_lock_minutes a POST /quote y POST /orders para elegir un bloqueo de energía en minutos enteros: 1, 2, 3… hasta 15. Estos pedidos requieren una clave de API y admiten pagos en la blockchain o con saldo, si está habilitado. La opción no está disponible para ancho de banda, el formulario del sitio web ni el bot de Telegram.
Mantén duration_minutes en 15: este campo selecciona el paquete de precios. custom_lock_minutes determina el bloqueo real. Utiliza un energy_amount de un paquete activo de 15 minutos. El precio y la bonificación de energía son los mismos que los de ese paquete, sin descuento proporcional por minutos. Consulta el precio actual en /quote; los ejemplos no fijan un precio.
El campo es opcional y no tiene un valor predeterminado implícito. Si lo omites, se mantienen el comportamiento de 15 o 60 minutos, los precios y el formato de respuesta existentes. Envía un entero JSON: las cadenas, los decimales, null, 0, los negativos y los valores superiores a 15 se rechazan con HTTP 400. También se rechaza Custom Locked con duration_minutes: 60 o resource_type: bandwidth.
Envía una sola transferencia de TRX desde CUALQUIER cartera a pay_address antes de expires_at. El recurso llegará a target_address, no automáticamente al remitente. Usa target_address para el destinatario. Por compatibilidad, payer_address se usa como destinatario cuando se omite target_address; los pedidos nuevos no restringen la cartera que paga. Para pagar con saldo, indica target_address y payment_mode: balance; la clave API debe tener habilitado el pago con saldo.
El bloqueo empieza cuando la delegación se incluye en TRON, no al consultar el precio, crear el pedido o pagar. Un minuto equivale a 20 bloques de TRON, aproximadamente 60 segundos. Guardamos el vencimiento real en delegation_expires_at. El expires_at de la respuesta de pago es un plazo distinto: la fecha límite para pagar.
Consulta GET /orders/:id, por ejemplo cada 3 segundos. Las respuestas de Custom Locked incluyen custom_lock_minutes y lock_period_blocks. El endpoint de estado también devuelve delegation_expires_at, reclaim_status, txid_delegate, txid_reclaim y reclaimed_at. Las fechas y los IDs de transacción aún no disponibles tienen el valor null.
Ciclo del pedido: pending_payment (solo para pagos en la blockchain) → delegating → delegated → undelegating → completed. delegated confirma la entrega de la energía. undelegating indica que el bloqueo terminó y se está retirando la delegación; reclaim_status es pending. completed junto con reclaim_status: confirmed significa que la transacción de retirada está confirmada de forma irreversible en la blockchain. No necesitas enviar una solicitud de retirada adicional.
La retirada se intenta cuando TRON confirma que la delegación está desbloqueada. La producción de bloques, la carga de la cola y la disponibilidad de la red pueden retrasar el envío; la confirmación de la red requiere tiempo adicional. Nunca se retira una delegación antes de que venza el bloqueo en la red.
Los pedidos, las transacciones firmadas y los intentos de retirada se guardan de forma persistente. Tras un reinicio o un tiempo de espera agotado de la red, se retoma la misma transacción, sin crear otro alquiler. Los fallos temporales de la red se reintentan automáticamente.
Reutiliza la misma idempotency_key al reintentar. Si cambias, añades o eliminas custom_lock_minutes con una clave existente, recibirás 409 IDEMPOTENCY_CUSTOM_LOCK_MISMATCH. Utiliza una clave nueva para un bloqueo distinto. Las reglas existentes sobre cambios de modalidad de pago siguen vigentes.
Los webhooks configurados conservan su firma y su mecanismo de entrega. Los eventos de Custom Locked incluyen los campos opcionales del bloqueo: quick_buy.delegated al entregar la energía; quick_buy.expired con status: completed y txid_reclaim tras confirmar la retirada; o quick_buy.failed si se verifica que la delegación falló. Elimina duplicados mediante event_id. Si el resultado aún no se puede confirmar, consulta el pedido existente en lugar de crear otro.
Espera a delegated antes de utilizar la Energy. El bloqueo personalizado no es el plazo de pago. Reclaim finaliza la delegación del recurso; no es un reembolso del precio del alquiler.
curl -sS -X POST https://tronbid.com/api/v2/quick-rent/quote \
-H "Content-Type: application/json" \
-d '{
"energy_amount": 131000,
"resource_type": "energy",
"duration_minutes": 15,
"custom_lock_minutes": 5
}'curl -sS -X POST https://tronbid.com/api/v2/quick-rent/orders \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"energy_amount": 131000,
"resource_type": "energy",
"duration_minutes": 15,
"custom_lock_minutes": 5,
"payment_mode": "balance",
"target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX",
"idempotency_key": "partner-custom-5min-balance-001"
}'curl -sS -X POST https://tronbid.com/api/v2/quick-rent/orders \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"energy_amount": 131000,
"resource_type": "energy",
"duration_minutes": 15,
"custom_lock_minutes": 5,
"target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX",
"idempotency_key": "partner-custom-5min-onchain-001"
}'{
"id": "00000000-0000-4000-8000-000000000001",
"status": "delegated",
"duration_minutes": 15,
"custom_lock_minutes": 5,
"lock_period_blocks": 100,
"delegation_expires_at": "2026-09-27T12:05:00.000Z",
"reclaim_status": "not_started",
"txid_delegate": "<delegation transaction hash>",
"txid_reclaim": null,
"reclaimed_at": null
}Estados del pedido
El pedido pasa por los siguientes estados. Consulta GET /orders/:id para seguir su evolución.
| Estado | Significado |
|---|---|
pending_payment | Esperando el pago en la blockchain |
delegating | Pago recibido o saldo descontado; delegación en curso |
delegated | Energía delegada |
cancelled | Cancelado antes del pago en la blockchain |
expired | Plazo de pago en la blockchain agotado |
failed | Error; si se pagó con saldo, se devuelven los TRX |
undelegating | Bloqueo personalizado finalizado; retirada de recursos pendiente de confirmación |
completed | Retirada de los recursos de Custom Locked confirmada en la blockchain |
Idempotencia
idempotency_key es el identificador único que asignas al pedido y debe tener entre 8 y 128 caracteres. Si repites POST /orders con la misma clave para el mismo cliente de API, recibirás el mismo pedido con "duplicate": true.
No reutilices una idempotency_key con modalidades de pago distintas (onchain y balance): recibirás 409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH.
Referencia de la API
Disponibilidad de Energy para un destinatario
Comprueba si Quick Rent Energy está disponible para un destinatario antes de crear un pedido. POST /api/v2/quick-rent/availability utiliza tu clave Bearer existente y los mismos límites por clave e IP que los demás métodos autenticados. No requiere una clave de idempotencia.
Envía target_address con una dirección TRON Base58 válida. resource_type es opcional y solo admite energy. No envíes energy_amount, duration_minutes, custom_lock_minutes ni datos de pago a este endpoint. La comprobación no admite ancho de banda.
HTTP 200 con available: true y reason: AVAILABLE indica que actualmente se puede realizar una nueva delegación al destinatario. HTTP 200 con available: false y reason: ALL_POOLS_BUSY indica que no está disponible temporalmente. NO_ELIGIBLE_POOLS indica que no hay una opción adecuada para esa dirección en este momento. La falta de disponibilidad es un resultado normal, no un error HTTP.
La comprobación considera delegaciones activas y pendientes, incluidos los estados delegating, delegate_confirming, undelegating y delegated activo. Un pedido Custom Locked puede impedir una nueva delegación hasta que se procese Reclaim, incluso después de vencer el bloqueo. checked_at es la hora UTC de finalización de la comprobación, no una promesa de disponibilidad.
HTTP 400: INVALID_REQUEST si el JSON no es válido, faltan campos, hay campos desconocidos o el recurso no es compatible; INVALID_TARGET_ADDRESS si la dirección o su suma de comprobación no son válidas. HTTP 401: clave ausente, no válida o deshabilitada. HTTP 429: límite de solicitudes superado. HTTP 503: QUICK_RENT_DISABLED o AVAILABILITY_CHECK_UNAVAILABLE si no pueden verificarse la base de datos, la configuración del firmante o la blockchain. Un 503 significa que el resultado es desconocido; no lo interpretes como disponibilidad ni como ocupación.
Secuencia sugerida: comprobar el destinatario, solicitar una cotización de la cantidad deseada y crear el pedido normalmente. Si no está disponible, espera o utiliza otro destinatario. Reintenta los fallos temporales con intervalos crecientes. Los métodos y respuestas existentes no cambian; esta comprobación es opcional.
/api/v2/quick-rent/availabilityParámetros
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
target_address | string | Obligatorio. Dirección TRON Base58 del destinatario con una suma de comprobación válida. | TWLaGaf3k6dbiEWvif1tNLeKuTErk2Tron |
resource_type | "energy" | Opcional. Solo admite energy, que es también el valor predeterminado. | energy |
Este método solo comprueba la disponibilidad actual para el destinatario. No crea pedidos, descuenta saldo, delega Energy ni reserva recursos. No comprueba cantidad, precio, saldo, activación de la cuenta ni restricciones del Marketplace. La disponibilidad puede cambiar antes de crear el pedido: sigue gestionando HTTP 409 ACTIVE_DELEGATION_EXISTS y los demás errores existentes. Es compatible con Energy normal y Custom Locked.
curl -sS -X POST https://tronbid.com/api/v2/quick-rent/availability \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"target_address": "TWLaGaf3k6dbiEWvif1tNLeKuTErk2Tron"
}'{
"resource_type": "energy",
"target_address": "TWLaGaf3k6dbiEWvif1tNLeKuTErk2Tron",
"available": true,
"reason": "AVAILABLE",
"checked_at": "2026-09-30T12:00:00.000Z"
}{
"resource_type": "energy",
"target_address": "TWLaGaf3k6dbiEWvif1tNLeKuTErk2Tron",
"available": false,
"reason": "ALL_POOLS_BUSY",
"checked_at": "2026-09-30T12:00:00.000Z"
}{
"error": "AVAILABILITY_CHECK_UNAVAILABLE",
"message": "Availability could not be verified. Retry later."
}Calculadora
Estima la energía necesaria para una transferencia. Indica la billetera destinataria y si ya tiene USDT.
/api/v2/quick-rent/calculatorParámetros
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
wallet_address | string | Dirección TRON que se va a analizar | TXXXXXXXX...XXXX |
has_usdt | boolean | null | Indica si el destinatario ya tiene USDT, lo que afecta a la energía necesaria. Envía true, false u omite el campo. | true |
{
"wallet_address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"has_usdt": true
}curl -sS -X POST "$BASE_URL/api/v2/quick-rent/calculator" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"wallet_address":"TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX","has_usdt":true}'Consultar el precio
Devuelve el precio actual del paquete (price_trx), su disponibilidad, el porcentaje de ahorro (save_percent) y la validez de la cotización en segundos (expires_in_sec).
/api/v2/quick-rent/quoteParámetros
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
energy_amount | int | Cantidad del recurso del catálogo activo: Energy por defecto, o Bandwidth cuando resource_type es bandwidth | 131000 |
resource_type | string | energy (por defecto) o bandwidth. Bandwidth no admite custom_lock_minutes. | bandwidth |
duration_minutes | int | Energy: 15 o 60. Bandwidth: 60, 1440 (1 día) o 4320 (3 días). Debe coincidir con un paquete activo. | 15 |
custom_lock_minutes | integer | Entero opcional entre 1 y 15, ambos incluidos. Solo para la API de energía y con duration_minutes: 15. Omítelo para mantener el comportamiento existente. | 5 |
{
"price_trx": "3.200000",
"available": true,
"save_percent": 62,
"expires_in_sec": 30
}export BASE_URL="https://tronbid.com"
export API_KEY="your_api_key"
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/quote" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"energy_amount":131000,"duration_minutes":15}'Crear un pedido
Crea un pedido de alquiler. Para pagar on-chain, indica target_address y paga desde cualquier cartera a pay_address. Para pagar con saldo, indica payment_mode: balance; se cobra inmediatamente a la cuenta vinculada.
Usa target_address para el destinatario. Por compatibilidad, payer_address se usa como destinatario cuando se omite target_address; los pedidos nuevos no restringen la cartera que paga.
Si se confirma que la dirección del destinatario no está activada en TRON, el nuevo pedido se rechaza con HTTP 400 TARGET_ACCOUNT_NOT_ACTIVATED antes de realizar el pago o reservar fondos. Activa la dirección y vuelve a intentarlo. Si la comprobación de activación no está disponible temporalmente, no bloquea la creación del pedido; las demás validaciones y reglas de pago siguen vigentes.
Cada pedido recibe una dirección disponible durante 15 minutos. Si no hay ninguna, HTTP 503 PAYMENT_WALLETS_BUSY indica que debes repetir la misma solicitud más tarde. Un pago menor o mayor ajusta effective_energy_amount; no se suman pagos separados.
/api/v2/quick-rent/ordersParámetros
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
energy_amount | int | Cantidad del recurso del catálogo activo: Energy por defecto, o Bandwidth cuando resource_type es bandwidth | 131000 |
resource_type | string | energy (por defecto) o bandwidth. Bandwidth no admite custom_lock_minutes. | bandwidth |
duration_minutes | int | Energy: 15 o 60. Bandwidth: 60, 1440 (1 día) o 4320 (3 días). Debe coincidir con un paquete activo. | 15 |
idempotency_key | string | Identificador único del pedido en tu sistema, de 8 a 128 caracteres | partner-onchain-001 |
payment_mode | string | Opcional: "onchain" (por defecto) o "balance". | balance |
payer_address | string | Alias antiguo del destinatario cuando falta target_address. No restringe quién puede pagar un pedido nuevo. | TPayer... |
target_address | string | Destinatario del recurso. Obligatorio para balance; para on-chain usa este campo o el antiguo alias payer_address. | TTarget... |
custom_lock_minutes | integer | Entero opcional entre 1 y 15, ambos incluidos. Solo para la API de energía y con duration_minutes: 15. Omítelo para mantener el comportamiento existente. | 5 |
{
"id": "uuid",
"status": "pending_payment",
"payment_mode": "onchain",
"payment_sender_mode": "any_wallet",
"pay_address": "TDeposit...",
"amount_trx": "3.200000",
"energy_amount": 131000,
"duration_minutes": 15,
"expires_at": "2026-04-29T13:15:00.000Z",
"qr_payload": "tron:TDeposit...?amount=3.200000",
"duplicate": false,
"target_address": "TTarget..."
}{
"id": "uuid",
"status": "delegating",
"payment_mode": "balance",
"payment_sender_mode": null,
"pay_address": null,
"amount_trx": "3.200000",
"energy_amount": 131000,
"duration_minutes": 15,
"expires_at": null,
"qr_payload": null,
"duplicate": false,
"target_address": "TTarget..."
}curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"energy_amount": 131000,
"duration_minutes": 15,
"idempotency_key": "partner-onchain-001",
"target_address": "TTarget..."
}'curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"energy_amount": 131000,
"duration_minutes": 15,
"idempotency_key": "partner-balance-001",
"payment_mode": "balance",
"target_address": "TTarget..."
}'Consultar el estado de un pedido
Devuelve el estado, payment_mode, los importes y las direcciones. Si hubo un fallo, incluye error_code y error_message. effective_energy_amount refleja la energía realmente delegada tras ajustar un pago de más o de menos.
amount_trx es una cadena decimal en TRX, por ejemplo, "1.500000". En los pagos con saldo indica el cargo registrado del pedido; en los pagos on-chain, el importe esperado, igual que al crear el pedido. Para pedidos antiguos sin un importe esperado se utiliza el precio guardado. Este campo por sí solo no confirma el pago, la entrega ni un reembolso. Los campos existentes conservan su significado: paid_amount_trx es el pago entrante registrado y puede ser null en pedidos pagados con saldo; expected_amount_trx es el pago esperado; effective_price_trx puede contener el precio ajustado tras un pago inferior o superior al solicitado. Comprueba status y delivery_complete para saber si se entregaron los recursos.
refund contiene un objeto solo cuando consta un reembolso completado al saldo correspondiente al intento de pago actual; en los demás casos es null. status: completed confirma el abono; amount_trx es el importe reembolsado en TRX como cadena decimal; refunded_at es la fecha y hora en UTC con formato ISO 8601; destination es account_balance o bot_balance. El estado failed por sí solo no confirma un reembolso. null tampoco demuestra que nunca se haya reembolsado el pedido: los pedidos antiguos pueden no tener ese registro. El importe puede excluir una activación de cartera ya completada. El campo amount_trx del nivel superior sigue indicando el cargo original, no el importe neto tras el reembolso. Una nueva ejecución con cargo inicia otro intento de pago; el reembolso anterior no se presenta como un reembolso de ese nuevo pago.
txid_delegate es el hash de la transacción de delegación en TRON tanto para pedidos normales como para Custom Locked. No es el ID del pedido de TronBid ni el hash de pago payment_txid. Cuando status es delegated, el hash guardado se devuelve en la misma respuesta y sigue disponible al finalizar el alquiler. Es null hasta que se guarda el hash principal; los registros antiguos sin hash guardado también pueden devolver null.
txids_delegate es una lista de hashes de delegación guardados, sin duplicados. Normalmente contiene uno; si el pedido se ejecuta mediante varias transacciones, contiene todos los hashes guardados. txid_delegate sigue siendo una cadena o null; si existe, el hash principal aparece primero en la lista. Sin hashes guardados se devuelve []. Un hash puede aparecer antes de confirmarse, y las transacciones parciales antes de completar la entrega: compruebe status y delivery_complete, no solo la presencia de un hash.
Consulte la transacción en https://tronscan.org/#/transaction/{txid}. Estos campos amplían la respuesta existente de GET /api/v2/quick-rent/orders/{id}: la URL, las claves, los parámetros, los campos existentes y los estados no cambian. Las integraciones que ignoran campos desconocidos siguen funcionando sin cambios. Si valida un esquema estricto, permita campos adicionales. No se requiere una clave nueva ni un parámetro adicional para recibir los hashes.
payment_sender_mode es any_wallet para facturas nuevas, specified_wallet para antiguas y null para saldo. pay_address corresponde solo a esta factura. Tras detectar el pago on-chain, payer_address en el estado es el remitente real, no el destinatario del recurso.
/api/v2/quick-rent/orders/:idParámetros
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
id | string | ID del pedido, como parámetro de ruta | uuid |
{
"id": "uuid",
"status": "delegated",
"delivery_complete": true,
"txid_delegate": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"txids_delegate": ["aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"],
"payment_mode": "onchain",
"payment_sender_mode": "any_wallet",
"amount_trx": "3.200000",
"expected_amount_trx": "3.200000",
"paid_amount_trx": "3.200000",
"effective_price_trx": null,
"energy_amount": "131000",
"effective_energy_amount": null,
"duration_minutes": 15,
"pay_address": "TDeposit...",
"payer_address": "TPayer...",
"target_address": "TTarget...",
"error_code": null,
"error_message": null
}{
"id": "uuid",
"status": "delegated",
"delivery_complete": true,
"txid_delegate": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"txids_delegate": [
"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
]
}curl -sS "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID" \
-H "Authorization: Bearer $API_KEY"Cancelar un pedido
Cancela un pedido que sigue en pending_payment. Solo se aplica a pagos en la blockchain. Una vez delegada la energía, ya no se puede cancelar.
/api/v2/quick-rent/orders/:id/cancelParámetros
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
id | string | ID del pedido, como parámetro de ruta | uuid |
curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/cancel" \
-H "Authorization: Bearer $API_KEY"Consultar el saldo
Devuelve el saldo en TRX de la cuenta de TronBid vinculada a tu clave de API. Es el saldo dentro de la plataforma, no el de una billetera en la blockchain. Requiere la cabecera Authorization.
El importe incluye los saldos válidos del correo y la cartera vinculados actualmente. Para añadir fondos por API, crea una recarga y espera a status: credited.
/api/v2/quick-rent/balance{ "balance_trx": "150.500000" }curl -sS "$BASE_URL/api/v2/quick-rent/balance" \
-H "Authorization: Bearer $API_KEY"Crear una recarga de saldo
Usa tu clave de API habilitada actual. No necesitas permiso para pagar con saldo para realizar una recarga; ese permiso solo se exige al comprar recursos con payment_mode: balance. Este endpoint crea o devuelve una factura. No envía TRX ni crea un pedido de alquiler.
Envía JSON con client_request_id: un UUID generado y guardado antes de la primera solicitud. Repetir el mismo UUID devuelve la sesión original, incluso tras el abono, la cancelación o el vencimiento. Un UUID distinto recupera una factura pending existente con su vencimiento original; si no existe, crea una factura nueva.
La recarga pertenece a la cuenta de correo o cartera propietaria de la clave API. No puedes seleccionar otro propietario ni correo. GET /balance suma los saldos elegibles de correo y cartera actualmente vinculados; vincular cuentas no cambia el propietario de una factura existente.
Crear, recuperar y repetir devuelven HTTP 200. Envía application/json solo con client_request_id (máximo 8192 bytes); no se aceptan importe, titular, dirección, vencimiento ni parámetros de consulta. La idempotencia pertenece al cliente API y se conserva al rotar su clave. Otro cliente API tiene un espacio de solicitudes distinto. El cuerpo debe recibirse completo en 5 segundos; de lo contrario se devuelve HTTP 408 REQUEST_TIMEOUT. Reintenta con el mismo client_request_id, sin enviar otra transferencia.
/api/v2/quick-rent/balance-topupsParámetros
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
client_request_id | string (UUID) | UUID obligatorio, versiones 1–5; se recomienda UUIDv4. Guárdalo antes de la primera solicitud y reutilízalo con el mismo cliente API. La respuesta lo normaliza a minúsculas. | 9f5a6f60-b8ec-4b45-9e22-2bf5a1d9f101 |
Envía una sola transferencia de TRX nativo en la red TRON desde cualquier cartera a payment_address. No se necesita memo. Elige el importe; el mínimo es 0.000001 TRX. Tras la confirmación se abona el importe completo de la transferencia aceptada.
La ventana de la dirección dura 15 minutos. Compara expires_at con server_time. La transacción debe incluirse en la cadena durante esa ventana; difundirla antes del plazo no basta. No reutilices la dirección tras el pago o el vencimiento.
Si POST agota el tiempo de espera, repítelo con el MISMO client_request_id para recuperar la factura original. No crees otro pago ni reenvíes TRX por un timeout HTTP. Si ya enviaste TRX, consulta el session_id original.
Todas las respuestas son private, no-store. Guarda la clave de API en tu servidor. Respeta Retry-After cuando se alcance un límite de solicitudes o de direcciones.
Se recupera una sola factura pending por titular. Las direcciones canceladas siguen reservadas hasta su vencimiento original; pueden coexistir hasta tres ventanas reservadas sin vencer. Al alcanzar el límite se devuelve 409 con Retry-After. Las transferencias separadas no se suman; el importe de la respuesta está en TRX, no en SUN.
{
"client_request_id": "9f5a6f60-b8ec-4b45-9e22-2bf5a1d9f101",
"session_id": "a832995c-90d4-4c96-b01d-7eccf2458db0",
"asset": "TRX",
"network": "TRON",
"payment_address": "TDepositWalletFromResponse",
"payment_sender_mode": "any_wallet",
"created_at": "2026-10-18T14:00:00.001Z",
"expires_at": "2026-10-18T14:15:00.001Z",
"server_time": "2026-10-18T14:00:00.100Z",
"status": "pending",
"credited_amount_trx": null,
"txid": null,
"credited_at": null,
"min_amount_trx": "0.000001",
"poll_after_seconds": 10,
"review_required": false
}# Generate and save a UUID once. Reuse it when retrying this request.
curl -sS -X POST "https://tronbid.com/api/v2/quick-rent/balance-topups" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json" \
-d '{"client_request_id":"9f5a6f60-b8ec-4b45-9e22-2bf5a1d9f101"}'Consultar una recarga de saldo
Usa el session_id recibido como :id y una clave Bearer API habilitada de la misma cuenta. Una sesión inexistente o de otro titular devuelve HTTP 404. La cookie del navegador no sustituye la autorización de API.
Consulta como máximo una vez cada poll_after_seconds (10 segundos). La respuesta contiene los valores originales payment_address, created_at y expires_at, el server_time actual, asset: TRX, network: TRON, payment_sender_mode: any_wallet y min_amount_trx.
pending: esperando una transferencia. confirming: verificando la transferencia. credited: el abono está registrado. expired: terminó la ventana de pago. cancelled: la factura se canceló. manual_review: la transferencia requiere revisión; no vuelvas a enviarla.
credited_amount_trx es una cadena decimal con seis cifras tras el punto, o null antes del abono. txid y credited_at también son null antes del abono. review_required indica si hace falta revisión manual. Tras credited, GET /balance muestra el saldo disponible.
GET lee el estado registrado; no escanea la blockchain, no inicia abonos ni amplía el plazo. Otra clave habilitada de la misma cuenta original (correo o cartera) puede consultar la sesión. Vincular correo y cartera no transfiere la propiedad de una factura existente.
/api/v2/quick-rent/balance-topups/:idParámetros
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
id | string (UUID) | session_id obligatorio devuelto por POST /balance-topups: un UUID, no un ID de pedido de alquiler. | a832995c-90d4-4c96-b01d-7eccf2458db0 |
El estado expired o cancelled no demuestra que una transferencia haya fallado. Una transferencia incluida en la cadena dentro de la ventana original puede detectarse y abonarse después, incluso tras la cancelación. Si ya pagaste, sigue consultando esa sesión y no pagues otra vez.
Esta API solo ofrece creación y consulta. Cerrar la pantalla del cliente no cancela la factura. No envíes nuevas transferencias a una dirección antigua ni uses otro UUID para ampliar su ventana.
confirming puede seguir visible tras vencer el temporizador local mientras haya una observación pendiente. Una transferencia incluida fuera de la ventana original requiere revisión. Cada factura abona una sola transferencia; las adicionales requieren revisión, por lo que review_required puede ser true incluso con status credited. Una sesión de navegador del mismo titular puede cancelar esta factura compartida; no hay endpoint API de cancelación.
{
"session_id": "a832995c-90d4-4c96-b01d-7eccf2458db0",
"asset": "TRX",
"network": "TRON",
"payment_address": "TDepositWalletFromResponse",
"payment_sender_mode": "any_wallet",
"created_at": "2026-10-18T14:00:00.001Z",
"expires_at": "2026-10-18T14:15:00.001Z",
"server_time": "2026-10-18T14:01:20.000Z",
"status": "credited",
"credited_amount_trx": "25.000000",
"txid": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"credited_at": "2026-10-18T14:01:19.000Z",
"min_amount_trx": "0.000001",
"poll_after_seconds": 10,
"review_required": false
}# Use session_id returned by POST. Poll no faster than poll_after_seconds.
curl -sS "https://tronbid.com/api/v2/quick-rent/balance-topups/a832995c-90d4-4c96-b01d-7eccf2458db0" \
-H "Authorization: Bearer <API_KEY>"Información de referencia
Códigos de error
Los errores incluyen un estado HTTP y el campo error. Estas son las respuestas que puedes encontrar.
| HTTP | error | Cuándo ocurre |
|---|---|---|
| 400 | Invalid body | JSON o campos no válidos |
| 400 | INVALID_SKU / SKU_INACTIVE | Paquete no disponible |
| 400 | INVALID_PAYER_ADDRESS / INVALID_TARGET_ADDRESS | Dirección TRON no válida |
| 400 | TARGET_ACCOUNT_NOT_ACTIVATED | Se ha confirmado que la dirección del destinatario no está activada en TRON. Actívala y repite el pedido. |
| 400 | INSUFFICIENT_BALANCE | Saldo en TRX insuficiente para pagar con esta modalidad |
| 401 | Unauthorized | Clave de API ausente o no válida |
| 403 | BALANCE_PAYMENT_NOT_ENABLED | Tu clave no tiene habilitado el pago con saldo |
| 409 | PENDING_PAYMENT_INTENT_EXISTS | Se aplica a facturas antiguas con remitente especificado. Paga, cancela o espera su vencimiento. Las facturas nuevas aceptan pagos desde cualquier cartera. |
| 409 | ACTIVE_DELEGATION_EXISTS | Quick Rent no está disponible temporalmente para este destinatario |
| 409 | POOL_ENERGY_INSUFFICIENT | La Energy no está disponible temporalmente. Reintenta más tarde. |
| 409 | IDEMPOTENCY_PAYMENT_MODE_MISMATCH | Se ha utilizado la misma idempotency_key con otro payment_mode |
| 429 | Too Many Requests | Límite de solicitudes superado |
| 503 | — | Servicio no disponible temporalmente; inténtalo más tarde |
| 403 | CUSTOM_LOCK_API_ONLY | Crear un pedido Custom Locked requiere un cliente autenticado de la API de Quick Rent. |
| 409 | IDEMPOTENCY_CUSTOM_LOCK_MISMATCH | Se ha utilizado la misma idempotency_key con un bloqueo personalizado distinto, incluso al añadirlo o eliminarlo. |
| 400 | INVALID_CUSTOM_LOCK | Bloqueo personalizado no válido. Se requiere un entero de 1 a 15, el recurso Energy y duration_minutes: 15. |
| 503 | PAYMENT_WALLETS_BUSY / PAYMENT_WALLET_POOL_DISABLED / PAYMENT_SCANNER_UNAVAILABLE | Todas las direcciones están ocupadas o la detección de pagos no está disponible temporalmente. Espera y repite la solicitud con el mismo idempotency_key; un reintento correcto devuelve el pedido original sin reservar otra dirección. |
| 400 | INVALID_REQUEST | El cuerpo, UUID, campos o parámetros de consulta de la recarga no son válidos. |
| 401 | UNAUTHORIZED | Falta la clave de API de recarga, no es válida, está deshabilitada o ha sido reemplazada. |
| 403 | ACCOUNT_BLOCKED / INVALID_ACCOUNT_SCOPE | La cuenta está bloqueada o no se puede autorizar su ámbito actual de saldo. |
| 404 | TOPUP_SESSION_NOT_FOUND | La recarga no existe o pertenece a otra cuenta. |
| 409 | TOPUP_PENDING_WINDOWS_LIMIT | Hay demasiadas ventanas de direcciones reservadas. Espera retry_after_seconds / Retry-After; no pruebes UUID distintos. |
| 413 | BODY_TOO_LARGE | El cuerpo JSON de la recarga supera el tamaño permitido. |
| 429 | RATE_LIMITED | Se ha alcanzado el límite de solicitudes de recarga. Retry-After es de 60 segundos. |
| 503 | PAYMENT_WALLETS_BUSY / PAYMENT_WALLET_POOL_DISABLED / TOPUP_UNAVAILABLE | La dirección o el servicio de recarga no está disponible temporalmente. Reintenta con el mismo client_request_id; no vuelvas a transferir por esta respuesta. |
| 408 | REQUEST_TIMEOUT | El cuerpo debe recibirse completo en 5 segundos; de lo contrario se devuelve HTTP 408 REQUEST_TIMEOUT. Reintenta con el mismo client_request_id, sin enviar otra transferencia. |
| 503 | BANDWIDTH_SUPPLIER_UNAVAILABLE | El paquete de Bandwidth seleccionado no está disponible temporalmente. Reintenta más tarde o elige otro paquete disponible. |
Solución de problemas
Situaciones habituales y cómo resolverlas.
He pagado, pero el pedido sigue en pending_payment
Envía una sola transferencia de TRX desde CUALQUIER cartera a pay_address antes de expires_at. El recurso llegará a target_address, no automáticamente al remitente. Cada pedido recibe una dirección disponible durante 15 minutos. Si no hay ninguna, HTTP 503 PAYMENT_WALLETS_BUSY indica que debes repetir la misma solicitud más tarde. Un pago menor o mayor ajusta effective_energy_amount; no se suman pagos separados. No envíes después de expires_at ni reutilices una dirección de pago. Las direcciones se reasignan: una transferencia posterior corresponde al pedido que use esa dirección en ese momento.
El pedido ha pasado a failed. ¿Qué significa?
La delegación no se completó. Si pagaste con saldo, los TRX se devuelven automáticamente. Consulta error_code y error_message en GET /orders/:id para conocer el motivo. Puedes crear otro pedido.
Error 409 PENDING_PAYMENT_INTENT_EXISTS
Se aplica a facturas antiguas con remitente especificado. Paga, cancela o espera su vencimiento. Las facturas nuevas aceptan pagos desde cualquier cartera.
Error 403 BALANCE_PAYMENT_NOT_ENABLED
Esta integración tiene desactivado el pago con saldo. Las nuevas claves de autoservicio lo habilitan automáticamente, pero un administrador puede modificar los permisos; una clave antigua concedida manualmente también puede tenerlo desactivado. Contacta con soporte o paga en la red.
Error 429 Too Many Requests
Has enviado demasiadas solicitudes en poco tiempo. Reduce la frecuencia de consulta, por ejemplo a una vez cada 3 segundos, e inténtalo más tarde.
He recibido menos energía de la que pedí
Si el pago en la blockchain es mayor o menor que el importe indicado, se ajusta la cantidad final. Consulta effective_energy_amount en GET /orders/:id para ver la energía realmente delegada.
503 PAYMENT_WALLETS_BUSY / PAYMENT_WALLET_POOL_DISABLED / PAYMENT_SCANNER_UNAVAILABLE
Todas las direcciones están ocupadas o la detección de pagos no está disponible temporalmente. Espera y repite la solicitud con el mismo idempotency_key; un reintento correcto devuelve el pedido original sin reservar otra dirección.
Soporte
¿Necesitas ayuda con la integración, permisos existentes o un límite de solicitudes mayor? Contacta con soporte. Puedes obtener acceso inicial mediante GET API KEY con un saldo de al menos 50 TRX.
Integra TronBid en tu servicio
Calcula costes, prueba Quick Rent y automatiza el suministro de energía TRON con estas herramientas.
