DataFirefly Affiliate Program: programa de afiliados para PrestaShop
Instalar, configurar y gestionar el programa de afiliación: panel, seguimiento de enlaces, comisiones con periodo de validación, reglas y simulador, extractos SEPA o PayPal, área de afiliado y material promocional.
Instalación y actualización
Instala el módulo desde Módulos > Gestor de módulos > Subir un módulo enviando el archivo ZIP. El mismo ZIP funciona en PrestaShop 1.7.8, 8 y 9.
Al instalarse, el módulo crea sus tablas y sus ajustes por defecto, y añade el menú Vender > Afiliación con siete entradas: Panel, Afiliados, Comisiones, Extractos y pagos, Reglas de comisión, Material promocional y Ajustes. Un menú común en la parte superior de cada página permite pasar de una a otra.
Para pasar de la versión 1.0.0 o 1.1.0 a la 2.0.0, basta con enviar el nuevo ZIP. El script de actualización conserva los afiliados, enlaces, clics, comisiones, extractos, reglas y ajustes, y añade las novedades:
- los IBAN ya guardados se cifran;
- las comisiones que siguen dentro de su plazo pasan a la etapa «periodo de validación»;
- los nuevos ajustes reciben su valor por defecto.
Antes de abrir el programa, revisa en Ajustes el estado o los estados de pedido que confirman el pago, el periodo de validación y el pago mínimo. El Panel muestra después una comprobación de la configuración que indica lo que falta.
Panel

El panel resume la actividad de 7 días, 30 días, 90 días o 12 meses:
- Indicadores: clics y visitantes únicos, pedidos atribuidos y conversión de los clics, ventas generadas (base de comisión de los pedidos, sin gastos de envío), comisiones generadas y su porcentaje sobre las ventas, comisiones por pagar, afiliados activos, pedidos rechazados por autoafiliación o doble recompensa.
- Gráfico de clics y ventas por día, o por mes en 12 meses.
- Dónde están las comisiones: pendientes del pago del pedido, en periodo de validación, pagables, en extractos por pagar, pagadas.
- Tareas pendientes: solicitudes por revisar, comisiones pendientes, extractos por crear o por pagar, afiliados sin datos de pago, cada uno con un botón que abre la lista correspondiente.
- Comprobación de la configuración, mejores afiliados, enlaces con más clics y últimas comisiones.
Seguimiento y atribución
Los enlaces de seguimiento
Cada afiliado tiene un código. Dos tipos de enlaces lo transmiten:
- el parámetro de seguimiento, que se añade a cualquier dirección de la tienda:
?aff=CODE. El nombre del parámetro se cambia en los ajustes; - los enlaces cortos
/go/…que el afiliado crea en su área. Redirigen a la página elegida y cuentan los clics y los pedidos por enlace. Solo se aceptan direcciones de la tienda: un enlace nunca puede redirigir a otro sitio.
La cookie de atribución
Al hacer clic, la cookie dfaff_ref registra al afiliado. Está firmada (un visitante no puede modificarla), es HttpOnly y SameSite=Lax, y su duración se configura en los ajustes o por afiliado. La atribución también se copia en el carrito, lo que cubre los pagos que el banco confirma más tarde.
Nunca se cuentan:
- los robots y las vistas previas de enlaces de las redes sociales y las aplicaciones de mensajería;
- las precargas del navegador y las peticiones HEAD;
- los clics del propio afiliado;
- las recargas y los clics repetidos de un mismo visitante en el mismo enlace durante el intervalo elegido (30 minutos por defecto).

