MAGENTO 2 · PARTNERS · COMMISSIES · LINKS EN COUPONS

Kowal Affiliate

Combineer partnerregistratie, orderattributie en afrekeningen met een affiliatepaneel. Beheer links, kortingscodes en commissiehistorie, en gebruik optionele AI ter ondersteuning van partners en promotiemateriaal.

Partnerlink en -code · Commissies en saldo · Uitbetalingsworkflow

HOE HET IN DE PRAKTIJK WERKT

De module breidt Magento 2 uit met een compleet affiliatesysteem dat direct binnen de webshop werkt. Dit betekent dat de webshopeigenaar partners, commissies, afrekeningen en promotiemateriaal beheert vanuit het eigen beheerderspaneel, 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 webshopklanten, bureaus, implementatiepartners en makers.

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

De module geeft de webshopeigenaar:

• een nieuw verkoopkanaal,
• controle over de samenwerkingsregels,
• transparant beheer van commissies en uitbetalingen,
• duidelijke rapporten over affiliateprestaties,
• de mogelijkheid om na validatie van de implementatie een programma voor een middelgrote of grote webshop voor te bereiden.

De partner krijgt:

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

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

De module komt vooral goed tot zijn recht in projecten waar het affiliateprogramma wordt uitgevoerd door:

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

De module biedt een aanmeldformulier voor het affiliateprogramma. De klant kan zelfstandig deelname aan het programma aanvragen 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 aanmeldstatus ingesteld op Pending,
• kan de beheerder een melding ontvangen over de nieuwe aanmelding,
• kan de klant een bevestiging van ontvangst van de aanmelding ontvangen.

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

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

Elke affiliate ontvangt 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 affiliate-attributie in een cookie opslaan,
• een bezoekrecord aanmaken,
• een attributierecord aanmaken,
• een latere order koppelen aan een specifieke affiliate.

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

De beheerder kan in het affiliateaccount het volgende 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 orderattributie.

Daardoor kan de affiliate promotie maken met:

• 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 webshopeigenaren verwachten dat een partner niet alleen verkeer doorstuurt, maar de klant ook een concreet prijsvoordeel biedt.

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

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

Op orderniveau worden de volgende gegevens opgeslagen:

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

Zo kan de verkoopbron direct op quote en sales_order worden gerapporteerd.

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

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

Ondersteunde commissiestatussen zijn onder andere:

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

De module ondersteunt een wachttijd voor commissies. Dit betekent dat een commissie niet direct klaar hoeft te zijn voor uitbetaling. Ze 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 ordercontrole,
• verkoopmodellen met vertraagde afronding,
• de noodzaak om het programma tegen misbruik te beschermen.

De partner kan een uitbetalingsaanvraag indienen als aan de minimumdrempel is voldaan en er voldoende goedgekeurd saldo beschikbaar is.

De payoutworkflow 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 commissiestatussen naar paid.

Zo kan de webshopeigenaar uitbetalingen op een gestructureerde en controleerbare manier afhandelen.

De module heeft een basislaag voor fraudepreventie 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,
• ondersteuning voor fraud cases,
• registratie van afwijsredenen,
• een aparte weergave van fraud cases aan beheerderszijde.

Daarnaast ondersteunt de module:

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

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

Ondersteunde scenario's zijn onder andere:

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

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 referral code,
• de volledige affiliatelink,
• het standaard targetpad,
• een commissieoverzicht,
• commissiehistorie,
• toegang tot payouts,
• inhoud met samenwerkingsregels,
• kant-en-klare promotiesnippets,
• bannerpreview,
• AI-bannergenerator.

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

De gebruiker kan opgeven:

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

Het systeem geeft aan de AI-laag door:

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

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

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

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

Dit vereenvoudigt zowel het dagelijkse beheer van het programma als de analyse van partnerprestaties.

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

De beheerder heeft toegang tot:

• algemene programma-instellingen,
• commissie-instellingen,
• payoutinstellingen,
• 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,
• referral code,
• kortingspercentage van de affiliatecoupon.

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 order.
5. De order wordt toegewezen aan de affiliate.
6. Er wordt een commissie aangemaakt.
7. Na afloop van de hold period kan de commissie worden goedgekeurd.
8. Als aan de voorwaarden is voldaan, kan de partner een uitbetalingsaanvraag indienen.

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 order wordt toegewezen aan de affiliate.
6. Er wordt een commissie aangemaakt volgens de programmaregels.

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

