MAGENTO 2 · PARTNER · COMMISSIONI · LINK E COUPON

Kowal Affiliate

Unisci registrazione dei partner, attribuzione degli ordini e rendicontazione con il pannello dell'affiliato. Gestisci link, codici sconto e storico delle commissioni, e usa l'AI opzionale per supportare i partner e i materiali promozionali.

Link e codice partner · Commissioni e saldo · Workflow dei pagamenti

COME FUNZIONA IN PRATICA

Il modulo estende Magento 2 con un sistema di affiliazione completo che funziona direttamente all'interno dello store. Questo significa che il titolare dello store gestisce partner, commissioni, rendicontazioni e materiali promozionali dal proprio pannello di amministrazione, mentre i partner utilizzano una dashboard dedicata nell'account cliente.

In pratica, il modulo consente di implementare contemporaneamente diversi modelli di collaborazione:

• programma di affiliazione classico basato su link di tracciamento,
• programma referral basato su codici partner individuali,
• modello ibrido: link di affiliazione più codice sconto,
• programma partner per clienti dello store, agenzie, implementatori e creator.

Il valore più importante del modulo è l'unione di vendita, attribuzione, rendicontazione e gestione dei partner in un unico luogo. Lo store non deve mantenere un sistema di affiliazione esterno, esportare manualmente gli ordini né rendicontare i partner in fogli di calcolo.

Il modulo offre al titolare dello store:

• un nuovo canale di vendita,
• controllo sulle regole di collaborazione,
• gestione trasparente di commissioni e pagamenti,
• report chiari sull'efficacia degli affiliati,
• possibilità di preparare un programma per store di media e grande scala dopo la validazione dell'implementazione.

Il partner riceve:

• il proprio codice referral,
• il proprio link di affiliazione,
• un pannello pronto per monitorare le attività,
• visibilità su commissioni e payout,
• possibilità di utilizzare materiali promozionali e banner.

Il modulo è adatto agli store che vogliono costruire una rete di partner commerciali senza utilizzare piattaforme di affiliazione esterne oppure che vogliono mantenere il pieno controllo sui dati e sul processo di rendicontazione.

Funziona particolarmente bene nei progetti in cui il programma di affiliazione deve essere gestito da:

• clienti che consigliano lo store ad amici e conoscenti,
• creator online,
• blogger ed editori,
• specialisti e consulenti,
• partner di implementazione,
• software house e agenzie,
• reseller e commerciali B2B,
• ambassador del brand e community.

Il modulo mette a disposizione un modulo di candidatura al programma di affiliazione. Il cliente può candidarsi autonomamente al programma indicando i dati di contatto di base, l'indirizzo del sito o del canale e una breve informazione sulla promozione prevista.

Dopo l'invio del modulo:

• viene creato un account affiliato,
• viene generato un referral_code univoco,
• lo stato della richiesta viene impostato su Pending,
• l'amministratore può ricevere una notifica sulla nuova richiesta,
• il cliente può ricevere una conferma di ricezione della richiesta.

L'amministratore può approvare l'affiliato dal pannello Magento. Dopo l'approvazione:

• lo stato del partner cambia in Active,
• il partner può utilizzare pienamente il programma,
• è possibile attivare il coupon di affiliazione,
• il cliente può ricevere un messaggio di approvazione della partecipazione.

Ogni affiliato riceve il proprio link di affiliazione basato su referral_code. Il link funziona tramite un controller di tracciamento e salva l'attribuzione della visita. Dopo il clic, il sistema può:

• salvare l'affiliazione in un cookie,
• creare una voce di visita,
• creare una voce di attribuzione,
• collegare un ordine successivo a un affiliato specifico.

Il modulo supporta anche un modello in cui referral_code può funzionare come codice sconto nel carrello.

L'amministratore può impostare nell'account dell'affiliato il campo:

• Affiliate Coupon Discount (%)

Se il valore è maggiore di zero, il sistema:

• sincronizza la regola nativa Cart Price Rule di Magento,
• imposta il codice coupon uguale a referral_code,
• applica uno sconto percentuale nel carrello,
• considera l'uso di questo codice come fonte di affiliazione dell'ordine.

In questo modo l'affiliato può promuovere:

• un normale link di affiliazione,
• solo il codice sconto,
• la combinazione di entrambi i meccanismi contemporaneamente.

Questa è una delle funzionalità commerciali più pratiche del modulo, perché molti titolari di store si aspettano che il partner non solo generi traffico, ma offra anche al cliente un vantaggio economico concreto.

Il modulo è in grado di attribuire un ordine a un affiliato in base a:

• clic sul link di affiliazione,
• attribuzione attiva salvata nella sessione o nel cookie,
• uso del codice di affiliazione nel carrello,
• cliente autenticato collegato a un'attribuzione attiva.

A livello di ordine vengono salvati i dati:

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

Questo consente di riportare la fonte della vendita direttamente su quote e sales_order.

La commissione viene creata automaticamente per l'ordine di affiliazione. Nel modello attuale:

• la commissione viene calcolata in percentuale sul subtotale dell'ordine,
• la tariffa predefinita proviene dalla configurazione del modulo,
• il sistema evita la duplicazione delle commissioni per lo stesso ordine e affiliato,
• il risultato viene salvato nella tabella delle commissioni e sull'ordine.

Gli stati delle commissioni supportati includono, tra gli altri:

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

Il modulo supporta un periodo di sospensione della commissione. Questo significa che la commissione non deve essere subito pronta per il pagamento. Può rimanere per un determinato periodo nello stato in attesa e solo dopo il periodo stabilito essere approvata automaticamente tramite cron.

Questa soluzione è particolarmente importante in caso di:

• rischio di resi,
• verifica manuale degli ordini,
• modelli di vendita con finalizzazione differita,
• necessità di proteggere il programma dagli abusi.

Il partner può presentare una richiesta di pagamento se la soglia minima è stata raggiunta e dispone di un saldo approvato sufficiente.

Il workflow dei payout include:

• invio della payout request,
• assegnazione delle commissioni al payout,
• modifica dello stato della commissione in ready_for_payout,
• marcatura del pagamento come pagato,
• modifica degli stati delle commissioni in paid.

In questo modo il titolare dello store può gestire i pagamenti in modo ordinato e verificabile.

Il modulo dispone di un livello antifrode di base che aiuta a eliminare gli abusi più evidenti.

Include, tra l'altro:

• blocco del self-referral,
• marcatura delle commissioni come respinte quando viene rilevato un abuso,
• gestione dei casi fraudolenti,
• registro dei motivi di rifiuto,
• vista separata dei fraud case lato amministratore.

Inoltre, il modulo gestisce:

• annullamenti degli ordini,
• chargeback,
• refund tramite creditmemo,
• modifica degli stati delle commissioni dopo i resi.

Il modulo ha un proprio sistema di accodamento ed elaborazione delle notifiche. Può salvare eventi operativi e inviare messaggi e-mail.

I casi supportati includono, tra gli altri:

• nuova richiesta di affiliazione,
• conferma di ricezione della richiesta,
• approvazione dell'affiliato,
• eventi relativi alle commissioni,
• payout,
• fraud alerts.

Il partner utilizza una dashboard avanzata nell'account cliente Magento. La dashboard non è solo un elenco di commissioni, ma un pannello operativo completo.

Nel pannello dell'affiliato sono disponibili:

• stato di partecipazione al programma,
• codice referral,
• link di affiliazione completo,
• percorso target predefinito,
• riepilogo delle commissioni,
• storico delle commissioni,
• accesso ai payout,
• contenuti delle regole di collaborazione,
• snippet promozionali pronti,
• anteprima del banner,
• generatore di banner AI.

Il modulo include una funzione assistita da AI che consente all'affiliato di preparare un banner promozionale pronto sulla base di un brief.

L'utente può fornire:

• brief testuale,
• direzione visiva,
• colori,
• stile,
• URL opzionale della grafica,
• target link opzionale.

Il sistema trasmette al livello AI:

• brief dell'utente,
• referral link,
• target path,
• requisiti tecnici relativi al formato della risposta.

L'HTML del banner generato può essere salvato nell'account dell'affiliato e utilizzato dal partner come materiale promozionale pronto.

Il modulo supporta report ed esportazioni CSV per le aree chiave del programma:

• commissioni,
• payout,
• fraud case,
• insight AI.

Questo semplifica sia la gestione quotidiana del programma sia l'analisi dell'efficacia dei partner.

Il modulo estende il pannello di amministrazione Magento con la configurazione e la gestione del programma di affiliazione.

L'amministratore ha accesso a:

• impostazioni globali del programma,
• impostazioni delle commissioni,
• impostazioni dei payout,
• impostazioni del portale affiliato,
• impostazioni delle notifiche,
• impostazioni antifrode,
• impostazioni AI,
• impostazioni di reportistica.

Inoltre, nel pannello sono disponibili sezioni operative:

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

Nella lista clienti e nella modifica del cliente sono visibili dati di affiliazione, come:

• partecipazione al programma,
• stato dell'affiliato,
• saldo dell'affiliato,
• codice referral,
• percentuale di sconto del coupon di affiliazione.

1. Il partner riceve il proprio link.
2. Il cliente clicca il link e arriva nello store.
3. Il sistema salva visita e attribuzione.
4. Il cliente effettua un ordine.
5. L'ordine viene attribuito all'affiliato.
6. Viene creata una commissione.
7. Dopo il hold period, la commissione può essere approvata.
8. Dopo il soddisfacimento delle condizioni, il partner può presentare una richiesta di pagamento.

1. Il partner pubblica il proprio codice di affiliazione.
2. Il cliente inserisce il codice nel carrello.
3. Magento applica lo sconto dalla regola carrello.
4. Il modulo riconosce il codice come codice dell'affiliato.
5. L'ordine viene attribuito all'affiliato.
6. Viene creata una commissione secondo le regole del programma.

Il cliente può prima entrare nello store tramite un link di affiliazione e poi usare il codice sconto dell'affiliato. Questo modello consente di combinare il tracking classico con benefit per il cliente finale.

Il modulo è stato preparato pensando a un'implementazione in produzione, per questo include:

• registri di audit,
• gestione di resi e annullamenti,
• blocco del self-referral,
• coda delle notifiche,
• meccanismi che limitano la duplicazione delle commissioni,
• archiviazione sicura della configurazione AI,
• limitazione dei dati inviati al livello AI,
• possibilità di diagnostica degli errori di integrazione.

Il livello AI nel modulo è opzionale e non blocca il funzionamento del programma di affiliazione di base. Può essere utilizzato per:

• assistente dell'affiliato,
• generazione di insight,
• generazione di banner,
• retrieval della conoscenza prodotto tramite vector_store_id.

Il modulo non deve mantenere un proprio database prodotti per AI se lo store utilizza già un modulo esterno per la gestione della conoscenza prodotto e del Vector Store.

Il modulo può essere venduto come soluzione per diversi tipi di progetti:

• store B2C con programma referral,
• store premium che vogliono costruire una rete di ambassador del brand,
• business B2B con programma per partner commerciali,
• store digitali e software,
• implementazioni di agenzia in cui il cliente ha bisogno di un programma partner completo senza SaaS esterno.

Argomenti commerciali particolarmente forti sono:

• pieno controllo sui dati,
• assenza di abbonamento a una piattaforma di affiliazione esterna,
• integrazione con Magento 2 senza intermediari,
• supporto di link e coupon di affiliazione,
• pannello partner pronto,
• possibilità di ulteriore estensione con AI.

I principali vantaggi di questa soluzione sono:

