Pagos manuales (Dashboard)
Requisitos previos de acceso
- Permiso (módulo):
viewPayments - Licencia/Feature: Ninguna.
- Contenedor del menú: GENERAL → grupo Dashboard
Qué es / cuándo usar
Panel analítico (solo lectura) del flujo de pagos/depósitos manuales — aquellos en los que el cliente paga mediante PIX o TED para comprar Tokens o NFTs. Úselo para monitorear el volumen y el ticket de depósitos manuales, y la distribución entre medios de pago y tipos de activo adquirido.
Requisitos previos
- Permiso:
viewPaymentsregistrado para el rol del operador (permiso doble — enum CPM en el backend + módulo dinámico en la BD). - Licencia/Feature: Ninguna.
- Dependencias de otras pantallas: Los datos provienen de los pagos procesados; el panel refleja lo que ya existe en el historial de depósitos.
Paso a paso
- Acceda al menú Dashboard → Pagos manuales.
- Espere la carga (el panel obtiene el resumen mediante
DepositsService.getDepositsDashboard). - Lea las tarjetas de resumen y los gráficos a continuación.
Filtros y columnas
Esta es una pantalla de solo visualización — no hay filtros ni campos editables. Los indicadores son:
| Indicador / Gráfico | Qué muestra | Origen del dato |
|---|---|---|
| Cantidad de pagos | Total de depósitos manuales en el período | summary del endpoint del dashboard de depósitos (FMS-PaymentController) |
| Cantidad de compras de Tokens / NFTs | Cuántos depósitos resultaron en compra de Token vs NFT | totalTokenBuy / totalNFTBuy |
| Total en Tokens / NFTs | Valor agregado por tipo de activo | summary |
| Total de pagos | Monto total depositado | summary |
| Tipo de pago (gráfico de torta) | Proporción PIX × TED | totalPix / totalTED |
| Tokens vs NFT (gráfico de torta) | Proporción de compras Token × NFT | totalTokenBuy / totalNFTBuy |
| Historial de pagos (barras) | Total por mes, ordenado cronológicamente | paymentHistory, agrupado por mes de creación |
Reglas de negocio / consideraciones
Atención
- Cuando existe un único mes de historial, el panel inyecta un punto de valor cero en el mes anterior únicamente para que el gráfico tenga una línea de base — es un artificio de visualización, no un pago real.
- Error ≠ cero: si la consulta falla, el panel muestra una página de error. Esto indica indisponibilidad del servicio, no ausencia de pagos.
- Valores financieros: los totales se derivan de valores monetarios (
BigNumberen el backend); el panel los convierte para el gráfico. Úselo como visión analítica, no como cierre contable.