Pago de comisiones (multinivel)
Requisitos previos de acceso
- Permiso (módulo):
viewCommissionsOmanageCommissions - Licencia/Feature: Ninguna
- Contenedor del menú: GENERAL → grupo Comisiones y Recompensas
Qué es / cuándo usar
Pantalla de auditoría de las comisiones multinivel ya generadas. Cada fila es una comisión creada por el motor multinivel (entidad multilevel_commissions) y agrega sus pagos individuales por nivel (multilevel_commissions_payments).
Úsela cuando necesite verificar cuánto se generó de comisión, para qué usuario, en qué moneda/asset, y cuántos pagos componen esa comisión. Es una pantalla de solo lectura — no crea ni reprocesa pagos.
Requisitos previos
- Permiso:
viewCommissionsomanageCommissionsregistrado 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: las comisiones solo existen si hay niveles configurados en Configuración de comisiones y acciones de usuarios finales que activen el motor.
Paso a paso
- Acceda al menú Comisiones y Recompensas → Pago de comisiones (
/manage-multilevel-commissions). - La pantalla carga las comisiones y las enriquece con el correo electrónico del usuario (cruzando
userIdcon la lista de usuarios) y el nombre del asset (cruzandounit_of_moneycon la lista de assets). - Use la búsqueda para filtrar por correo electrónico,
userId, motivo (reason) oid. - Haga clic en el ícono de ver pagos en una fila para abrir el modal con el desglose por pago.
- Use Exportar CSV para descargar el listado completo (fecha, correo electrónico, monto, moneda, nº de pagos).
Filtros y columnas
| Filtro / Columna | Qué muestra | Origen del dato |
|---|---|---|
| Búsqueda | Filtra por correo electrónico, userId, reason o id de la comisión | Filtro client-side sobre la lista cargada |
Fecha (when) | Cuándo se generó la comisión | multilevel_commissions.when (CPM) |
| Usuario / Correo electrónico | Usuario beneficiario de la comisión | userId enriquecido con email vía lista de usuarios |
Monto (amount) | Monto total de la comisión | multilevel_commissions.amount, mostrado vía BigNumber con 2 decimales |
Moneda (unit_of_money) | Asset/moneda de la comisión | Cuando el id tiene más de 20 caracteres se resuelve al nombre del asset; en caso contrario muestra el propio código |
| Nº de pagos | Cantidad de pagos que componen la comisión | payments.length |
Acciones y modales
- Ver pagos: abre el modal
Payments, listando cadamultilevel_commissions_paymentsde la comisión con usuario (correo electrónico), monto y estado de procesamiento. Solo lectura. - Exportar CSV: genera un archivo
multilevel-commissions_<fecha>.csvcon las columnas del listado, en el cliente.
Reglas de negocio / consideraciones
Atención
- El campo moneda puede aparecer como un UUID cuando el asset no esté en la lista cargada — en ese caso el id se muestra sin procesar. Confirme el asset en Tenedores de tokens si hay dudas.
- La flag
wasProcessedpor pago indica si el crédito ya fue efectuado. Los pagos pendientes aún no han sido liquidados.
- Valores financieros: todos los valores son BigNumber — la interfaz formata con 2 decimales solo para visualización; no use el valor mostrado para conciliación contable sin verificar la precisión original.