1. Qu’est-ce que ce module ?

Le module étend Magento 2 avec un système d’affiliation complet fonctionnant directement au sein de la boutique. Cela signifie que le propriétaire de la boutique gère les partenaires, les commissions, les règlements et les supports promotionnels depuis son propre panneau d’administration, tandis que les partenaires disposent de leur propre dashboard dans le compte client.

En pratique, le module permet de mettre en place plusieurs modèles de collaboration simultanément :

• un programme d’affiliation classique basé sur des liens de tracking,
• un programme de parrainage basé sur des codes partenaires individuels,
• un modèle hybride : lien d’affiliation plus code de réduction,
• un programme partenaire pour les clients de la boutique, les agences, les intégrateurs et les créateurs.

2. Principale valeur business

La plus grande valeur du module réside dans la combinaison des ventes, de l’attribution, des règlements et de la gestion des partenaires au même endroit. La boutique n’a pas besoin de maintenir un système d’affiliation externe, d’exporter manuellement les commandes ni de régler les partenaires dans des feuilles de calcul.

Le module apporte au propriétaire de la boutique :

• un nouveau canal de vente,
• le contrôle des règles de collaboration,
• une gestion transparente des commissions et des versements,
• des rapports lisibles sur l’efficacité des affiliés,
• la possibilité de lancer le programme en toute sécurité, y compris dans une boutique de moyenne ou grande taille.

Le partenaire reçoit :

• son propre code de parrainage,
• son propre lien d’affiliation,
• un panneau prêt à l’emploi pour suivre ses actions,
• une visibilité sur les commissions et les payouts,
• la possibilité d’utiliser des supports promotionnels et des bannières.

3. À qui s’adresse ce module ?

Le module convient aux boutiques qui souhaitent construire un réseau de partenaires commerciaux sans utiliser de plateformes d’affiliation externes, ou qui veulent conserver un contrôle total sur les données et le processus de règlement.

Il est particulièrement adapté aux projets dans lesquels le programme d’affiliation doit être animé par :

• des clients recommandant la boutique à leurs proches,
• des créateurs de contenu en ligne,
• des blogueurs et éditeurs,
• des spécialistes et consultants,
• des partenaires d’intégration,
• des software houses et agences,
• des revendeurs et commerciaux B2B,
• des ambassadeurs de marque et communautés.

4. Fonctions principales du module

4.1. Inscription de l’affilié

Le module fournit un formulaire de candidature au programme d’affiliation. Le client peut demander lui-même à participer au programme en indiquant ses coordonnées de base, l’adresse de son site ou canal, ainsi qu’une brève information sur la promotion prévue.

Après l’envoi du formulaire :

• un compte affilié est créé,
• un referral_code unique est généré,
• le statut de la demande est défini sur Pending,
• l’administrateur peut recevoir une notification concernant la nouvelle demande,
• le client peut recevoir une confirmation de prise en compte de sa demande.

4.2. Validation du partenaire

L’administrateur peut valider l’affilié depuis le panneau Magento. Après acceptation :

• le statut du partenaire passe à Active,
• le partenaire peut utiliser pleinement le programme,
• il est possible d’activer un coupon d’affiliation,
• le client peut recevoir un message confirmant l’approbation de sa participation.

4.3. Lien d’affiliation

Chaque affilié reçoit son propre lien d’affiliation basé sur le referral_code. Le lien fonctionne via un contrôleur de tracking et enregistre l’attribution de la visite. Après un clic, le système peut :

• enregistrer l’affiliation dans un cookie,
• créer une entrée de visite,
• créer une entrée d’attribution,
• relier une commande ultérieure à un affilié précis.

4.4. Code d’affiliation et coupon de réduction

Le module prend également en charge un modèle dans lequel le referral_code peut fonctionner comme code de réduction dans le panier.

L’administrateur peut définir sur le compte de l’affilié le champ :

• Affiliate Coupon Discount (%)

Si la valeur est supérieure à zéro, le système :

• synchronise la règle native Cart Price Rule de Magento,
• définit un code coupon égal au referral_code,
• applique une remise en pourcentage dans le panier,
• traite l’utilisation de ce code comme source d’affiliation de la commande.

Grâce à cela, l’affilié peut promouvoir :

• un lien d’affiliation classique,
• le code de réduction seul,
• la combinaison des deux mécanismes en même temps.

C’est l’une des fonctions commerciales les plus pratiques du module, car de nombreux propriétaires de boutiques attendent du partenaire non seulement qu’il génère du trafic, mais aussi qu’il apporte au client un avantage tarifaire concret.

4.5. Attribution des commandes

Le module peut attribuer une commande à un affilié sur la base de :

• un clic sur un lien d’affiliation,
• une attribution active enregistrée dans la session ou dans un cookie,
• l’utilisation d’un code d’affiliation dans le panier,
• un client connecté associé à une attribution active.

Au niveau de la commande, les données suivantes sont enregistrées :

