Agencias y afiliados
Superficie tenant del programa de partners: captación, clientes, comisiones y cobros.
Para que sirve
- Una agencia incorpora organizaciones cliente y sigue las comisiones derivadas de sus suscripciones y consumo elegible.
- Un afiliado comparte enlaces de referido y revisa las visitas y clientes atribuidos.
- Un partner solicita el pago de comisiones elegibles hacia una cuenta bancaria o de mobile money configurada para Wise.
Que lo hace diferente
- Agencia y afiliado comparten un programa de atribución, clientes y libro de comisiones dentro de la misma plataforma donde se facturan los clientes.
- Las comisiones se registran por eventos de cobro y se distinguen entre pendientes, elegibles, pagadas o canceladas.
- Los payouts se solicitan hacia destinos Wise o bancarios gestionados por el partner, sin exportar el seguimiento a otra herramienta.
Acceso
- Ruta principal:
/[orgId]/settings - Como se llega:
Avatar menu > Settings - Permiso requerido: owner o admin de la organización
Alcance tecnico
- Frontend: rutas de Settings y My Profile relacionadas
- Backend: servicios Feathers de este módulo
- Superficies publicas: no aplica salvo integraciones de terceros
- Integraciones externas: Stripe, Google, Microsoft, Wise, Meta, S3 o proveedores de voz según la funcionalidad
Funcionalidades internas
| Funcionalidad | Archivo | Resumen |
|---|---|---|
| Solicitud de agencia | partner-application.md | Permite postular la organización al programa de agencias. |
| Enlaces de referido | referral-links.md | Muestra y copia enlaces de registro e inicio con atribución de partner. |
| Asignación de organizaciones cliente | partner-clients.md | Crea y asigna un cliente o vincula una organización existente al partner. |
| Resumen y proyección de comisiones | partner-commissions.md | Muestra saldo pendiente, elegible, pagado, clientes y gráficas diarias/mensuales de ganancias. |
| Historial de transacciones de comisión | partner-transactions.md | Lista transacciones de comisión y su estado. |
| Cuenta de cobro Wise | payout-accounts.md | Registra destinos bancarios o de mobile money y presenta el resumen enmascarado. |
| Solicitud de payout | partner-payouts.md | Solicita el retiro de comisiones elegibles hacia la cuenta activa. |
Relaciones
- Depende de: organizaciones, miembros y autenticación.
- Usado por: CRM, automatizaciones y las integraciones descritas.
Limitaciones y notas
- Se documenta únicamente el comportamiento confirmado en frontend, servicios y hooks revisados.