Programa de afiliados

El programa de afiliados de Zentto Store permite a terceros referir clientes a la tienda y ganar comisiones por cada venta generada a través de su enlace único.

Registro de afiliados

Los afiliados se registran a través de un formulario público o son invitados directamente por el administrador. Datos requeridos:

• Nombre completo y email.
• Método de pago preferido para cobrar comisiones.
• Sitio web o redes sociales (opcional).
• Aceptación de términos del programa.

📸 Captura: Formulario de registro de afiliado

Enlace de referido

Cada afiliado aprobado recibe un enlace único con su código:

https://store.zentto.net/?ref=CODIGO_AFILIADO

Cuando un visitante llega a la tienda a través de este enlace, se almacena una cookie de atribución con una ventana de 30 días (configurable). Si el visitante compra dentro de ese período, la venta se atribuye al afiliado.

Estructura de comisiones

Las comisiones se configuran en Ecommerce → Afiliados → Configuración:

Parámetro	Descripción	Valor por defecto
Porcentaje base	Comisión estándar por venta	10%
Por categoría	Comisión diferenciada por categoría de producto	—
Por afiliado	Comisión personalizada para afiliados premium	—
Mínimo de pago	Monto mínimo acumulado para solicitar cobro	$50
Ventana de cookie	Días que dura la atribución	30

Panel del afiliado

Cada afiliado accede a un dashboard donde puede ver:

• Clics: visitas generadas por su enlace.
• Conversiones: ventas atribuidas.
• Tasa de conversión: porcentaje de clics que resultan en compra.
• Comisiones pendientes: monto acumulado sin cobrar.
• Historial de pagos: pagos recibidos con fecha y monto.

📸 Captura: Dashboard del afiliado con métricas y gráficos de rendimiento

Gestión administrativa

El administrador puede:

• Aprobar/rechazar solicitudes de afiliados.
• Ajustar comisiones individualmente.
• Procesar pagos masivos o individuales.
• Desactivar afiliados que incumplan las políticas.
• Ver reportes de rendimiento por afiliado, producto o período.

Pagos

Los pagos de comisiones se procesan de forma manual o automática según la configuración:

• Manual: el administrador revisa y aprueba cada pago.
• Automático: se paga mensualmente cuando el saldo supera el mínimo.
• Métodos soportados: transferencia bancaria, PayPal, crédito en tienda.

Prevención de fraude

El sistema incluye medidas contra abusos:

• Detección de auto-referidos.
• Bloqueo de comisiones en pedidos cancelados o devueltos.
• Alertas por patrones de clics sospechosos.
• Período de retención de 14 días antes de confirmar comisiones.

Flujo del usuario

Vista no técnica del programa de afiliados. Pensada para el equipo de marketing, administradores y los propios afiliados.

Editable en draw.io: descarga el SVG → en draw.io: File → Import from → Device → selecciona el SVG. Cada nodo queda editable.

Flujo técnico

Vista técnica para desarrolladores: sequence registro → link tracking → atribución order.completed → cron de payouts mensual.

Componente	Tipo	Ubicación
POST /v1/ecom/affiliates/register	Route Express	web/api/src/routes/ecom/affiliates.ts
GET /v1/ecom/affiliates/:id/link	Route Express	web/api/src/routes/ecom/affiliates.ts
GET /v1/ecom/affiliates/payouts/due	Route Express (cron JWT)	web/api/src/routes/ecom/affiliates.ts
GET /v1/ecom/affiliates/:id/stats	Route Express	web/api/src/routes/ecom/affiliates.ts
usp_ecom_Affiliate_Register	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_ecom_Affiliate_Attribute	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_ecom_Affiliate_GetPendingPayouts	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_ecom_Affiliate_ProcessPayout	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_ecom_Affiliate_GetStats	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
ecom.Affiliate	Tabla operativa	web/api/migrations/postgres/
ecom.AffiliateCommission	Tabla de comisiones	web/api/migrations/postgres/
AfiliadosPage.tsx	Componente Frontend	web/modular-frontend/packages/module-ecommerce/src/
affiliate-payouts	Cron job mensual	/etc/cron.d/zentto-affiliate-payouts

Editable en draw.io: descarga el SVG → File → Import from → Device.