Cookie y consentimiento
El ajuste Cookie de atribución y consentimiento ofrece dos comportamientos:
- escribir la cookie en cada visita rastreada;
- esperar al consentimiento: la cookie solo se escribe si la cookie de tu banner de consentimiento está presente y contiene el texto indicado, por ejemplo
tarteaucitronydfaffiliate=true. Sin consentimiento, el clic se sigue contando en las estadísticas, pero solo un código de descuento del afiliado puede atribuir el pedido.
La situación de esta cookie respecto a la normativa depende de tu país y de tu uso: haz que la valide tu asesor. El módulo no garantiza ningún cumplimiento normativo.
Orden de atribución de un pedido
- El código de descuento personal de un afiliado usado en el pedido, incluso sin clic.
- El enlace o la cookie.
- Un cliente ya aportado por ese afiliado, si las comisiones por clientes recurrentes están activadas.
El modelo de atribución decide qué ocurre cuando un visitante hace clic en los enlaces de dos afiliados: último clic (por defecto), gana el último afiliado visitado; primer clic, el primero conserva la venta hasta que caduca la cookie.
Comisiones
Ciclo de una comisión

- Pendiente del pago del pedido: el pedido se ha realizado. Un pedido pagado por transferencia o cheque permanece en esta etapa hasta que confirmes el pago.
- Periodo de validación: el pedido alcanza un estado que confirma el pago. La comisión espera el número de días elegido (30 por defecto) para cubrir el plazo de desistimiento y las devoluciones. Se muestra la fecha de fin.
- Pagable: el periodo ha terminado y la comisión entrará en el próximo extracto.
- En un extracto y, después, Pagado cuando marcas el extracto como pagado.
Los periodos de validación finalizan solos: mediante la tarea cron si la usas o, si no, al abrir el back office del módulo o el área de afiliado.
Casos particulares:
- Pedido cancelado o reembolsado: la comisión se rechaza mientras no esté pagada. Si después el pedido se vuelve a pagar, la comisión vuelve con un nuevo periodo de validación.
- Reembolso parcial (factura por abono): la comisión se reduce de forma proporcional a los productos reembolsados.
- Después del pago: el módulo ya no modifica la comisión pagada y crea un ajuste negativo, que se descuenta del extracto siguiente. Un segundo cambio de estado no crea un nuevo descuento.
- Una sola comisión por pedido: volver a cargar la página de confirmación, recibir dos notificaciones de pago o pasar varias veces por el mismo estado nunca crea un duplicado (bloqueo y clave única en la base de datos).
En la lista de comisiones, la acción en bloque Aprobar ahora pone fin al periodo de validación de las comisiones seleccionadas. Rechaza los pedidos que aún no están pagados e indica su referencia.
Cálculo
- Base: productos sin IVA o con IVA (a elegir), nunca los gastos de envío.
- Cupones de descuento: se descuentan de forma prorrateada en cada línea si la opción está activada. Un cupón de envío gratuito no se descuenta.
- Monedas: los pedidos realizados en otra moneda se convierten con el tipo de cambio guardado en el pedido.
- Redondeo: una sola vez por pedido, al céntimo.
- Importe fijo: una comisión por pedido, y solo una aunque PrestaShop divida un carrito en varios pedidos.
- Clientes recurrentes: durante el número de días elegido, los pedidos siguientes de un cliente aportado generan una comisión, a la tasa del afiliado o a una tasa específica.
Ningún importe procede del navegador: todo se recalcula a partir del pedido registrado por PrestaShop.
Reglas de comisión y simulador

Una regla fija una tasa para una categoría o un producto, para todos los afiliados o para uno solo. Para cada línea de pedido, la prioridad es la siguiente:
- regla de producto;
- regla de la categoría por defecto del producto;
- mejor regla de las demás categorías;
- tasa del afiliado o del programa.
Una regla reservada a un afiliado prevalece sobre la misma regla para todos. Una regla puede sustituir la tasa (una regla al 0 % excluye los productos) o sumarse a ella: un afiliado al 10 % con una regla «+2» cobra un 12 %, con un máximo del 100 %. Las reglas no se aplican a los importes fijos.
El simulador, en la parte superior de la página de reglas, responde a la pregunta «¿qué tasa se aplica y por qué?» para un producto y un afiliado, o reproduce un pedido existente línea por línea, sin crear nada.
Comisiones manuales
Añadir una comisión manual abona o carga un importe a un afiliado (importe negativo para un descuento), con una nota visible en su área.
Antifraude y doble recompensa

