Estado de una transacción
Consulta ligera del estado de una transacción propia y de su retiro o compra asociados, pensada para refrescar una pantalla mientras la operación está pendiente.
GET /api/transaction/{uuid}/status
Devuelve solo los estados de una transacción de la que eres emisor o destinatario, sin el resto del detalle. Es lo que usa la página de detalle de QvaPay para actualizarse sola mientras algo está pendiente; úsalo igual en tu app o integración en vez de pedir el detalle completo en bucle.
Autenticación
Bearer token de usuario (o la sesión del navegador) o credenciales de App, igual que el detalle.
Rate limit
30 consultas por minuto por usuario.
Response
{
"uuid": "6e772f03-ffc4-4656-aa04-012111ff77fd",
"updated_at": "2026-10-29T16:28:51.000Z",
"status": "pending",
"withdraw_status": "processing",
"service_status": null,
"live": true,
"fingerprint": "pending|processing|-"
}| Campo | Tipo | Descripción |
|---|---|---|
status | string | Estado de la transacción: pending, processing, paid, received o cancelled |
withdraw_status | string | null | Estado del retiro asociado, si la transacción es un retiro: pending, processing, paid o cancelled |
service_status | string | null | Estado de la compra asociada (tienda), si la hay |
live | boolean | true mientras alguno de los tres estados pueda cambiar todavía (pending o processing). Con false no hace falta seguir consultando |
fingerprint | string | Cambia en cuanto cambia cualquiera de los estados: compárala con la anterior para saber si hay que recargar |
Cómo consultarlo
Consulta solo mientras live sea true, con un intervalo de unos segundos (la web usa 5 s los dos primeros minutos y 15 s después, y deja de consultar a los 30 minutos o con la pestaña oculta). Cuando fingerprint cambie, recarga el detalle.
Errores
| Código | Descripción |
|---|---|
401 | Sin autenticación |
404 | La transacción no existe o no eres emisor ni destinatario |
429 | Más de 30 consultas por minuto |