• funziona direttamente in Magento 2,
• supporta sia link sia codici di affiliazione,
• gestisce coupon sconto collegati all'affiliato,
• consente di gestire i partner dal livello del cliente Magento,
• dispone di un vero workflow di commissioni e payout,
• include sicurezza e audit di base,
• offre una dashboard affiliato moderna,
• è pronto per lo sviluppo di ulteriori funzionalità enterprise.

Il modulo è destinato a:

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

Richiede moduli Magento compatibili legati a:

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

Il modulo può essere implementato per fasi:

• partenza da link di affiliazione e commissioni,
• estensione con payout,
• estensione con coupon di affiliazione,
• estensione con AI e contenuti per affiliati,
• ulteriore sviluppo con regole di commissione più avanzate e fraud scoring.

Questo significa che è adatto sia a implementazioni MVP sia allo sviluppo a lungo termine di un programma partner.

Kowal_Affiliate è un modulo di affiliazione avanzato per Magento 2 che consente di vendere e avviare un programma partner completo all'interno del proprio store. Unisce link di affiliazione classici, codici referral, coupon sconto, commissioni, payout, fraud prevention di base, reportistica e un pannello partner moderno.

Dal punto di vista commerciale, non è solo un componente aggiuntivo per link referral, ma un livello partner completo per Magento 2 che può essere offerto come:

• modulo standalone,
• elemento di implementazione dello store,
• parte di un pacchetto growth / performance,
• base per un programma partner e ambassador del brand più avanzato.

In pratica, è una soluzione che risponde alle esigenze reali degli store che cercano:

• programma di affiliazione in Magento 2,
• codici sconto per partner,
• rendicontazione delle commissioni,
• pannello partner,
• prontezza per la vendita e il lavoro in produzione.

La commissione si basa sul subtotale dell'ordine. La tariffa dell'account affiliato ha precedenza rispetto alla tariffa predefinita del programma. Il valore dello sconto del coupon del partner e la percentuale della sua commissione sono impostazioni separate.

La configurazione predefinita prevede cookie per 30 giorni, commissione del 10%, hold period di 14 giorni e soglia di pagamento pari a 100. Prima dell'avvio, definisci le tue regole, la valuta e il metodo di gestione dei resi.

Il ledger registra le variazioni del saldo del partner. Oltre al workflow dei pagamenti, il modulo offre l'opzione di usare il saldo come sconto di valore nel carrello, con limiti di importo, regole di utilizzo parziale e combinazione con i coupon.

La modalità predefinita è payout_only. La richiesta di pagamento riserva le relative commissioni; la marcatura paid conferma la fase del workflow, ma da sola non esegue un bonifico tramite banca né operatore di pagamento.

Stores → Configuration → Affiliate Program include impostazioni di programma, commissioni, payout, settlement, portale, notifiche, frodi, AI e report. L'installazione può aggiungere la pagina CMS affiliate-program senza sovrascrivere una pagina esistente con lo stesso identificatore.

AI è disattivata per impostazione predefinita. Assistente, banner HTML e insight settimanali richiedono una configurazione adeguata; la conoscenza prodotto utilizza il Vector Store esistente e il modulo non lo sincronizza autonomamente.

Pacchetto kowal/module-affiliate, modulo Kowal_Affiliate. Dopo aver configurato l'accesso al repository Kowal, installa il pacchetto, abilita il modulo, aggiorna Magento e svuota la cache. In produzione, includi la compilazione e il deployment dei contenuti statici secondo il processo dello store.

1. Accetti il partner
La richiesta passa all'approvazione e riceve un codice referral.

2. Attribuisci la vendita
Il link o il coupon collega l'ordine all'affiliato.

3. Rendiconti il risultato
Le commissioni passano attraverso il periodo di attesa e la gestione del pagamento.

Il partner condivide il link e il proprio coupon. Il cliente riceve lo sconto configurato e l'ordine viene attribuito al partner.

Dopo il controllo e il periodo hold, il saldo approvato può qualificarsi per una richiesta di pagamento. Il trasferimento effettivo dei fondi viene organizzato nel processo di rendicontazione dell'azienda.