ovahub
Ir a la documentación
DocumentaciónReferencia de la APIComprar una cotización con USD del equipo
POSTToken Bearer

Comprar una cotización con USD del equipo

/api/v1/orders/buy

Compra tu propia cotización vigente con el saldo USD del equipo fijo del token. El éxito devuelve HTTP 202 y la intención de pago en estado applied/balance, no un servidor entregado. Repetir la misma cotización devuelve el resultado original.

Antes de llamar

La compra por API está desactivada por defecto. Solicita la activación del token a un administrador mediante un ticket vinculado a un servidor existente del equipo que no haya sido recuperado. USD insuficiente devuelve 409; no hay alternativa x402, depósito, xTOVA ni comisiones. Conserva el id de la cotización y consulta get_payment y get_order si el resultado es incierto. Este ajuste no limita las compras MCP. Otros tokens y los nuevos no heredan acceso.

Los nombres de campos, los tipos y el código de la API se mantienen iguales en todos los idiomas.

Ejemplo de petición

cURL
curl "https://tovahub.com/api/v1/orders/buy" -X POST \
  -H "Authorization: Bearer $TOVAHUB_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
  "id": "507f1f77bcf86cd799439011"
}'

Solo ejemplos. Esta página no envía peticiones.

Respuesta ilustrativa
JSON
{
  "id": "507f1f77bcf86cd799439011",
  "purpose": "order",
  "amount": "1200",
  "asset": "USD",
  "state": "applied",
  "mode": "balance",
  "expiresAt": "2026-11-07T12:30:00.000Z",
  "transactionHash": null,
  "network": null,
  "result": {
    "_id": "507f1f77bcf86cd799439012",
    "status": "pending"
  },
  "error": null
}

Parámetros

idCuerpo JSON · Obligatorio

string

ID de cotización o intención de pago de quote_vps_order: exactamente 24 caracteres hexadecimales. Solo su creador puede comprarla en el mismo equipo fijo. No envíes otros campos.

Respuesta

Estado HTTP 202

Al reintentar se devuelve el mismo resultado del pedido aceptado. La aceptación no indica que el servidor se haya entregado.

idstring (ObjectId)

Identificador de la intención de pago; también identifica la cotización.

purpose"order"

Propósito de la intención. Las rutas públicas de creación actuales usan order o deposit. El valor guardado también puede ser renew, lo que no implica que la renovación esté disponible.

amountstring

Centavos de USD enteros.

assetstring ('USD')

Activo contable de la plataforma.

state"applied"

Estado persistente de la intención de pago.

mode"balance"

Origen de fondos elegido, o null si aún no se ha elegido.

expiresAtstring (ISO 8601)

Vencimiento de la cotización; los fondos ya aceptados requieren conciliación incluso después de esa fecha.

transactionHashnull

Hash de la transacción en la cadena de bloques, si existe.

networknull

Red de pago, si existe.

resultunknown | null

Resultado de procesamiento persistido según el propósito; no se define un esquema de respuesta anidado universal.

errornull

Error de pago persistido, si existe.

Relacionado

Peticiones y erroresAutenticación