API B2B DE TRONBID · VERSIÓN 2

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 KEY
En 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.

  1. 1
    Consulta el precio

    Tu programa pregunta a la API cuánto cuesta en ese momento el paquete de energía que necesita.

  2. 2
    Crea 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.

  3. 3
    Recibe 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.

  1. 1
    Obté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.

  2. 2
    Elige 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.

  3. 3
    Elige 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.

  4. 4
    Prepara 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.

URL base (producción)
http
https://tronbid.com/api/v2/quick-rent

Autenticación

Incluye tu clave de API en cada solicitud como token Bearer en la cabecera Authorization.

Guarda la clave únicamente en el servidor, por ejemplo en el backend o en los secretos de CI. No la incluyas en el código del navegador ni en repositorios públicos. La clave pertenece a una cuenta de TronBid: una cuenta de correo sin necesidad de vincular cartera, o una cuenta de cartera. Los pagos utilizan el saldo disponible de esa cuenta, incluidos los saldos elegibles del correo y la cartera vinculados actualmente que devuelve GET /balance.

Si superas el límite de solicitudes, la API responde con HTTP 429.

Obtén acceso inicial en Dashboard → Quick Rent API con al menos 50 TRX de saldo disponible, o utiliza acceso concedido por un administrador. Las cuentas de correo pueden obtener una clave sin vincular cartera. La clave completa se muestra una sola vez: guárdala en tu servidor y pulsa «La he guardado — activar». No funciona antes de activarse. Si cierras la ventana, descarta la clave pendiente y genera otra. Un saldo posterior inferior no desactiva la clave; reemplazarla no exige volver a tener 50 TRX.

Al activar una sustitución, la clave anterior funciona durante una hora exacta. Actualiza tu integración en ese plazo; también puedes revocar la anterior antes. El servidor aplica la caducidad aunque cierres el Dashboard.

No se puede recuperar una clave completa: sustituye una clave perdida. El administrador sigue controlando los permisos y los límites de solicitudes.

http
Authorization: Bearer <API_KEY>

Modalidades 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.

ModalidadCómo activarlaPago
on-chainModalidad 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.
balancepayment_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:

Consultar el catálogo activo (sin autenticación)
bash
curl -sS https://tronbid.com/api/public/quick-rent/skus

Paquetes 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.

Consultar el catálogo activo (sin autenticación)
bash
curl -sS "https://tronbid.com/api/public/quick-rent/skus?resource_type=bandwidth"
cURL
bash
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 (pago con saldo)
bash
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.

  1. 1
    Paso 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.

  2. 2
    Paso 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.

  3. 3
    Paso 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.

  4. 4
    Paso 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.

