Gestión de Pagos
Administración y seguimiento de todos los pagos del sistema. Los pagos son de solo lectura y no se pueden crear, editar o eliminar desde el panel.
Ver Pagos
La vista de pagos está organizada en dos pestañas:
Pagos Pendientes
Muestra los pagos con status = false que ya están vinculados a una reserva (reservation_id) o a una inscripción de evento (enrollment_id). Desde esta pestaña el operador puede validar el pago (marcarlo como completado).
La captura del comprobante y la vinculación con la reserva ocurren durante el flujo de reserva; no hay pestaña de conciliación manual de pagos sin afiliar.
Comprobante en el paso de pago de reserva
En Reservas → Pago (/booking/payment/:id), cada fila de pago muestra acciones según el estado del comprobante:
-
Subir (botón verde): adjunta captura vía
PATCHmultipart cuando aún no hay comprobante. -
Ver (icono ojo): abre modal Comprobante de pago (
GET …/foto; no expone URL del bucket). -
Eliminar comprobante (rojo en el modal):
DELETE …/foto(borra objeto en S3/R2 y limpiapayment.foto). -
Eliminar pago (papelera en la fila):
DELETE …/payment/{paymentId}(borra el pago; si tenía comprobante, también lo elimina del bucket).
También puede adjuntarse al crear el pago (POST multipart) desde integraciones o scripts.
-
La vista global de pagos (
/payments) no incluye este visor. -
En reservas confirmadas puede Ver comprobantes, pero no añadir, editar ni eliminar pagos ni comprobantes.
Guía operador: Pago y comprobante. Referencia técnica: API comprobantes.
Información Mostrada
La lista de pagos muestra:
-
ID del pago
-
Transaction ID: ID de transacción del gateway de pago
-
Reservación/Inscripción: enlace a la reserva o identificador del evento
-
Tipo de pago
-
Monto: Cantidad del pago en formato COP
-
Estado: Estado actual del pago
-
Fecha: Fecha y hora del pago
Filtros y Búsqueda
Utiliza los filtros para encontrar pagos específicos:
-
Por transaction_id o descripción (búsqueda de texto)
-
Por tipo de pago
Estados de Pago
Los pagos utilizan un booleano status:
-
false: Pendiente de validación -
true: Completado
Estadísticas
El dashboard muestra estadísticas generales de pagos:
-
Total de pagos
-
Monto total de todos los pagos
-
Monto de pagos completados
-
Desglose por estado (completados, pendientes, fallidos)
Paginación
La lista de pagos incluye paginación estándar del panel (selector de registros por página y navegación Primera/Anterior/Siguiente/Última).