PayPal 
Przelew The module extends Magento 2 with a complete affiliate system that runs directly inside the store. This means the store owner manages partners, commissions, settlements, and promotional materials from the store's own admin panel, while partners use their own dashboard in the customer account.
In practice, the module lets you implement several collaboration models at the same time:
The module's greatest value is combining sales, attribution, settlements, and partner management in one place. The store does not need to maintain an external affiliate system, manually export orders, or settle partner commissions in spreadsheets.
The module gives the store owner:
The partner receives:
The module is suitable for stores that want to build a network of sales partners without using external affiliate platforms, or that want to maintain full control over data and the settlement process.
It works especially well in projects where the affiliate program is intended for:
The module provides an application form for the affiliate program. A customer can apply to join the program independently by providing basic contact details, the website or channel address, and a short description of the planned promotion.
After the form is submitted:
WhatsApp
+48608012047
referral_code is generated,Pending,The administrator can approve an affiliate from the Magento panel. After approval:
Active,Each affiliate receives their own affiliate link based on referral_code. The link works through a tracking controller and records visit attribution. After a click, the system can:
The module also supports a model in which referral_code can work as a discount code in the cart.
The administrator can set the following field on the affiliate account:
Affiliate Coupon Discount (%)If the value is greater than zero, the system:
Cart Price Rule,referral_code,As a result, the affiliate can promote:
This is one of the module's most practical sales features, because many store owners expect a partner not only to drive traffic but also to give the customer a specific price benefit.
The module can assign an order to an affiliate based on:
The following data is saved at the order level:
affiliate_id,affiliate_attribution_id,affiliate_referral_code,is_affiliate_order,affiliate_commission_amount,affiliate_commission_status.This makes it possible to report the sales source directly on quote and sales_order.
A commission is created automatically for an affiliate order. In the current model:
Supported commission statuses include, among others:
pending,approved,ready_for_payout,paid,rejected,cancelled,charged_back.The module supports a commission hold period. This means the commission does not have to be ready for payout immediately. It can remain in pending status for a defined time and only be automatically approved by cron after the specified period has passed.
This solution is especially important for:
A partner can submit a payout request if the minimum threshold has been met and the partner has a sufficient approved balance.
The payout workflow includes:
ready_for_payout,paid.This allows the store owner to manage payouts in an organized and auditable way.
The module includes a basic anti-fraud layer that helps eliminate the most obvious abuse.
This includes, among other things:
In addition, the module supports:
creditmemo,The module has its own notification queuing and processing system. It can record operational events and send email messages.
Supported cases include, among others:
The partner uses an advanced dashboard in the Magento customer account. The dashboard is not just a list of commissions, but a complete operational panel.
The affiliate panel includes:
The module includes an AI-assisted feature that lets the affiliate prepare a ready-to-use promotional banner based on a brief.
The user can provide:
The system passes the following to the AI layer:
The generated banner HTML can be saved on the affiliate account and used by the partner as ready-made promotional material.
The module supports reports and CSV exports for key program areas:
This makes both day-to-day program management and partner performance analysis easier.
The module extends the Magento admin panel with affiliate program configuration and management.
The administrator has access to:
In addition, the panel includes operational sections:
Affiliate Commissions,Affiliate Payouts,Affiliate Fraud Cases,Affiliate Reports.Affiliate data is visible on the customer list and in customer edit view, such as:
The customer can first enter the store through an affiliate link and then use the affiliate's discount code. This model allows classic tracking to be combined with benefits for the end customer.
The module has been prepared with production deployment in mind, so it includes:
The AI layer in the module is optional and does not block the core affiliate program from working. It can be used for:
vector_store_id.The module does not need to maintain its own product database for AI if the store already uses an external module that manages product knowledge and Vector Store.
The module can be sold as a solution for several types of projects:
Especially strong sales arguments include:
The most important advantages of this solution are:
The module is intended for:
It requires compatible Magento modules related to:
Customer,Quote,Sales,SalesRule,Cms,Email,Backend,Store.The module can be implemented in stages:
This means it is suitable both for MVP implementations and for long-term development of a partner program.
Kowal_Affiliate is a mature affiliate module for Magento 2 that lets you sell and launch a complete partner program within your own store. It combines classic affiliate links, referral codes, discount coupons, commissions, payouts, basic fraud prevention, reporting, and a modern partner panel.
From a sales perspective, this is not just an add-on for referral links, but a complete partner layer for Magento 2 that can be offered as:
In practice, it is a solution that addresses the real needs of stores asking about:
This document describes how to install, activate, and perform the initial configuration of the Kowal_Affiliate module for Magento 2. The guide covers both technical requirements and the practical steps needed to launch an affiliate program in the store.
The module is intended for:
At minimum, the Magento project should include the following modules:
Magento_StoreMagento_CmsMagento_CustomerMagento_EmailMagento_QuoteMagento_SalesMagento_SalesRuleMagento_BackendThe module can be deployed in the standard way as a Composer package.
The module is distributed as a Composer package. An example process looks as follows:
composer require kowal/module-affiliatebin/magento module:enable Kowal_Affiliatebin/magento setup:upgradebin/magento setup:di:compilebin/magento cache:flushIf the store runs in production mode, after installation it is also worth running:
bin/magento setup:static-content:deployDuring installation, the module:
quote and sales_order with affiliate fields,After installation, an example partner program page is created:
identifier: affiliate-programtitle: Affiliate Partnership ProgramThe page is universal and can be used in production after minor content customization.
The patch is idempotent:
identifier already exists, the module will not overwrite it.The configuration panel is located at:
Stores -> Configuration -> Affiliate ProgramThe most important sections:
GeneralCommissionPayoutsAffiliate PortalNotificationsFraudAIReportingAfter activating the module, the following configuration order is recommended:
Global module switch.
If the setting is disabled:
Recommendation:
Yes in the production environment after testing is complete,No only while the program is disabled.Enables the affiliate program application form on the storefront.
If the option is disabled:
Defines the lifetime of cookie-based attribution after a click on an affiliate link.
Examples:
30 for a standard affiliate program,7 for short campaigns,60 or 90 only if the program terms allow it.Fallback path used when the tracking link does not contain a valid target.
Examples:
/promotionscatalog/category/view/id/12Enables commission calculation for affiliate orders.
If the field is disabled:
Default percentage commission rate.
Example:
10 means a 10% commission on the current calculation base.The number of days during which the commission remains in pending status.
After this period expires, cron can automatically approve the commission.
Recommendation:
14 as a safe default value,0 only for a very simple program with no return risk.Enables the payout workflow for affiliates.
If the option is disabled:
Minimum balance required to request a payout.
Examples:
100250500This section controls the content displayed in the affiliate dashboard.
A short description at the top of the affiliate dashboard.
It should explain to the partner:
Visible collaboration rules for the affiliate.
Best practice:
Default title of the sample promotional material.
Short description under the banner title.
Default target path for affiliate links and banners.
Examples:
/promotions/springcatalog/category/view/id/24Enables the internal notification system and notification queue.
The administrator email address that should receive the most important operational messages.
If the field is left empty:
general address as a fallback in selected flows.Defines how long notification log entries should be stored before cleanup.
Enables basic anti-fraud checks.
Blocks the commission when the customer placing the order is also the affiliate connected with that order.
The AI section is optional and is not required for the basic operation of the affiliate program.
Main switch for AI features.
API key for communication with OpenAI.
The field is stored in encrypted configuration.
The model used for AI features.
The list of models can be retrieved from OpenAI after the API key is saved correctly.
Maximum wait time for a response from OpenAI.
Practical recommendation:
60 seconds for more stable production operation.Enables diagnostic logging of AI requests and responses.
Useful for:
Maximum length of the logged payload preview.
Enables the affiliate assistant if the store wants to use this feature.
Allows cyclical AI summaries to be generated.
Allows product knowledge from Vector Store to be used.
Allows knowledge about the affiliate program, FAQ, and documentation to be used.
Defines how product_vector_store_id is resolved.
The Vector Store identifier if the store uses retrieval.
Removes or masks personal data before sending the prompt to the AI layer.
Enables report generation and CSV exports.
Directory path where generated exports should be saved.
Example:
var/export/affiliateAfter installation, the module extends Magento customer edit view with affiliate fields.
In customer edit view, you can manage, among other things:
Affiliate ParticipantAffiliate StatusAffiliate Referral CodeAffiliate Website URLAffiliate NotesAffiliate BalanceAffiliate Coupon Discount (%)Indicates whether the customer belongs to the affiliate program.
The most important statuses:
PendingActiveSuspendedRejectedBlockedThe balance is calculated automatically from approved commissions that are ready for payout.
The field:
This field lets you assign a discount percentage to an affiliate, which will work on their referral_code.
If you enter a value greater than 0, the module:
coupon_code.Example:
FMX1FBXXY35FMX1FBXXY3 as a discount couponThe module uses crons in the default group.
job: kowal_affiliate_auto_approve_commissionsschedule: */15 * * * *Task:
pending commissions,approved.job: kowal_affiliate_process_notificationsschedule: */10 * * * *Task:
job: kowal_affiliate_cleanup_notification_logschedule: 30 2 * * *Task:
job: kowal_affiliate_generate_weekly_ai_insightsschedule: 0 6 * * 1Task:
The module provides service commands:
bin/magento kowal:affiliate:auto-approvebin/magento kowal:affiliate:process-notificationsbin/magento kowal:affiliate:cleanup-notificationsbin/magento kowal:affiliate:generate-ai-insightsbin/magento kowal:affiliate:export-reportThe most useful commands during the initial launch are:
bin/magento kowal:affiliate:process-notificationsbin/magento kowal:affiliate:auto-approveAfter configuring the module, a simple end-to-end test is recommended.
Pending status.Active or use the approval action.affiliate_idaffiliate_referral_codeis_affiliate_order = 1Affiliate Coupon Discount (%) for the affiliate, for example 5.Active status.Referral Code as a coupon.Check:
affiliate_id,kowal_affiliate_commission table.Check:
customer_grid index has been refreshed,reindexRow works after saves,If needed, run:
bin/magento indexer:reindex customer_gridCheck:
Enable AI is enabled,OpenAI API Key has been saved,var/log does not show errors for the request to OpenAI.Check:
Enable Notifications is active,kowal_affiliate_notification_log,bin/magento kowal:affiliate:process-notificationsFor the first production implementation, the following set is recommended:
Enable Module = YesEnable Affiliate Registration = YesTracking Cookie Lifetime = 30Enable Commissions = YesDefault Commission Rate = 10Commission Hold Period = 14Enable Payouts = YesMinimum Payout Amount = 100Enable Notifications = YesBlock Self Referral = YesEnable AI = No at the start if the store does not need AI from day oneAfter proper installation and configuration, Kowal_Affiliate lets you launch a complete partner program in Magento 2, covering:
