Qué problema resuelve
Pagos concentra cuatro tareas distintas: consultar transacciones, generar un nuevo cobro, administrar medios de cobro y detectar operaciones que requieren recuperación.
No es solamente una pantalla de configuración. El estado que ves acá debe corresponder al circuito real de cobro y a su resultado.
Modos de la pantalla
La URL trabaja con cuatro pestañas:
- Hub: resumen del centro.
- Transacciones: listado y filtrado de solicitudes/pagos.
- Nuevo cobro: genera un link de cobro y QR.
- Medios de cobro: muestra proveedores disponibles y su estado.
Además existe un filtro de estado:
- Todos los pagos
- Procesados
- Pendientes
- Rechazados
- A recuperar
A recuperar agrupa operaciones pendientes o rechazadas.
Transacciones
Cada solicitud contiene, entre otros datos, importe, moneda, descripción, estado, origen, fecha y datos de autorización disponibles para el proveedor.
Estados visibles en el modelo operativo incluyen:
paid— procesado;pending— pendiente;rejected— rechazado;expired— expirado;cancelled— cancelado.
No trates pending como paid. Un pago pendiente no debe disparar las mismas decisiones operativas que un cobro confirmado.
Nuevo cobro
El formulario usa:
| Campo | Regla |
|---|---|
| Monto | Numérico y mayor que 0 |
| Descripción | Opcional; si está vacía se usa Cobro |
| Medio de cobro | Debe ser un proveedor elegible y configurado |
El proveedor seleccionado se determina entre los medios visibles, configurables, habilitados para el plan y realmente configurados.
Si no hay un proveedor elegible, el sistema no genera el link y muestra que primero hay que activar/configurar un medio en Configuración → Pagos.
Generar el link
Al confirmar:
- Structura valida que el monto sea mayor que cero.
- Valida que exista un proveedor seleccionable.
- Envía la solicitud manual al backend.
- El backend devuelve URL y QR.
- La interfaz muestra el resultado.
- Se limpian monto y descripción.
- Se recarga la información de pagos.
El link puede copiarse al portapapeles.
Medios de cobro y estados
Cada proveedor puede estar condicionado por:
- disponibilidad global;
- lifecycle del proveedor;
- entitlement del plan;
- posibilidad de configuración;
- configuración del tenant;
- activación.
La interfaz diferencia conceptualmente Activo, Falta configurar, Inactivo, Plan y Próximamente. Un proveedor visible no necesariamente es cobrable.
Los proveedores deprecados no deben utilizarse.
Flujo correcto con un pago
Cliente/cajero inicia cobro → proveedor procesa → resultado queda disponible → Structura actualiza el pago → el pedido puede reflejar el estado correcto.
Si el proveedor muestra aprobado pero Structura sigue pendiente, no generes inmediatamente otro cobro. Primero investigá la confirmación/notificación y la operación existente.
Dashboard de pagos
El centro puede mostrar métricas de procesados, totales, alertas de recuperación y datos de webhooks cuando están disponibles. Estos indicadores sirven para detectar que el problema no está en una sola operación sino en el flujo de integración.
Diagnóstico
Monto inválido: debe ser mayor que cero.
No aparece ningún medio para cobrar: revisá configuración, plan, entitlement y estado del proveedor.
Proveedor aparece pero no se puede usar: puede estar sin configurar, no ser configurable o no estar habilitado para el plan.
Link generado pero cliente no paga: revisá el estado de la solicitud y el proveedor; no asumas que generar el link equivale a cobrar.
Pago aprobado externamente pero pendiente en Structura: revisá primero la confirmación/webhook y la operación existente.
Pago rechazado: diferenciá rechazo del proveedor de un problema de visualización local.
Qué no hacer
- No marques manualmente como pagado para “probar” una integración.
- No generes un segundo cobro sin investigar el primero.
- No uses un proveedor que figura como Próximamente, Deprecado o bloqueado por plan.
- No confundas generación de link con confirmación del pago.