1. Wat is deze module

De module breidt Magento 2 uit met een compleet affiliatesysteem dat rechtstreeks binnen de webshop werkt. Dit betekent dat de winkeleigenaar partners, commissies, afrekeningen en promotiematerialen beheert vanuit het eigen beheerpaneel, terwijl partners gebruikmaken van hun eigen dashboard in het klantaccount.

In de praktijk maakt de module het mogelijk om meerdere samenwerkingsmodellen tegelijk te implementeren:

• een klassiek affiliateprogramma op basis van trackinglinks,
• een referralprogramma op basis van individuele partnercodes,
• een hybride model: affiliatelink plus kortingscode,
• een partnerprogramma voor klanten van de winkel, bureaus, implementatiepartners en creators.

2. Belangrijkste zakelijke waarde

De grootste waarde van de module is de combinatie van verkoop, attributie, afrekeningen en partnerbeheer op één plek. De webshop hoeft geen extern affiliatesysteem te onderhouden, bestellingen handmatig te exporteren of partners in spreadsheets af te rekenen.

De module biedt de winkeleigenaar:

• een nieuw verkoopkanaal,
• controle over de samenwerkingsregels,
• transparante verwerking van commissies en uitbetalingen,
• duidelijke rapporten over de effectiviteit van affiliates,
• de mogelijkheid om het programma veilig te starten, ook in middelgrote en grote webshops.

De partner krijgt:

• een eigen referralcode,
• een eigen affiliatelink,
• een kant-en-klaar paneel om activiteiten te monitoren,
• inzicht in commissies en payouts,
• de mogelijkheid om promotiematerialen en banners te gebruiken.

3. Voor wie is de module bedoeld

De module is geschikt voor webshops die een netwerk van verkooppartners willen opbouwen zonder externe affiliateplatforms te gebruiken, of die volledige controle over gegevens en het afrekenproces willen behouden.

De module werkt bijzonder goed in projecten waarin het affiliateprogramma wordt uitgevoerd door:

• klanten die de webshop aanbevelen aan bekenden,
• online creators,
• bloggers en uitgevers,
• specialisten en consultants,
• implementatiepartners,
• software houses en bureaus,
• resellers en B2B-verkopers,
• merkambassadeurs en communities.

4. Belangrijkste functies van de module

4.1. Registratie van een affiliate

De module stelt een aanmeldformulier voor het affiliateprogramma beschikbaar. De klant kan zich zelfstandig aanmelden voor deelname aan het programma door basiscontactgegevens, het adres van de website of het kanaal en korte informatie over de geplande promotie op te geven.

Na het verzenden van het formulier:

• wordt een affiliateaccount aangemaakt,
• wordt een unieke referral_code gegenereerd,
• wordt de status van de aanmelding ingesteld op Pending,
• kan de beheerder een melding ontvangen over een nieuwe aanmelding,
• kan de klant een bevestiging ontvangen dat de aanmelding is ontvangen.

4.2. Partner goedkeuren

De beheerder kan een affiliate goedkeuren vanuit het Magento-paneel. Na acceptatie:

• verandert de partnerstatus naar Active,
• kan de partner volledig gebruikmaken van het programma,
• kan de affiliatecoupon worden geactiveerd,
• kan de klant een bericht ontvangen over de goedkeuring van deelname.

4.3. Affiliatelink

Elke affiliate krijgt een eigen affiliatelink op basis van referral_code. De link werkt via een trackingcontroller en slaat de attributie van het bezoek op. Na een klik kan het systeem:

• de affiliatie in een cookie opslaan,
• een bezoekrecord aanmaken,
• een attributierecord aanmaken,
• een latere bestelling koppelen aan een specifieke affiliate.

4.4. Affiliatecode en kortingscoupon

De module ondersteunt ook een model waarin referral_code kan werken als kortingscode in de winkelwagen.

De beheerder kan op het affiliateaccount het veld instellen:

• Affiliate Coupon Discount (%)

Als de waarde groter is dan nul, doet het systeem het volgende:

• synchroniseert de native Magento-regel Cart Price Rule,
• stelt de couponcode gelijk aan referral_code,
• berekent een procentuele korting in de winkelwagen,
• behandelt het gebruik van deze code als bron van de affiliate-attributie van de bestelling.

Daardoor kan de affiliate promoten:

• een gewone affiliatelink,
• alleen de kortingscode,
• een combinatie van beide mechanismen tegelijk.

Dit is een van de meest praktische verkoopfuncties van de module, omdat veel winkeleigenaren verwachten dat een partner niet alleen verkeer aanlevert, maar de klant ook een concreet prijsvoordeel biedt.

4.5. Bestellingsattributie

De module kan een bestelling toewijzen aan een affiliate op basis van:

• een klik op een affiliatelink,
• actieve attributie die is opgeslagen in de sessie of cookie,
• het gebruik van een affiliatecode in de winkelwagen,
• een ingelogde klant die is gekoppeld aan actieve attributie.

Op bestellingsniveau worden de volgende gegevens opgeslagen:

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

Dit maakt het mogelijk om de verkoopbron rechtstreeks op quote en sales_order te rapporteren.

4.6. Commissieberekening

De commissie wordt automatisch aangemaakt voor een affiliatebestelling. In het huidige model:

• wordt de commissie procentueel berekend over het subtotaal van de bestelling,
• komt het standaardtarief uit de configuratie van de module,
• voorkomt het systeem dubbele commissies voor dezelfde bestelling en affiliate,
• wordt het resultaat opgeslagen in de commissietabel en op de bestelling.

Ondersteunde commissiestatussen omvatten onder andere:

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

4.7. Hold period en automatische acceptatie

De module ondersteunt een wachttijd voor commissies. Dit betekent dat een commissie niet direct klaar hoeft te zijn voor uitbetaling. Zij kan gedurende een bepaalde periode de status in behandeling behouden en pas na afloop van de ingestelde periode automatisch door cron worden goedgekeurd.

Deze oplossing is vooral belangrijk bij:

• risico op retouren,
• handmatige verificatie van bestellingen,
• verkoopmodellen met uitgestelde afronding,
• de noodzaak om het programma te beschermen tegen misbruik.

4.8. Uitbetalingen voor affiliates

De partner kan een uitbetalingsverzoek indienen als de minimale drempel is gehaald en er voldoende goedgekeurd saldo beschikbaar is.

De payout-workflow omvat:

• het indienen van een payout request,
• het toewijzen van commissies aan de payout,
• het wijzigen van de commissiestatus naar ready_for_payout,
• het markeren van de uitbetaling als betaald,
• het wijzigen van de commissiestatussen naar paid.

Daardoor kan de winkeleigenaar uitbetalingen op een geordende en auditeerbare manier uitvoeren.

4.9. Fraud prevention

De module heeft een basislaag voor antifraude die helpt de meest voor de hand liggende vormen van misbruik te elimineren.

Dit omvat onder andere:

• het blokkeren van self-referral,
• het markeren van commissies als afgewezen wanneer misbruik wordt gedetecteerd,
• de verwerking van fraudecases,
• een register van afwijzingsredenen,
• een aparte weergave van fraud cases aan de beheerderszijde.

Daarnaast ondersteunt de module:

• annuleringen van bestellingen,
• chargebacks,
• refunds via creditmemo,
• wijziging van commissiestatussen na retouren.

4.10. Meldingen

De module heeft een eigen systeem voor het in de wachtrij plaatsen en verwerken van meldingen. Zij kan operationele gebeurtenissen opslaan en e-mailberichten verzenden.

Ondersteunde gevallen zijn onder andere:

• nieuwe affiliateaanmelding,
• bevestiging van ontvangst van de aanmelding,
• acceptatie van de affiliate,
• commissiegebeurtenissen,
• payouts,
• fraud alerts.

4.11. Affiliatepaneel

De partner gebruikt een uitgebreid dashboard in het Magento-klantaccount. Het dashboard is niet alleen een lijst met commissies, maar een volledig operationeel paneel.

In het affiliatepaneel zijn beschikbaar:

• de deelnamestatus aan het programma,
• de referralcode,
• de volledige affiliatelink,
• het standaard doelpad,
• een commissieoverzicht,
• de commissiegeschiedenis,
• doorgang naar payouts,
• inhoud met samenwerkingsregels,
• kant-en-klare promotiesnippets,
• bannerpreview,
• AI-bannergenerator.

4.12. AI-bannergenerator

De module bevat een door AI ondersteunde functie waarmee de affiliate op basis van een briefing een kant-en-klare promotiebanner kan voorbereiden.

De gebruiker kan opgeven:

• een tekstuele briefing,
• een visuele richting,
• kleuren,
• stijl,
• een optionele URL van een afbeelding,
• een optionele target link.

Het systeem geeft aan de AI-laag door:

• de briefing van de gebruiker,
• referral link,
• target path,
• technische eisen voor het antwoordformaat.

De gegenereerde HTML van de banner kan worden opgeslagen op het affiliateaccount en door de partner worden gebruikt als kant-en-klaar promotiemateriaal.

4.13. Rapportage

De module ondersteunt rapporten en CSV-exports voor de belangrijkste onderdelen van het programma:

• commissies,
• payouts,
• fraud cases,
• AI-insights.

Dit vereenvoudigt zowel de dagelijkse werking van het programma als de analyse van de effectiviteit van partners.

5. Beheerpaneel

De module breidt het Magento-beheerpaneel uit met configuratie en beheer van het affiliateprogramma.

De beheerder heeft toegang tot:

• globale programma-instellingen,
• commissie-instellingen,
• payout-instellingen,
• instellingen van het affiliateportaal,
• meldingsinstellingen,
• fraude-instellingen,
• AI-instellingen,
• rapportage-instellingen.

Daarnaast zijn in het paneel operationele secties beschikbaar:

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

In de klantenlijst en bij het bewerken van een klant zijn affiliategegevens zichtbaar, zoals:

• deelname aan het programma,
• affiliatestatus,
• affiliatesaldo,
• referralcode,
• kortingspercentage van de affiliatecoupon.

