Affiliate¶
Mageplaza Affiliate extension for Magento 2 is the greater choice than ever if you want to build an Affiliate program that is crazy enough to drive traffic and sales increase promptly, get qualified leads, and also enhance your brand awareness. Our Affiliate program allows you to pay affiliates amount of commissions.
Mageplaza Affiliate User Guide will provide the detailed instructions to know How to use on the frontend and How to Config on the backend.
How to Use¶
After installing Affiliate module, an Affiliate link is available on the footer of your site. Click on the link and go to Affiliate Home Page.
Affiliate Home Page¶
Affiliate Home Page is already setup with CMS Block including Welcome Message and How does Affiliate Program work? If you want to change the text, it is possible to edit from the backend. In addition, all of the active Affiliate Program will be displayed on the Affiliate Home Page.

Look at the left panel on the page, customers can sign up to become an affiliate.

My Credit Page¶
Each affiliate can manage every credit information such as available balance, holding balance, total earned, and total paid and all transactions related to the account are listed in detail.

Refer Friend Page¶
Affiliate module by Mageplaza allows affiliate refer friends via referral url, code and email.

Just insert friends’ email addresses together with message to send invitation instantly on Refer Friend page.
My Withdrawal Page¶

Mageplaza Affiliate supports offline payment and Paypal payment for the withdrawal. Each created withdrawal will be saved and managed in Withdraw History. Let follow its status to know where the request is in progress.
Refer History Page¶
Show the list of customers that the affiliate invited via Refer URL or Coupon Code.

How to Configure¶
From the Admin Panel, go to Stores > Configuration > Mageplaza Extensions > Affiliate > Configuration

1. Configuration¶


1.1. General¶
- Enable: Choose Yes to apply the feature of the module
- Cookie Expiration
- Enter the number of days to store cookies of this program.
- If skip it, the default (365) is used, that means Lifetime Commissions can be active.
- Allow overriding cookies: Choose Yes to override Affiliate code when a customer is referred by many Affiliates.
- Allow using Afiliate Code as Coupon: Select Yes to allow using Affiliate code for discount. This usgae is available in Shopping Cart Page and Checkout Page
- Enable Banner: If Yes, the banner will be shown on the My Affiliate page on the frontend. Show extra field:
- Show Report for Banner on Frontend: If Yes, will show the report of Impressions, Clicks of customers to each banner.

- Show Affiliate link on: Choose the display position of the Affiliate link
- Show Affiliate link on = Footer Link: Display the Affiliate link in the bottom of the page
- Show Affiliate link on = Top Link: Display the Affiliate link in the top of the page along with the link
- My Account
- You can choose to display in both positions
- If admin does not choose the position to display Affiliate link, the link only show on Frontend at My Account Page when customers login.
- Custom CSS
- Admin can freely customize the display of the Affiliate site
- Supports HTML, CSS
- Enable Referral History: Select Yes to show Refer History page in My Affiliate. Display information of customers invited using Refer URL or Coupon Code, including columns such as ID, Customer Name, Customer Email Address, Date.
- Enable Affiliate Referral Information: Select Yes to show Parent Affiliate customer information on the My Account page. Note that, the customer account has Sign Up Account Affiliate and the Affiliate account has been active.

1.1.1. Default Page¶

- Affiliate homepage content
- Select CMS Block for Affiliate homepage content
- The default display is: Affiliate Welcome homepage content
1.1.2. Affiliate URL¶

- URL Style: Choose the type to display URL
- URL Style = Hash: Display URL as http://example.com#c123
- URL Style = Parameter: Display URL as http://example.com/?c=123
- Custom parameter
- Enter the letter for the customization of Affiliate URL. Those parameters here will be inserted in front of the Refer code
- If this field is left blank, the default value is “u”.
For example: refer code is 123, Custom parameter is abc * Hash: http://example.com#abc123 * Parameter: http://example.com/?abc=123
- Parameter value
- Parameter value = Affiliate ID: Display the ID of Affiliate account on the Refer URL link in My Account/ My Affiliate/ Refer Friend outside the frontend. For example: ?u=1 or #u1
- Parameter value = Affiliate Code: Display the code of Affiliate account on the Refer URL link outside the frontend. For example: ?u=b1dc or #ub1dc and display the code of Affiliate account in the Refer Code field in My Account/ My Affiliate/ Refer Friend outside the frontend
- Length of Affiliate code
- Enter the length of Affiliate code
- The default length is 6 characters
- It is recommended to enter a length between 3 and 32 characters to ensure safety
1.2. Account Configuration¶

1.2.1. Affiliate Sign up¶

- Default Affiliate Group
- Choose the default group whenever an account is registered as an Affiliate account
- The original default group is General
- Require admin’s approval: Choose No so that when registering as an affiliate account, you don’t need to go through the censorship of the store
- Checked “Email notification” by default: Select Yes to automatically check the Receive affiliate email box on the My Account/My Affiliate/Setting tab outside the frontend whenever an account is registered as an Affiliate account.
1.2.2.Terms and Conditions¶

- Enable Terms and Conditions: Choose Yes to display Terms and Conditions in the Sign Up section which is outside the frontend
- Checkbox Text: Enter the checkbox text that is in the right of Terms and Conditions checkbox.
- Terms and Conditions Title: Enter the title for Terms and Conditions
- Terms and Conditions Content
- Select CMS Block for Terms and Conditions Content
- The default content is Affiliate terms & conditions
- Checkbox is checked by default: Choose Yes to tick in the checkbox automatically
1.2.3. Account Balance¶

- Maximum of Affiliate Balance
- Enter the Maximum of Affiliate Balance
- If Affiliate reach the milestone, none of commission is added
- If the field is left empty or entered as zero, Affiliate Balance will have no limitation
- Allow negative balance: If Affiliate’s account balance is not enough to take back commission, allow the balance to be negative number by choosing Yes in the respective field
1.3. Commission Configuration¶

- Earn commission from tax: Choose Yes to earn commission from tax
- Earn commission from Shipping: Choose Yes to earn commission from shipping fee
1.3.1. Commission calculation process¶
- Allow Affiliate receiving commission when Invoice created
- Allow Affiliate receiving commission when Invoice created = Yes: Commissions received when creating an invoice
- Allow Affiliate receiving commission when Invoice created = No: Commissions are only received when the order is in the completed state
- Hold commission transactions for
- Enter the days between commission transaction for accounts. After that period of time, the transaction will no longer be kept
- If the field is blank or entered as 0, the transaction will not be kept
- Deduct commission from Affiliate’s balance when the order is refunded/canceled
- Choose Yes to allow deducting the commission from the balance of the branch when the order is refunded or canceled
- The default allows deducting
1.4 Withdrawal Configuration¶

- Allow withdrawal request: Select Yes to display the withdrawal request outside the frontend
- Payment Methods
- There are three withdraw methods which are Offline payment, Bank Transfer and Paypal payment, Store Credit. Affiliate extension is completely compatible with Mageplaza Store Credit (v4.0.4 or above for M2.4 | v1.1.9 or above for M2.3 or below) to support withdrawal with the store credit payment.
- Enter the withdrawal fee for each form of withdrawal. You can enter the charge as a specific amount or a percentage of the total amount withdrawn
- To allow displaying a withdraw’s form outside the frontend, select Active = Yes corresponding to that form
- The minimum balance in affiliate account for requesting withdrawal
- Enter the minimum balance in the linked account to request a withdraw
- If you leave blank or fill in as 0, you will not be limited when withdrawing
- Minimum withdrawal amount
- Enter the minimum amount for each withdraws
- The withdraw fee will be included in here
- Maximum withdrawal amount
- Enter the maximum amount for each withdraws
- The withdraw fee will be included in here
1.5 Email Configuration¶

- Email Sender
- Select the email sender
- The default email sender is: General Contact
1.5.1 Admin Email¶

- Send Emails To: Enter the email address so that admin can receive notifications. You can fill in multiple emails, separate them by commas “,”
- New Affiliate Sign Up: Select Yes to let admin receive notification emails when a customer signs up for affiliate program. This will show the Sign up Template field
- Sign Up Template:
- Choose email template for email sent when a customer sign up for affiliate program
- The default content of the template is Sign Up Template (Default)
- New Withdraw Request: Select Yes to let admin receive notification email when a customer requests withdraw. This will show the Withdraw Request Template field.
- Withdraw Request Template:
- Choose email template for email sent when a customer request withdraw
- The default content of the template is Withdraw Request Template (Default)
1.5.2. Account Email¶

- Send Welcome Email: Choose Yes to send the email when an account registered as an Affiliate account
- Welcome Email
- Choose the email template sending when an account registered as an Affiliate account
- The default content of the template is Welcome Email (Default)
- Welcome Email After Account Approved
- Choose the email template sending when the registered account is approved to be an Affiliate account by the store owner
- The default content of the template is Welcome Email After Account Approved (Default)
- Account Rejection: Select Yes to send email to the customer whose request register for affiliate account is rejected. This shows the Account Rejection Template field
- Account Rejection Template:
- Choose email template for email sent when the request to register for affiliate account is rejected
- The default content of the template is Account Rejection Template (Default)
- Account Change Status: Select Yes to email the customer when the status of the affiliate account changes. This shows the Account Change Status Template field
- Account Change Status Template:
- Select email template for email sent when the status of affiliate account changes
- The default content of the template is Account Change Status Template (Default)
- Withdraw Cancel Email: Select Yes to email customer when the customer’s withdraw request is canceled. This shows the Withdraw Cancel Template field
- Withdraw Cancel Template:
- Select email template for email sent to customer when request to withdraw is rejected
- The default content of the template is Withdraw Cancel Template (Default)
1.5.3. Transaction Email` section¶

- Send Transaction Email: Select Yes to send a notification email whenever there is a transaction
- Update Balance Email
- Select the sending email template when there is a change in the balance
- The default content of the template is Update Balance Email (Default)
1.5.4. Withdrawal Email¶

- Send Withdrawal Email: Select Yes to send a notification email when you withdraw money
- Withdrawal Complete Email
- Select the sending email template when there is a change in the balance
- The default content of the template is Withdraw Complete Email (Default)
1.6. Refer Friends Configuration¶

Enable Refer Friends Feature: Choose Yes to activate the introduce to friends function
Refer Sharing Email
- Choose the email template which will be sent when introducing with friends through email
- The default content of the template is Affiliate Sharing Email (Default)
Default Refer URL
- Insert the referral link. This link will display in the My Account/My Affiliate/Refer Friend tab
- If empty, the default homepage url will be used.
AddThis.com ID
- Enter the AddThis ID to introduce it to friends through AddThis
- If empty, default Public AddThis ID ra-56e141d56e895f5c will be used
AddThis.com Classname: allows to display the social share button in the Referral Via Social Networks outside the frontend. * Enter the class name AddThis. You can go to your AddThis.com account, then click Get the code in the upper right corner, then scroll down to the Setup Inline Tools section, you will see the screenshot as below:
If this field is left blank, the system will use the default value addthis_sharing_toolbox
Display the social button share at Referral Via Social Networks outside the frontend:

- Use Cloudsponge to retrieve email contacts: Select Yes to allow access contacts from customer’s account such as Gmail, Yahoo, Live, AOL, Outlook, etc.
- Cloudsponge Key
- Enter the Cloudsponge key
- The default key used is a473483c2e256bd812bdc9a0bac867ecf1999a54
- Enable Referral via Social Networks on Product Listing Page: If Yes, the Referral via Social Networks will be displayed in the product listing page, helping customers to share and introduce to their friends to join the campaigns and get certain promotions.

- Enable Referral via Social Networks on Product Details Page: If Yes, Referral via Social Networks will be displayed in the product details page.

1.6.1. Sending Email Content¶

- Default Subject Email
- Enter a title for the sending email
- The default title is Good product and services
- Default Email Body
- Enter the content for the sending email
- The default content is I’ve been shopping at {{store_name}} and feel really happy. They provide good service and reasonable prices.
2. Manage Accounts¶
From the Admin panel, go to Marketing > Affiliate > Manage Accounts
2.1. Manage Grid¶
- Display Affiliate account information: account balance, total earned amount, account activity status, etc. Click the Edit link to see the account details.
- In this panel, admin can delete the account by clicking to the account checkbox, then choose Action > Delete

2.2. Add New Account¶

- Affiliate Group: Select the group for the created Affiliate account
- Referred By: Enter the ID of the previously registered Affiliate account
- Status
- Status = Active: The Affiliate account which is just created can start working now
- Status = Inactive: The Affiliate account which is just created can’t start working yet
- Status = Need Approved: he Affiliate account which is just created needs to be approved by admin
- Email Notification: Choose Yes to receive notification emails when there is a change in your Affiliate account balance
3. Affiliate Groups¶
4. Campaigns¶
With Affiliate Standard, the system creates a Campaign by default, you can edit this campaign’s information to match your store development strategy.

To create multiple Campaigns for your store, you can update your version to Affiliate Pro
- Edit Campaigns
- Step 1: Fill in the Campaign Information
- Step 2: Choose the conditions for applying the campaign
- Step 3: Set up Discount
- Step 4: Set up Commission
- Step 5: Set up Coupon Code
Step 1: Fill in the Campaign Information¶

- Name * Name your campaign * This is a required field
- Description: Fill in the description of your campaign
- Status: Select yes to apply the campaign
- Website IDs
- Choose the website to conduct the campaign
- This is also a required field
- Affiliate Groups
- Choose the group you want to conduct the campaign
- This is another required field
- Referred Customer Groups:
- Choose referred customer group that can use the campaign
- This field is required
- Display
- Display = Allow Guest: Show the campaign for all visiters
- Display = Affiliate Member Only: Show the campaign for Affiliate only
- Active From Date: Select the starting day for your campaign
- Active ToDate: Select the finishing day for your campaign
- Sort Order
- Insert the sort order (or prioritized number) of your campaign
- The smaller the number, the more prioritized your campaign is, which means that it will be shown and applied first. If the sort orders of different campaigns are the same, the module will then consider their ID numbers.
Step 2: Choose the conditions for applying the campaign¶

- You can choose the products for a specific campaign by setting the rules for those products
- Or you can also choose the categories for applying the campaign
Step 3: Set up the Discount¶

- Apply
- Apply = Percent of cart total: Apply discount for the percentage of cart total
- Apply = Fixed amount discount for whole cart: Apply a fixed discount for purchasing
- Discount Amount: Insert the amount or the percentage of discount for purchasing
- Apply to Shipping Amount: Choose Yes to apply discount for shipping
- Apply Discount On Tax: Choose Yes to apply discount for taxable payment
- Discount Description: Insert the description for your discount policy
Step 4: Set up the Commission¶
In this section, allowing to configure the Tier 1 as follow:

- There are two commision types:
- Percentage of grand total: Commision is calculated based on the percentage of grand cart total
- Fixed amount: Commission is a fixed amount
- Choose type and value of commission in the 1st order and the next orders. You can set them to the same or separated option depending on your strategy.
Step 5: Set up the Coupon Code¶

- Code Length: enter the length for the coupon code. Otherwise, it will default to 0.
- Code Format: Choose a format for coupon code. There are 3 formats as follows:
- Alphanumeric: coupon code will include both alphanumeric characters
- Alphabetical: coupon code will contain alphanumeric characters
- Numeric: the coupon code will contain numeric characters
- Coupon Code: You can enter an arbitrary value as a coupon code or click the Generate button below to automatically generate the format coupon code as set in the Code Length and Code Format fields.
Affiliate program is displayed in the frontend:

- Coupon codes for each Affiliate account can be used to receive discounts per Campaign.
- Coupon code includes 2 parts:
- The prefix part is Refer Code of the affiliate account, which can be changed arbitrarily in the Coupon prefix field
- The suffix is the coupon code generated in the Coupon Code tab in each Campaign.
5. Withdraws¶
5.1. Manage Grid¶
- Allow showing the withdraw history of each Affiliate account including The amount, the status, payment method, etc. Click Edit to see the details of each withdraw.
- Admin can also change the status or delete the withdraw history.

5.2. Add New Withdraws¶

- Account
- Click to this field to show the affiliate account that has positive balance which can be withdrawn
- This field is required

Amount
- Insert the withdraw amount which is including the fee of withdrawal
- This is a required field
Fee
- Insert the withdraw fee
- If you let this field empty, the configuration value will be applied
Payment Method
- Choose the payment method for withdrawal
- There are three payment methods: Offline payment, Bank Transfer, Paypal payment, Store Credit
Withdraw Description: Fill in the description for withdrawal
Payment Detail:
- For Offline payment, you need to insert the Addresses
- For Bank Transfer, insert the Bank account
- For Paypal payment, you need to fill in the Paypal email and Transaction ID
- Payment Email: Enter the Paypal email who receive commission
- Paypal transaction Id: Enter Paypal transaction ID
6. Transactions¶
6.1 Manage Grid¶
- Show the transaction of each affiliate account including the amount, status, the order that generates commission. Click View to see more details of each transaction.
- Admin can also change the status or delete the transaction records.

Assign to Affiliate Group¶
After adding the new Affiliate accounts, store admin can manage them in the Accounts Management grid.
- On the grid, find the Affiliate account needed to assign and open the Edit mode
- Choose the Affiliate group to assign. By the default, General is chosen

6.2. Add New Transaction¶

- Account
- Click to this field to show the affiliate account and then you can choose the account to add transaction in
- This is a required field

- Amount
- Insert the added amount. It can be a negative one
- This is a required field
- Title: Add the Title of transaction
- Holding Transaction For
- Add the number of days that you want to keep the transaction records
- If you leave it empty or insert 0, the transaction will be deleted
7. Email¶
7.1 Notification emails for successful registration the affiliate account¶

7.2 Notification emails for Affiliate account approval¶

7.3 Notification emails for changing the Afiliate account balance¶

7.4 Notification emails for completion of withdraw request¶

7.5 Notification emails for admin when there is a request to create Affiliate account¶

7.6 Notification emails for admin when there is a request to withdraw¶

7.7 Notification emails for customer when an account creation request is rejected¶

7.8 Notification emails for customer when status of Affiliate account changes¶

7.9 Notification emails for customer when withdrawal request is rejected¶

8 Compatible with Mageplaza Store Credit (Withdraw)¶

Affiliate is fully compatible with Mageplaza Store Credit extension to support store credit withdrawal conveniently and link accounts together.
Expert’s recommendations
Tip
Must-have extensions for your Magento stores