ovahub
Ir a la documentación
DocumentaciónReferencia de la APIConsultar un pago
GETToken Bearer

Consultar un pago

/api/v1/payments/:id

Consulta una solicitud de pago y el resultado de su pedido o recarga.

Antes de llamar

Si el resultado en la cadena o del proveedor está pendiente, sigue consultando la misma solicitud. No vuelvas a pagar ni cambies requestKey.

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/payments/507f1f77bcf86cd799439012" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

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

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

Parámetros

idRuta · Obligatorio

string

ID del recurso: 24 caracteres hexadecimales. Use el ID de la plataforma devuelto por el endpoint de listado correspondiente, no el ID de instancia del proveedor.

Respuesta

Estado HTTP 200

Consulta el estado persistente actual de una intención de pago existente de la organización.

idstring (ObjectId)

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

purposestring

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.

statestring ('quoted' | 'authorized' | 'broadcast' | 'settled' | 'applied' | 'failed')

Estado persistente de la intención de pago.

modestring ('balance' | 'x402') | null

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.

transactionHashstring | null

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

networkstring | null

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.

errorstring | null

Error de pago persistido, si existe.

Relacionado

Peticiones y erroresAutenticaciónMCP · get_payment