• affiliate_id,
• affiliate_attribution_id,
• affiliate_referral_code,
• is_affiliate_order,
• affiliate_commission_amount,
• affiliate_commission_status.

Cela permet de reporter la source de vente directement sur quote et sales_order.

4.6. Calcul des commissions

La commission est créée automatiquement pour une commande affiliée. Dans le modèle actuel :

• la commission est calculée en pourcentage du sous-total de la commande,
• le taux par défaut provient de la configuration du module,
• le système évite la duplication des commissions pour la même commande et le même affilié,
• le résultat est enregistré dans la table des commissions et sur la commande.

Les statuts de commission pris en charge incluent notamment :

• pending,
• approved,
• ready_for_payout,
• paid,
• rejected,
• cancelled,
• charged_back.

4.7. Hold period et acceptation automatique

Le module prend en charge une période de blocage des commissions. Cela signifie que la commission n’a pas besoin d’être immédiatement prête au versement. Elle peut rester pendant une durée définie au statut en attente, puis être automatiquement approuvée par cron à l’issue de cette période.

Cette solution est particulièrement importante en cas de :

• risque de retours,
• vérification manuelle des commandes,
• modèles de vente avec finalisation différée,
• nécessité de protéger le programme contre les abus.

4.8. Versements aux affiliés

Le partenaire peut soumettre une demande de versement si le seuil minimal est atteint et s’il dispose d’un solde approuvé suffisant.

Le workflow des payouts comprend :

• la soumission d’une payout request,
• l’affectation des commissions au payout,
• le changement du statut de commission en ready_for_payout,
• le marquage du versement comme payé,
• le changement des statuts de commission en paid.

Le propriétaire de la boutique peut ainsi gérer les versements de manière structurée et auditable.

4.9. Fraud prevention

Le module dispose d’une couche antifraude de base qui aide à éliminer les abus les plus évidents.

Elle comprend notamment :

• le blocage du self-referral,
• le marquage des commissions comme rejetées lorsqu’un abus est détecté,
• la gestion des cas de fraude,
• l’enregistrement des motifs de rejet,
• une vue séparée des fraud cases côté administrateur.

Le module prend également en charge :

• les annulations de commandes,
• les chargebacks,
• les remboursements via creditmemo,
• le changement des statuts de commission après les retours.

4.10. Notifications

Le module possède son propre système de mise en file et de traitement des notifications. Il peut enregistrer des événements opérationnels et envoyer des e-mails.

Les cas pris en charge incluent notamment :

• une nouvelle demande d’affilié,
• la confirmation de prise en compte de la demande,
• l’acceptation de l’affilié,
• les événements liés aux commissions,
• les payouts,
• les fraud alerts.

4.11. Panneau de l’affilié

Le partenaire utilise un dashboard avancé dans le compte client Magento. Le dashboard n’est pas seulement une liste de commissions, mais un panneau opérationnel complet.

Dans le panneau de l’affilié, les éléments suivants sont disponibles :

• le statut de participation au programme,
• le code de parrainage,
• le lien d’affiliation complet,
• le chemin cible par défaut,
• le résumé des commissions,
• l’historique des commissions,
• l’accès aux payouts,
• les contenus des règles de collaboration,
• des snippets promotionnels prêts à l’emploi,
• un aperçu de bannière,
• un générateur de bannière AI.

4.12. Générateur de bannière AI

Le module comprend une fonction assistée par AI qui permet à l’affilié de préparer une bannière promotionnelle prête à l’emploi à partir d’un brief.

L’utilisateur peut fournir :

• un brief textuel,
• une direction visuelle,
• des couleurs,
• un style,
• une URL d’image optionnelle,
• un target link optionnel.

Le système transmet à la couche AI :

• le brief utilisateur,
• le referral link,
• le target path,
• les exigences techniques relatives au format de réponse.

Le HTML généré de la bannière peut être enregistré sur le compte de l’affilié et utilisé par le partenaire comme support promotionnel prêt à l’emploi.

4.13. Reporting

Le module prend en charge les rapports et exports CSV pour les zones clés du programme :

• commissions,
• payouts,
• fraud cases,
• insights AI.

Cela facilite aussi bien la gestion quotidienne du programme que l’analyse de l’efficacité des partenaires.

5. Panneau d’administration

Le module enrichit le panneau d’administration Magento avec la configuration et la gestion du programme d’affiliation.

L’administrateur a accès à :

• les paramètres globaux du programme,
• les paramètres de commission,
• les paramètres de payouts,
• les paramètres du portail affilié,
• les paramètres de notifications,
• les paramètres de fraude,
• les paramètres AI,
• les paramètres de reporting.

Des sections opérationnelles sont également disponibles dans le panneau :

• Affiliate Commissions,
• Affiliate Payouts,
• Affiliate Fraud Cases,
• Affiliate Reports.

Dans la liste des clients et dans l’édition d’un client, les données d’affiliation sont visibles, telles que :

• la participation au programme,
• le statut d’affilié,
• le solde d’affilié,
• le code de parrainage,
• le pourcentage de réduction du coupon d’affiliation.

