Skip to content

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")

CampoQué es¿Obligatorio?Efecto en el sistema/backend
ID del agenteIdentificador del agente a vincularEnviado como agentId a createAgentsLinkedStaking; valida la existencia del agente
PorcentajePorcentaje de comisión sobre el valor aportadoEnviado 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 found y stake not found.
  • Eliminar (en la lista): abre una confirmación (bottom-sheet); al confirmar, llama a deleteAgentsLinkedStaking por el id del 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.

Pantallas relacionadas