Órdenes
Obtener orden
Consulta el estado de una orden de energía o ancho de banda por ID
GET
Obtener orden
Obtener orden
Devuelve el estado actual y los detalles completos de una orden de energía o ancho de banda.Parámetros de ruta
number
requerido
ID de la orden — el
id devuelto por Buy Energy o Buy Bandwidth.Respuesta
Devuelve el objeto completo de la orden, incluyendostatus, type, volume, price_trx, delegate_txid y marcas de tiempo.
string
Comisión fija de este pedido, cobrada una vez por pedido sin importar el volumen. Ya está incluida en
price_trx. Refleja su propia comisión si a su cuenta se le aplica una comisión personalizada, un descuento o una exención.number | null
ID de la activacion de direccion que pago este pedido, o
null si no pago ninguna.string | null
Cuanto costo esa activacion, en TRX, por encima de
price_trx: es la diferencia entre el precio del pedido y el importe que salio de tu saldo.null, no "0". Ambos campos son null cuando el pedido no pago ninguna activacion: la cuenta destinataria ya existia o la creo la transaccion de otra persona. Ojo con la diferencia respecto a activation_cost_trx en la respuesta de Buy Energy, que en ese caso es la cadena "0": comparar con "0" aqui no coincidiria nunca.Estados de la orden
Una orden en curso normalmente pasa a final en segundos, como máximo en minutos. Consulte este endpoint
cada 5–10 segundos, o suscríbase al webhook
order.updated para
recibir el estado final. Si una orden sigue en curso durante más de 15 minutos, contacte con soporte
indicando su ID.
Un estado final no cambia, con una excepción: una orden filled puede pasar después a reclaimed o
reclaim_failed cuando termina su alquiler. Una orden failed o partial nunca se entrega más ni se
cobra de nuevo. Si la respuesta de su compra traía provider_outcome: "unknown", la energía reembolsada
aún puede llegar a la dirección en pocos minutos, y no se le cobra por ella — consulte
Comprar energía.
Ejemplo
Response