Saltar al contenido principal
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, incluyendo status, 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