6. Fonctionnement concret de l’affiliation

6.1. Scénario du lien d’affiliation

1. Le partenaire reçoit son lien.
2. Le client clique sur le lien et arrive dans la boutique.
3. Le système enregistre la visite et l’attribution.
4. Le client passe commande.
5. La commande est attribuée à l’affilié.
6. Une commission est créée.
7. Après l’expiration du hold period, la commission peut être approuvée.
8. Une fois les conditions remplies, le partenaire peut déposer une demande de versement.

6.2. Scénario du code d’affiliation dans le panier

1. Le partenaire publie son code d’affiliation.
2. Le client saisit le code dans le panier.
3. Magento applique la remise issue de la règle panier.
4. Le module reconnaît le code comme code d’affilié.
5. La commande est attribuée à l’affilié.
6. Une commission est créée conformément aux règles du programme.

6.3. Scénario hybride

Le client peut d’abord accéder à la boutique via un lien d’affiliation, puis utiliser le code de réduction de l’affilié. Ce modèle permet de combiner le tracking classique avec des avantages pour le client final.

7. Domaines de sécurité

Le module a été conçu pour un déploiement en production, il prend donc en compte :

• les enregistrements d’audit,
• la gestion des retours et annulations,
• le blocage du self-referral,
• la file de notifications,
• les mécanismes limitant la duplication des commissions,
• le stockage sécurisé de la configuration AI,
• la limitation des données envoyées à la couche AI,
• la possibilité de diagnostiquer les erreurs d’intégration.

8. Intégration avec AI

La couche AI du module est optionnelle et ne bloque pas le fonctionnement du programme d’affiliation de base. Elle peut être utilisée pour :

• l’assistant d’affilié,
• la génération d’insights,
• la génération de bannières,
• le retrieval des connaissances produit via vector_store_id.

Le module n’a pas besoin de maintenir sa propre base produit pour AI si la boutique utilise déjà un module externe de gestion des connaissances produit et Vector Store.

9. Cas d’usage commerciaux

Le module peut être vendu comme solution pour plusieurs types de projets :

• boutiques B2C avec programme de parrainage,
• boutiques premium souhaitant construire un réseau d’ambassadeurs de marque,
• activités B2B avec programme pour partenaires commerciaux,
• boutiques digitales et software,
• déploiements d’agence où le client a besoin d’un programme partenaire complet sans SaaS externe.

Les arguments commerciaux particulièrement forts sont :

• le contrôle total des données,
• l’absence d’abonnement à une plateforme d’affiliation externe,
• l’intégration avec Magento 2 sans intermédiaires,
• la prise en charge des liens et coupons d’affiliation,
• un panneau partenaire prêt à l’emploi,
• la possibilité d’une extension ultérieure avec AI.

10. Principaux avantages du module

Les principaux avantages de cette solution sont :

• elle fonctionne directement dans Magento 2,
• elle prend en charge à la fois les liens et les codes d’affiliation,
• elle gère les coupons de réduction associés à l’affilié,
• elle permet de gérer les partenaires depuis le niveau client Magento,
• elle dispose d’un vrai workflow de commissions et de payouts,
• elle inclut une sécurité et un audit de base,
• elle possède un dashboard affilié moderne,
• elle est prête à évoluer avec de nouvelles fonctions enterprise.

11. Exigences système

Le module est destiné à :

• Magento Open Source / Adobe Commerce 2.4.7+
• PHP 8.2 / 8.3

Il nécessite des modules Magento compatibles liés à :

• Customer,
• Quote,
• Sales,
• SalesRule,
• Cms,
• Email,
• Backend,
• Store.

12. Périmètre de déploiement

Le module peut être déployé par étapes :

• démarrage avec les liens d’affiliation et les commissions,
• extension avec les payouts,
• extension avec les coupons d’affiliation,
• extension avec AI et du content pour les affiliés,
• développement ultérieur avec des règles de commission plus avancées et du fraud scoring.

Cela signifie qu’il convient aussi bien aux déploiements MVP qu’au développement à long terme d’un programme partenaire.

13. Résumé

Kowal_Affiliate est un module d’affiliation mature pour Magento 2, qui permet de vendre et de lancer un programme partenaire complet au sein de sa propre boutique. Il combine liens d’affiliation classiques, codes de parrainage, coupons de réduction, commissions, payouts, fraud prevention de base, reporting et panneau partenaire moderne.

D’un point de vue commercial, ce n’est pas seulement un complément pour liens de parrainage, mais une couche partenaire complète pour Magento 2, qui peut être proposée comme :

• module standalone,
• élément de déploiement de boutique,
• partie d’un package growth / performance,
• base pour un programme partenaires et ambassadeurs de marque plus avancé.

En pratique, c’est une solution qui répond aux besoins réels des boutiques recherchant :

• un programme d’affiliation dans Magento 2,
• des codes de réduction pour partenaires,
• le règlement des commissions,
• un panneau partenaire,
• une préparation à la vente et à l’exploitation en production.