De module is voorbereid met het oog op productie-implementatie en houdt daarom rekening met:

• auditrecords,
• ondersteuning voor retouren en annuleringen,
• blokkeren van self-referral,
• meldingenwachtrij,
• mechanismen die dubbele commissies beperken,
• veilige opslag van AI-configuratie,
• beperking van data die naar de AI-laag wordt verzonden,
• mogelijkheid om integratiefouten te diagnosticeren.

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

• een 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 voor productkennisbeheer en Vector Store.

De module kan worden verkocht als oplossing voor meerdere projecttypen:

• 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 data,
• geen abonnement op een extern affiliateplatform,
• integratie met Magento 2 zonder tussenpersonen,
• ondersteuning voor affiliatelinks en -coupons,
• kant-en-klaar partnerpaneel,
• mogelijkheid om verder uit te breiden met AI.

De belangrijkste voordelen van deze oplossing zijn:

• werkt direct in Magento 2,
• ondersteunt zowel links als affiliatecodes,
• ondersteunt kortingscoupons die aan een affiliate zijn gekoppeld,
• maakt partnerbeheer mogelijk vanuit de Magento-klant,
• heeft een echte workflow voor commissies en payouts,
• bevat basisbeveiliging en audit,
• heeft een modern affiliatedashboard,
• is klaar om verder te worden ontwikkeld met extra enterprise-functies.

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.

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 de langetermijnontwikkeling van een partnerprogramma.

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

Vanuit verkoopoogpunt is dit niet alleen een toevoeging voor referral links, 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 de reële behoeften van webshops die vragen naar:

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

De commissie is gebaseerd op het subtotaal van de order. Het tarief van het affiliateaccount heeft voorrang op het standaardtarief van het programma. De kortingswaarde van de partnercoupon en het commissiepercentage zijn afzonderlijke instellingen.

De standaardconfiguratie voorziet in een cookie van 30 dagen, commissie van 10%, hold period van 14 dagen en een uitbetalingsdrempel van 100. Bepaal vóór de start uw eigen regels, valuta en manier om retouren af te handelen.

Het ledger registreert wijzigingen in het partnersaldo. Naast de uitbetalingsworkflow biedt de module de optie om saldo als waardekorting in de winkelwagen te gebruiken, met limieten voor het bedrag, regels voor gedeeltelijk gebruik en combinatie met coupons.

De standaardmodus is payout_only. Een uitbetalingsaanvraag reserveert de betreffende commissies; de markering paid bevestigt de workflowfase, maar voert zelf geen bankoverschrijving of betaling via een payment provider uit.

Stores → Configuration → Affiliate Program omvat instellingen voor programma, commissies, payouts, settlement, portaal, meldingen, fraude, AI en rapporten. De installatie kan de CMS-pagina affiliate-program toevoegen zonder een bestaande pagina met die identifier te overschrijven.

AI is standaard uitgeschakeld. De assistent, HTML-banners en wekelijkse insights vereisen de juiste configuratie; productkennis maakt gebruik van de bestaande Vector Store en de module synchroniseert deze niet zelfstandig.

Pakket kowal/module-affiliate, module Kowal_Affiliate. Nadat toegang tot de Kowal-repository is geconfigureerd, installeert u het pakket, schakelt u de module in, werkt u Magento bij en wist u de cache. Houd in productie rekening met compilatie en deployment van statische content volgens het proces van de webshop.

1. U neemt een partner aan
De aanmelding gaat ter goedkeuring door en ontvangt een referral code.

2. U wijst verkoop toe
Een link of coupon koppelt de order aan de affiliate.

3. U rekent het resultaat af
Commissies doorlopen een wachttijd en de uitbetalingsafhandeling.

De partner deelt een link en zijn coupon. De klant ontvangt de geconfigureerde korting en de order wordt toegewezen aan de partner.

Na controle en de hold period kan het goedgekeurde saldo in aanmerking komen voor een uitbetalingsaanvraag. De daadwerkelijke overboeking organiseert u binnen het afrekenproces van uw bedrijf.