MAGENTO 2 · PARTENAIRES · COMMISSIONS · LIENS ET COUPONS

Kowal Affiliate

Associez l’inscription des partenaires, l’attribution des commandes et les règlements à un panneau affilié. Gérez les liens, les codes de réduction et l’historique des commissions, et utilisez l’AI optionnelle pour soutenir les partenaires et les supports promotionnels.

Lien et code partenaire · Commissions et solde · Workflow de paiements

COMMENT CELA FONCTIONNE EN PRATIQUE

Le module étend Magento 2 avec un système d’affiliation complet fonctionnant directement dans 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 utilisent leur propre dashboard dans le compte client.

En pratique, le module permet de déployer plusieurs modèles de collaboration en même temps :

• 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.

La plus grande valeur du module est de regrouper la vente, l’attribution, les règlements et la gestion des partenaires en un seul 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 offre au propriétaire de la boutique :

• un nouveau canal de vente,
• le contrôle des règles de collaboration,
• une gestion claire des commissions et des paiements,
• des rapports lisibles sur l’efficacité des affiliés,
• la possibilité de préparer un programme pour une boutique de moyenne ou grande taille après validation du déploiement.

Le partenaire reçoit :

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

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 mené par :

• des clients qui recommandent la boutique à leurs proches,
• des créateurs web,
• 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.

Le module met à disposition un formulaire de candidature au programme d’affiliation. Le client peut demander lui-même à participer au programme en fournissant les données de contact de base, l’adresse du site ou du 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 de nouvelle demande,
• le client peut recevoir une confirmation de prise en compte de la demande.

L’administrateur peut approuver 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 le coupon d’affiliation,
• le client peut recevoir un message confirmant la validation de sa participation.

Chaque affilié reçoit son propre lien d’affiliation basé sur referral_code. Le lien fonctionne via un contrôleur de tracking et enregistre l’attribution de la visite. Après le 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,
• associer une commande ultérieure à un affilié précis.

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

L’administrateur peut définir sur le compte 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 le code coupon égal à referral_code,
• applique une remise en pourcentage dans le panier,
• considère l’utilisation de ce code comme la source d’affiliation de la commande.

Ainsi, l’affilié peut promouvoir :

• un lien d’affiliation classique,
• le code de réduction seul,
• la combinaison simultanée des deux mécanismes.

C’est l’une des fonctionnalités 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.

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

• un clic sur un lien d’affiliation,
• une attribution active enregistrée en session ou dans un cookie,
• l’utilisation d’un code d’affiliation dans le panier,
• un client connecté lié à 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.

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

• la commission est calculée en pourcentage du subtotal 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 comprennent notamment :

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

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

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.

Le partenaire peut déposer une demande de paiement 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 passage du statut de commission à ready_for_payout,
• le marquage du paiement comme réglé,
• le changement des statuts de commission en paid.

Ainsi, le propriétaire de la boutique peut gérer les paiements de façon structurée et auditable.

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

Cela 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 refunds via creditmemo,
• le changement des statuts de commission après les retours.

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 comprennent notamment :

• nouvelle demande d’affilié,
• confirmation de réception de la demande,
• acceptation de l’affilié,
• événements de commission,
• payouts,
• fraud alerts.

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

Le panneau affilié donne accès à :

• le statut de participation au programme,
• le code de parrainage,
• le lien d’affiliation complet,
• le chemin de cible par défaut,
• le récapitulatif 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.

Le module inclut 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 orientation 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 concernant le format de réponse.

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

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

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

Cela facilite à la fois la gestion quotidienne du programme et l’analyse de l’efficacité des partenaires.

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 des commissions,
• les paramètres des payouts,
• les paramètres du portail affilié,
• les paramètres des 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 du client, des données d’affiliation sont visibles, telles que :

• participation au programme,
• statut affilié,
• solde affilié,
• code de parrainage,
• pourcentage de remise du coupon 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. À l’issue du hold period, la commission peut être approuvée.
8. Une fois les conditions remplies, le partenaire peut déposer une demande de paiement.

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

Le client peut d’abord entrer dans 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.

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

• les journaux 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.

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 affilié,
• la génération d’insights,
• la génération de bannières,
• le retrieval de connaissances produit via vector_store_id.

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

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,
• entreprises B2B avec programme pour partenaires commerciaux,
• boutiques numériques et software,
• déploiements en agence où le client a besoin d’un programme partenaire complet sans SaaS externe.

Les arguments de vente 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 l’AI.

Les principaux avantages de cette solution sont :

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

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.

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 l’AI et le contenu 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.

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

D’un point de vue commercial, il ne s’agit pas seulement d’un module complémentaire pour les liens de parrainage, mais d’une couche partenaire complète pour Magento 2, qui peut être proposée comme :

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

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 au fonctionnement en production.

La commission est basée sur le subtotal de la commande. Le taux du compte affilié est prioritaire sur le taux par défaut du programme. La valeur de remise du coupon partenaire et le pourcentage de sa commission sont des paramètres distincts.

La configuration par défaut prévoit un cookie de 30 jours, une commission de 10%, un hold period de 14 jours et un seuil de paiement de 100. Avant le lancement, définissez vos propres règles, la devise et la méthode de gestion des retours.

Le ledger enregistre les variations du solde du partenaire. En plus du workflow de paiements, le module propose l’option d’utiliser le solde comme remise de valeur dans le panier, avec des limites de montant, des règles d’utilisation partielle et de combinaison avec les coupons.

Le mode par défaut est payout_only. Une demande de paiement réserve les commissions appropriées ; le marquage paid confirme l’étape du workflow, mais n’effectue pas à lui seul de virement via une banque ou un opérateur de paiement.

Stores → Configuration → Affiliate Program couvre les paramètres du programme, des commissions, des payouts, du settlement, du portail, des notifications, de la fraude, de l’AI et des rapports. L’installation peut ajouter la page CMS affiliate-program sans écraser une page existante portant cet identifiant.

L’AI est désactivée par défaut. L’assistant, les bannières HTML et les insights hebdomadaires nécessitent une configuration appropriée ; la connaissance produit utilise le Vector Store existant, et le module ne le synchronise pas lui-même.

Package kowal/module-affiliate, module Kowal_Affiliate. Après avoir configuré l’accès au dépôt Kowal, installez le package, activez le module, mettez Magento à jour et videz le cache. En production, incluez la compilation et le déploiement du contenu statique conformément au processus de la boutique.

1. Vous acceptez un partenaire
La demande passe en validation et reçoit un code de parrainage.

2. Vous attribuez la vente
Le lien ou le coupon associe la commande à l’affilié.

3. Vous réglez le résultat
Les commissions passent par une période d’attente et un traitement du paiement.

Le partenaire partage le lien et son coupon. Le client reçoit la remise configurée et la commande est attribuée au partenaire.

Après contrôle et période de hold, le solde approuvé peut être éligible à une demande de paiement. Vous organisez le transfert effectif des fonds dans le processus de règlement de l’entreprise.