Agregar o eliminar comisión de agente
Requisitos previos de acceso
- Permiso (módulo):
manageToken - Licencia/Feature:
STAKING_TOKENS - Contenedor del menú: GENERAL → grupo Inversiones / Distribuciones Financieras → pantalla Aplicaciones de Staking
Qué es / cuándo usar
Modal abierto mediante el ícono Comisión de agente (manage_accounts) de una aplicación de staking. Permite vincular un agente (socio/referente) a una aplicación, definiendo el porcentaje que recibe sobre el valor aportado por el cliente. El agente pasa a ser pagado automáticamente conforme al contrato vigente. El modal tiene dos secciones: lista (agentes ya vinculados) y agregar.
Requisitos previos
- El agente ya debe existir en el sistema (registro de agente). De lo contrario, el backend responde con
agent not found. - Permiso:
manageToken(doble — enum CPM en el backend + módulo en la BD).
Campos (pestaña "Agregar")
| Campo | Qué es | ¿Obligatorio? | Efecto en el sistema/backend |
|---|---|---|---|
| ID del agente | Identificador del agente a vincular | Sí | Enviado como agentId a createAgentsLinkedStaking; valida la existencia del agente |
| Porcentaje | Porcentaje de comisión sobre el valor aportado | Sí | Enviado como percentage; define cuánto recibe el agente; pago automático conforme al contrato |
El botón Aplicar permanece deshabilitado mientras ambos (porcentaje e ID de agente) no estén completados.
Acciones y modales
- Aplicar (agregar): llama a
createAgentsLinkedStaking(stakeId+agentId+percentage). Maneja errores diferenciados:agent not foundystake not found. - Eliminar (en la lista): abre una confirmación (bottom-sheet); al confirmar, llama a
deleteAgentsLinkedStakingpor eliddel vínculo.
Reglas de negocio / consideraciones
Atención
- La comisión se aplica sobre el valor aportado por el usuario y el agente es pagado automáticamente según el contrato vigente — no existe registro manual.
- Los errores son diferenciados: agente inexistente, aplicación (stake) inexistente y comisión inexistente (al eliminar).
- Valores financieros: el porcentaje de comisión sigue el tratamiento BigNumber de los valores financieros.