Respuesta
json
{
  "price_trx": "3.200000",
  "available": true,
  "save_percent": 62,
  "expires_in_sec": 30
}
Respuesta (pago en la blockchain)
json
{
  "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..."
}
cURL
bash
# 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
Respuesta
json
{
  "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.

Cuerpo de la solicitud
json
{
  "energy_amount": 131000,
  "duration_minutes": 15,
  "idempotency_key": "your-unique-key-001",
  "target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}
Respuesta
json
{
  "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.

Cuerpo de la solicitud
json
{
  "energy_amount": 131000,
  "duration_minutes": 15,
  "idempotency_key": "your-unique-key-balance-001",
  "payment_mode": "balance",
  "target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}
Respuesta
json
{
  "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
bash
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 (pago con saldo)
bash
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 (pago en la blockchain)
bash
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"
}'
Respuesta
json
{
  "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.

EstadoSignificado
pending_paymentEsperando el pago en la blockchain
delegatingPago recibido o saldo descontado; delegación en curso
delegatedEnergía delegada
cancelledCancelado antes del pago en la blockchain
expiredPlazo de pago en la blockchain agotado
failedError; si se pagó con saldo, se devuelven los TRX
undelegatingBloqueo personalizado finalizado; retirada de recursos pendiente de confirmación
completedRetirada 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.

POST/api/v2/quick-rent/availability

Parámetros

ParámetroTipoDescripciónEjemplo
target_addressstringObligatorio. 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
bash
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"
}'
Respuesta
json
{
  "resource_type": "energy",
  "target_address": "TWLaGaf3k6dbiEWvif1tNLeKuTErk2Tron",
  "available": true,
  "reason": "AVAILABLE",
  "checked_at": "2026-09-30T12:00:00.000Z"
}
Respuesta
json
{
  "resource_type": "energy",
  "target_address": "TWLaGaf3k6dbiEWvif1tNLeKuTErk2Tron",
  "available": false,
  "reason": "ALL_POOLS_BUSY",
  "checked_at": "2026-09-30T12:00:00.000Z"
}
Respuesta
json
{
  "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.

POST/api/v2/quick-rent/calculator

Parámetros

ParámetroTipoDescripciónEjemplo
wallet_addressstringDirección TRON que se va a analizarTXXXXXXXX...XXXX
has_usdtboolean | nullIndica si el destinatario ya tiene USDT, lo que afecta a la energía necesaria. Envía true, false u omite el campo.true
Cuerpo de la solicitud
json
{
  "wallet_address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "has_usdt": true
}
cURL
bash
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).

POST/api/v2/quick-rent/quote

Parámetros

ParámetroTipoDescripciónEjemplo
energy_amountintCantidad del recurso del catálogo activo: Energy por defecto, o Bandwidth cuando resource_type es bandwidth131000
resource_typestringenergy (por defecto) o bandwidth. Bandwidth no admite custom_lock_minutes.bandwidth
duration_minutesintEnergy: 15 o 60. Bandwidth: 60, 1440 (1 día) o 4320 (3 días). Debe coincidir con un paquete activo.15
custom_lock_minutesintegerEntero 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
Respuesta
json
{
  "price_trx": "3.200000",
  "available": true,
  "save_percent": 62,
  "expires_in_sec": 30
}
cURL
bash
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.

POST/api/v2/quick-rent/orders

Parámetros

ParámetroTipoDescripciónEjemplo
energy_amountintCantidad del recurso del catálogo activo: Energy por defecto, o Bandwidth cuando resource_type es bandwidth131000
resource_typestringenergy (por defecto) o bandwidth. Bandwidth no admite custom_lock_minutes.bandwidth
duration_minutesintEnergy: 15 o 60. Bandwidth: 60, 1440 (1 día) o 4320 (3 días). Debe coincidir con un paquete activo.15
idempotency_keystringIdentificador único del pedido en tu sistema, de 8 a 128 caracterespartner-onchain-001
payment_modestringOpcional: "onchain" (por defecto) o "balance".balance
payer_addressstringAlias antiguo del destinatario cuando falta target_address. No restringe quién puede pagar un pedido nuevo.TPayer...
target_addressstringDestinatario del recurso. Obligatorio para balance; para on-chain usa este campo o el antiguo alias payer_address.TTarget...
custom_lock_minutesintegerEntero 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
Respuesta (pago en la blockchain)
json
{
  "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..."
}
Respuesta (pago con saldo)
json
{
  "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 (pago en la blockchain)
bash
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 (pago con saldo)
bash
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.

GET/api/v2/quick-rent/orders/:id

Parámetros

ParámetroTipoDescripciónEjemplo
idstringID del pedido, como parámetro de rutauuid
Respuesta
json
{
  "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
}
Ejemplo: un pedido, varias transacciones de delegación
json
{
  "id": "uuid",
  "status": "delegated",
  "delivery_complete": true,
  "txid_delegate": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "txids_delegate": [
    "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
  ]
}
cURL
bash
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.

POST/api/v2/quick-rent/orders/:id/cancel

Parámetros

ParámetroTipoDescripciónEjemplo
idstringID del pedido, como parámetro de rutauuid
cURL
bash
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.

GET/api/v2/quick-rent/balance
Respuesta
json
{ "balance_trx": "150.500000" }
cURL
bash
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.

POST/api/v2/quick-rent/balance-topups

Parámetros

ParámetroTipoDescripciónEjemplo
client_request_idstring (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.

Respuesta
json
{
  "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
}
cURL
bash
# 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.

GET/api/v2/quick-rent/balance-topups/:id

Parámetros

ParámetroTipoDescripciónEjemplo
idstring (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.

Respuesta
json
{
  "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
}
cURL
bash
# 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.

HTTPerrorCuándo ocurre
400Invalid bodyJSON o campos no válidos
400INVALID_SKU / SKU_INACTIVEPaquete no disponible
400INVALID_PAYER_ADDRESS / INVALID_TARGET_ADDRESSDirección TRON no válida
400TARGET_ACCOUNT_NOT_ACTIVATEDSe ha confirmado que la dirección del destinatario no está activada en TRON. Actívala y repite el pedido.
400INSUFFICIENT_BALANCESaldo en TRX insuficiente para pagar con esta modalidad
401UnauthorizedClave de API ausente o no válida
403BALANCE_PAYMENT_NOT_ENABLEDTu clave no tiene habilitado el pago con saldo
409PENDING_PAYMENT_INTENT_EXISTSSe aplica a facturas antiguas con remitente especificado. Paga, cancela o espera su vencimiento. Las facturas nuevas aceptan pagos desde cualquier cartera.
409ACTIVE_DELEGATION_EXISTSQuick Rent no está disponible temporalmente para este destinatario
409POOL_ENERGY_INSUFFICIENTLa Energy no está disponible temporalmente. Reintenta más tarde.
409IDEMPOTENCY_PAYMENT_MODE_MISMATCHSe ha utilizado la misma idempotency_key con otro payment_mode
429Too Many RequestsLímite de solicitudes superado
503—Servicio no disponible temporalmente; inténtalo más tarde
403CUSTOM_LOCK_API_ONLYCrear un pedido Custom Locked requiere un cliente autenticado de la API de Quick Rent.
409IDEMPOTENCY_CUSTOM_LOCK_MISMATCHSe ha utilizado la misma idempotency_key con un bloqueo personalizado distinto, incluso al añadirlo o eliminarlo.
400INVALID_CUSTOM_LOCKBloqueo personalizado no válido. Se requiere un entero de 1 a 15, el recurso Energy y duration_minutes: 15.
503PAYMENT_WALLETS_BUSY / PAYMENT_WALLET_POOL_DISABLED / PAYMENT_SCANNER_UNAVAILABLETodas 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.
400INVALID_REQUESTEl cuerpo, UUID, campos o parámetros de consulta de la recarga no son válidos.
401UNAUTHORIZEDFalta la clave de API de recarga, no es válida, está deshabilitada o ha sido reemplazada.
403ACCOUNT_BLOCKED / INVALID_ACCOUNT_SCOPELa cuenta está bloqueada o no se puede autorizar su ámbito actual de saldo.
404TOPUP_SESSION_NOT_FOUNDLa recarga no existe o pertenece a otra cuenta.
409TOPUP_PENDING_WINDOWS_LIMITHay demasiadas ventanas de direcciones reservadas. Espera retry_after_seconds / Retry-After; no pruebes UUID distintos.
413BODY_TOO_LARGEEl cuerpo JSON de la recarga supera el tamaño permitido.
429RATE_LIMITEDSe ha alcanzado el límite de solicitudes de recarga. Retry-After es de 60 segundos.
503PAYMENT_WALLETS_BUSY / PAYMENT_WALLET_POOL_DISABLED / TOPUP_UNAVAILABLELa 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.
408REQUEST_TIMEOUTEl 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.
503BANDWIDTH_SUPPLIER_UNAVAILABLEEl 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.

Ayuda con la integraciónTelegram @tronbid
Correo electrónicosupport@tronbid.com

Calcula costes, prueba Quick Rent y automatiza el suministro de energía TRON con estas herramientas.