6. Hoe affiliatie in de praktijk werkt

6.1. Scenario met affiliatelink

1. De partner ontvangt zijn link.
2. De klant klikt op de link en komt in de webshop terecht.
3. Het systeem slaat het bezoek en de attributie op.
4. De klant plaatst een bestelling.
5. De bestelling wordt toegewezen aan de affiliate.
6. Er wordt een commissie aangemaakt.
7. Na afloop van de hold period kan de commissie worden goedgekeurd.
8. Na het voldoen aan de voorwaarden kan de partner een uitbetalingsverzoek indienen.

6.2. Scenario met affiliatecode in de winkelwagen

1. De partner publiceert zijn affiliatecode.
2. De klant voert de code in de winkelwagen in.
3. Magento berekent de korting op basis van de winkelwagenregel.
4. De module herkent de code als affiliatecode.
5. De bestelling wordt toegewezen aan de affiliate.
6. De commissie wordt aangemaakt volgens de programmaregels.

6.3. Hybride scenario

De klant kan eerst via een affiliatelink naar de webshop gaan en daarna de kortingscode van de affiliate gebruiken. Dit model maakt het mogelijk om klassieke tracking te combineren met voordelen voor de eindklant.

7. Veiligheidsgebieden

De module is voorbereid met productie-implementatie in gedachten en houdt daarom rekening met:

• auditregistraties,
• verwerking van retouren en annuleringen,
• blokkering van self-referral,
• meldingenwachtrij,
• mechanismen die dubbele commissies beperken,
• veilige opslag van AI-configuratie,
• beperking van gegevens die naar de AI-laag worden verzonden,
• mogelijkheid tot diagnose van integratiefouten.

8. Integratie met AI

De AI-laag in de module is optioneel en blokkeert de werking van het basisaffiliateprogramma niet. Deze kan worden gebruikt voor:

• affiliateassistent,
• het genereren van insights,
• het genereren van banners,
• retrieval van productkennis via vector_store_id.

De module hoeft geen eigen productdatabase voor AI te onderhouden als de webshop al gebruikmaakt van een externe module die productkennis en Vector Store beheert.

9. Verkooptoepassingen

De module kan worden verkocht als oplossing voor meerdere soorten projecten:

• B2C-webshops met een referralprogramma,
• premium webshops die een netwerk van merkambassadeurs willen opbouwen,
• B2B-bedrijven met een programma voor handelspartners,
• digitale en softwarewebshops,
• bureau-implementaties waarbij de klant een volledig partnerprogramma nodig heeft zonder externe SaaS.

Bijzonder sterke verkoopargumenten zijn:

• volledige controle over gegevens,
• geen abonnement op een extern affiliateplatform,
• integratie met Magento 2 zonder tussenpersonen,
• ondersteuning voor affiliatelinks en affiliatecoupons,
• kant-en-klaar partnerpaneel,
• mogelijkheid tot verdere uitbreiding met AI.

10. Belangrijkste voordelen van de module

De belangrijkste voordelen van deze oplossing zijn:

• werkt rechtstreeks in Magento 2,
• ondersteunt zowel links als affiliatecodes,
• verwerkt kortingscoupons die aan een affiliate zijn gekoppeld,
• maakt partnerbeheer mogelijk vanuit het Magento-klantniveau,
• heeft een echte workflow voor commissies en payouts,
• bevat basisbeveiliging en audit,
• heeft een modern affiliatiedashboard,
• is klaar voor verdere ontwikkeling met extra enterprise-functies.

11. Systeemvereisten

De module is bedoeld voor:

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

Vereist compatibele Magento-modules gerelateerd aan:

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

12. Implementatiebereik

De module kan gefaseerd worden geïmplementeerd:

• start met affiliatelinks en commissies,
• uitbreiding met payouts,
• uitbreiding met affiliatecoupons,
• uitbreiding met AI en content voor affiliates,
• verdere uitbreiding met geavanceerdere commissieregels en fraud scoring.

Dit betekent dat de module geschikt is voor zowel MVP-implementaties als voor langetermijnontwikkeling van het partnerprogramma.

13. Samenvatting

Kowal_Affiliate is een volwassen affiliatiemodule voor Magento 2 waarmee u binnen uw eigen webshop een compleet partnerprogramma kunt verkopen en starten. De module combineert klassieke affiliatelinks, referralcodes, kortingscoupons, commissies, payouts, basis fraud prevention, rapportage en een modern partnerpaneel.

Vanuit verkoopoogpunt is dit niet alleen een toevoeging voor referrallinks, maar een volledige partnerlaag voor Magento 2 die kan worden aangeboden als:

• standalone module,
• onderdeel van een webshopimplementatie,
• deel van een growth- / performancepakket,
• basis voor een geavanceerder partner- en merkambassadeursprogramma.

In de praktijk is dit een oplossing die inspeelt op echte behoeften van webshops die vragen naar:

• een affiliateprogramma in Magento 2,
• kortingscodes voor partners,
• afrekening van commissies,
• partnerpaneel,
• gereedheid voor verkoop en productiegebruik.