- Un pedido realizado con la misma cuenta de cliente, el mismo email o, si la opción está activada, enviado o facturado a una dirección del afiliado se registra como rechazado, con un motivo que pueden leer el comerciante y el afiliado.
- Con el módulo DataFirefly Loyalty & Referral activo, un pedido que ya recompensa a un padrino no genera comisión de afiliación (ajuste modificable). Los datos del módulo de recomendación solo se leen, nunca se modifican. Los dos módulos usan parámetros de URL y cookies diferentes.
- Solo clientes nuevos e Importe mínimo de pedido completan estas protecciones.
Afiliados
Solicitudes

La página pública del programa presenta tus condiciones (tasa, duración de la cookie, periodo de validación, pago mínimo), los pasos y unas preguntas frecuentes generadas a partir de tus ajustes. El texto de presentación se edita en cada idioma.

El candidato debe haber iniciado sesión con una cuenta de cliente. Indica dónde publica y describe su audiencia. Si se ha elegido una página CMS de condiciones, debe aceptarla. Por defecto, cada solicitud espera tu aprobación y la dirección de notificación recibe un email.
Lista y ficha del afiliado

La lista muestra el código, el canal, el estado, los clics, los pedidos y los saldos. Las acciones en bloque aprueban, rechazan o suspenden varias solicitudes a la vez. La exportación CSV neutraliza las celdas que una hoja de cálculo podría interpretar como fórmulas.

La ficha del afiliado reúne en una sola página:
- el perfil, con los botones Aprobar, Rechazar, Suspender y Editar;
- los indicadores y el saldo por etapa;
- las condiciones (tasa, reglas propias, cookie, código de descuento) y el enlace de seguimiento;
- los datos de pago, con el IBAN enmascarado;
- la solicitud;
- los enlaces de los últimos 30 días, las últimas comisiones y los extractos.
El bloque Datos personales exporta en JSON lo que el módulo guarda sobre el afiliado. También permite anonimizarlo: se borran el nombre, el email, la web, los datos de pago, los enlaces y los clics, y las comisiones y los extractos se conservan para tu contabilidad.
En el formulario de edición, el IBAN nunca se vuelve a mostrar completo: deja el campo vacío para conservar el guardado o introduce uno nuevo.
Lo que ve el afiliado

El área de afiliado se abre con una cabecera que muestra su código, su tasa y sus saldos (en validación, pagable, pagado), seguida de seis pestañas. Funciona con los temas Classic y Hummingbird.
- Resumen: generador de enlaces, indicadores, gráfico de los últimos 30 días, condiciones y enlaces recientes.
- Generador de enlaces: creación de un enlace corto a cualquier página de la tienda, lista de enlaces con clics, pedidos, copia y eliminación.
- Estadísticas: clics, pedidos, conversión, ventas y comisiones de 7 días a 12 meses, origen de los clics y rendimiento por enlace.
- Comisiones: etapa de cada comisión, fecha prevista de pago, referencia del pedido enmascarada. No se muestra ningún dato del cliente.
- Pagos: extractos mensuales que se pueden consultar e imprimir, elección entre transferencia SEPA o PayPal, IBAN comprobado mediante sus dígitos de control, cifrado y mostrado enmascarado, emails de ventas.
- Material promocional: banners y textos listos para usar, con el enlace de seguimiento del afiliado ya incluido.




Un afiliado solo ve sus propios datos: sus enlaces, sus comisiones y sus extractos se comprueban en cada visualización, y los formularios están protegidos con un token.
Material promocional

En Material promocional, añade banners (JPG, PNG, GIF o WebP, 2 MB como máximo) y textos listos para usar, con un nombre y un texto alternativo en cada idioma, y la página de la tienda a la que llevan. El orden se ajusta arrastrando y soltando.

Cada afiliado copia el código HTML del banner, el texto y el enlace, con su enlace de seguimiento ya incluido. La pestaña solo aparece en el área de afiliado si existe al menos un elemento activo.
Extractos y pagos

El pago se realiza en cuatro pasos, que se recuerdan en la parte superior de la página:
- Crear los extractos: elige el mes, previsualiza los importes por afiliado y crea los extractos. Un extracto agrupa las comisiones pagables creadas antes del final del mes y los ajustes negativos. Por debajo del pago mínimo, el saldo se aplaza.
- Exportar el fichero de pago: selecciona los extractos y, después, la acción en bloque Fichero de transferencia SEPA (XML, pain.001.001.03) o Fichero PayPal Payouts (CSV). La exportación contable CSV muestra el IBAN enmascarado.
- Pagar desde tu banco o PayPal: el módulo nunca envía dinero.
- Marcar como pagado, con la referencia y la fecha de la transferencia.

Un extracto pagado ya no se puede exportar ni pagar por segunda vez. Una exportación de pago se rechaza por completo si un extracto seleccionado ya está pagado o si faltan datos: el mensaje indica el afiliado afectado y dónde completarlos.
Tarea cron (opcional)
La URL cron figura en los ajustes. Finaliza los periodos de validación y, si la opción está activada, crea entre el día 1 y el 5 de cada mes los extractos del mes anterior. Está protegida por un token, nunca se ejecuta dos veces a la vez y nunca paga nada.
Emails
El módulo envía cuatro emails, traducidos a 8 idiomas y enviados en el idioma del destinatario, asunto e importes incluidos: nueva solicitud (al comerciante), cuenta de afiliado activada, nueva venta y extracto disponible.


El email de nueva venta indica la comisión, el importe del pedido y la tasa, nunca los datos del cliente. Cada afiliado puede desactivarlo. Las plantillas están en la carpeta mails/ del módulo.
Ajustes
La página de ajustes se organiza en cinco bloques:
- Seguimiento y atribución: parámetro de URL, duración de la cookie, modelo de atribución, intervalo antiduplicados, consentimiento, clientes recurrentes.
- Comisiones: tipo y tasa por defecto, base sin IVA o con IVA, descuento de los cupones, solo clientes nuevos, importe mínimo de pedido, estados que confirman el pago o que rechazan la comisión, periodo de validación.
- Fraude y dobles recompensas.
- Extractos y pagos: pago mínimo, extractos por cron, datos SEPA de la empresa.
- Solicitudes y página del programa: aprobación automática, emails, texto de presentación, página de condiciones, color de acento.
Los mensajes de error indican qué corregir, por ejemplo «IBAN de la empresa: los dígitos de control no coinciden».
RGPD
El módulo se registra en el módulo RGPD oficial de PrestaShop. La exportación de los datos de un cliente incluye su perfil de afiliado y sus comisiones, con el IBAN enmascarado. La supresión anonimiza al afiliado y conserva las comisiones y los extractos. Las mismas acciones están disponibles desde la ficha del afiliado. Estas herramientas te ayudan a tramitar las solicitudes, pero no constituyen una garantía de cumplimiento normativo.
Solución de problemas
No se cuenta ningún clic
Haz la prueba en una ventana de navegación privada, sin haber iniciado sesión con la cuenta del afiliado. Los navegadores automatizados se filtran como robots. Con la opción «esperar al consentimiento», acepta primero el servicio en tu banner. Si tu tienda usa una caché de páginas completas, utiliza los enlaces cortos /go/, que siempre pasan por PrestaShop.
Una comisión sigue «pendiente del pago»
Comprueba que el estado actual del pedido esté marcado en Pedido pagado en. Un pedido por transferencia o cheque sigue pendiente mientras no hayas confirmado el pago.
Se rechaza la exportación SEPA
Lee el mensaje que se muestra: indica el extracto ya pagado o el afiliado al que le falta el IBAN. Comprueba también la razón social y el IBAN de la empresa, y que el euro sea la moneda por defecto.
Compatibilidad
- PrestaShop 1.7.8, 8 y 9: el mismo ZIP cubre las tres ramas, con los temas Classic y Hummingbird.
- Multitienda: afiliados, comisiones y estadísticas filtrados por tienda. Multimoneda: conversión al tipo de cambio del pedido.
- Módulo y emails en inglés, francés, español, alemán, italiano, neerlandés, polaco y portugués.