Affiliate Program

Hi,

With the affiliate system in HikaShop, each affiliate of a partner will be linked to that partner. When you edit a customer in HikaShop's backend, you'll have a setting "partner" with the partner user selected, so you can see "which customer belons to which dealer".
Also, with a mass action you can output a list / CSV of the users of a partner with a filter on the column user_partner_id and an action "Display the results" or "export CSV file".

Hi,

Yes, it is possible. You can configure banners in HikaShop to setup links you want to advertise to partners so that they can share their unique link with their customers. This way, the customers will be linked to them automatically.
www.hikashop.com/support/documentation/i...hop-banner-form.html
You can see an example of partner affiliate program page with some banners configured for our own website:
www.hikashop.com/my-account/affiliate-program.html

Hi,

It's possible for users to accumulate points with the user points system:
www.hikashop.com/support/documentation/257-using-points.html
Then, you can configure the "Provide points instead of fees" setting, under the Features tab of the HikaShop configuration for partners to gain points instead of fees.

Hi,

Let me address your questions one by one.

1. Points multiplied by quantity

This is the default behavior. When a customer buys 3 pieces of a product that gives 7 points, the points plugin will give 3 x 7 = 21 points. You don't need to configure anything special for that. If you're not seeing this behavior, make sure the points plugin's "Give points when using some" setting is set to "Give on full price" (which it is in your screenshot).

2. Paying with points (partial or full)

In your "Pay with Points" payment method configuration, you have "Partial payment" set to "No" and "Minimum (percent)" set to 100%. This means the customer must pay the full amount in points or not at all. To allow partial payment (points + money), set "Partial payment" to "Yes" and lower the minimum percentage. For example, setting the minimum to 0% would allow the customer to use whatever points they have and pay the rest with another payment method.

However, there is an important thing to understand: the "Pay with Points" payment method works as a standalone payment method. When partial payment is enabled, the remaining amount after deducting the points value will need to be paid with a second payment method during checkout. The customer would first select "Pay with Points", which deducts what it can, and then a second payment step is presented for the remainder.

3. Exchange rate configuration

Looking at your screenshots, there is an inconsistency in your exchange rates. In the "Pay with Points" payment method, you have 1 point = 0.25 EUR. But in the points plugin, you have 1 EUR = 1 point. This means the customer earns 1 point per EUR spent but each point is only worth 0.25 EUR when redeeming. Make sure this is intentional. If you want points to have a 1:1 value with EUR, set both to the same rate.

Also, you have the product custom field "userpoints" set to 7 for a product priced at 39 EUR. If you're using the custom field to define a fixed point cost for products, this means the product costs 7 points (= 1.75 EUR at your current 0.25 rate). If you want 7 points to cover the full 39 EUR, you would need to set the rate to approximately 1 point = 5.57 EUR. Alternatively, if you want each product to define its own point price independently from the EUR exchange rate, you can use the "Custom field for price in points" setting, which overrides the exchange rate calculation for that product.

4. Coupon workflow issue

The issue you described with the coupon being generated and the checkout going back a step is related to the "Virtual coupon" setting, which is set to "No" in your configuration. When it's set to "No", the system generates a real coupon code that the customer needs to apply manually, which causes the confusing workflow you described. If you set "Virtual coupon" to "Yes", the point discount will be applied automatically without generating a visible coupon, and the checkout flow will be smoother.

Regarding the points disappearing when a coupon is deleted: if "Return points on cancel" is set to "Yes" (which it is), the points should be returned when the order is cancelled. But if the customer just deletes the coupon without cancelling the order, the points may not be returned. This is expected because the coupon deletion is not the same as an order cancellation.

Hi,

Both issues you describe are caused by having the "Virtual coupon" setting set to "No" in your Pay with Points payment method.

When this setting is set to "No", the plugin needs to create a real coupon code to apply the discount. This can only happen at the "Finalize order" step, which is why the checkout goes back to the previous step to show the coupon. And if the customer deletes that coupon and leaves checkout, the points cannot be automatically restored because the system has no way to know that the deleted coupon was linked to a point deduction.

The solution is to set "Virtual coupon" to "Yes". In this mode:
- No real coupon is created. The point discount is applied automatically as a line on the cart.
- Points are only deducted when the order is actually confirmed.
- The discount is visible before the final confirmation step.
- If the customer leaves checkout without completing the order, no points are lost.

Note that when "Virtual coupon" is set to "Yes", you also need to enable "Partial payment" and make sure it is not set to "No". The virtual coupon mode requires partial payment to be enabled.

Regarding your exchange rates: with your current configuration (1 point = 0.25 EUR in the payment method, and "userpoints" custom field set to 7 on the product), the product costs 7 points regardless of its EUR price. The custom field overrides the exchange rate calculation for that product. So a customer needs exactly 7 points to buy this product with points. If 7 points is not enough to cover the full 39 EUR price and you want the customer to pay the difference, you need to enable partial payment.

Hi,

Thank you for the detailed description. The issue is clear now.

Virtual coupon mode requires "Partial payment" to be set to "Yes". This is mentioned in the warning message that appears when you save the payment method with Virtual coupon = Yes and Partial payment = No: "The Virtual coupon mode cannot be used for partial payment with points."

Here is why: in virtual coupon mode, the plugin automatically calculates how many points the customer can use and shows the discount as a line in the cart. This is by definition a partial payment (points cover part or all of the order, with any remainder paid by another method). If partial payment is disabled, the plugin has no way to apply the points.

To get the workflow you want, set these settings on your "Pay with Points" payment method:

- Virtual coupon: Yes
- Partial payment: Yes
- Minimum (percent): 0% (allows any amount of points to be used)

With these settings:
- The customer does NOT need to select "Pay with Points" as a payment method (it won't appear in the payment list, which is expected)
- The point discount is automatically calculated and shown as a line in the cart/order summary
- If the points cover the full order, no additional payment is needed
- If the points only cover part of the order, the customer pays the remainder with another payment method

If you want the customer to be able to choose whether or not to use their points, you can configure the "Checkout step" option in the HikaShop user points plugin settings (under System > Plugins, the "points" plugin, not the payment method). When enabled, a step is added to the checkout where the customer can choose to use their points or not.

Hi,

Question 1 - Distributors with affiliate links:
This is the standard affiliate system in HikaShop Business. Here's how to set it up:

1. Go to HikaShop > Configuration > Features and enable the affiliate system. Configure the partner commission (percentage or fixed amount per order). You can enable "Provide points instead of fees" so partners receive user points instead of money. Full configuration details here: www.hikashop.com/support/documentation/5...l#features_affiliate

2. Each distributor registers as a partner and gets a unique affiliate link. You can create banners (Marketing > Banners) with links to your shop pages. The partner's tracking parameter is automatically added to the URL. See the banners documentation: www.hikashop.com/support/documentation/2...-banner-listing.html

3. When a customer clicks the link and purchases, the order is linked to the distributor. The distributor earns the commission/points. The customer does NOT earn points (unless you also configure the user points plugin for all users, which you shouldn't in this case).

4. The distributor can see their affiliated customers and commissions in the frontend control panel. You can see an example of the partner interface on our own site: www.hikashop.com/my-account/affiliate-program.html

For the user points configuration (for the distributors only): www.hikashop.com/support/documentation/257-using-points.html

Question 2 - Tiered discounts based on cumulative turnover:

There is no built-in automatic "tiered discount by turnover" feature in HikaShop. However, you can achieve this with a combination of:

1. Create Joomla user groups for each tier (e.g. "Bronze - 5%", "Silver - 10%", "Gold - 15%")

2. Create HikaShop discounts linked to each group with the corresponding percentage. See: www.hikashop.com/support/documentation/2...iscount-listing.html

3. The built-in mass action filters and actions for users don't include a "cumulative order total" condition, so it's not possible to automate the group assignment of users based on their purchases. It would need to be done either manually by checking each customer's order history in the backend, or via a small custom plugin that queries order totals and updates user groups periodically. If you need help developing such a plugin, feel free to ask and we can provide guidance or a quote.

Hi,

Guidance for developing the plugin yourself:
You can create a small HikaShop system plugin that hooks into the cron to automatically update user groups based on order totals. Here's the approach:

1. Create Joomla user groups for each tier (Bronze/Silver/Gold) and HikaShop discounts linked to each group

2. Create a system plugin (group "hikashop") that implements the `onHikashopCronTrigger` event. This event is called every time the HikaShop cron runs. In your plugin, run a SQL query like:

function onHikashopCronTrigger(&$messages) {
    // Define your tiers: group_id => minimum turnover
    $tiers = array(
        5 => 1000,  // Gold group: 1000+ EUR
        4 => 200,   // Silver group: 200+ EUR
        3 => 100,   // Bronze group: 100+ EUR
    );
    
    $db = JFactory::getDBO();
    
    // Get cumulative order totals per user
    $db->setQuery('SELECT order_user_id, SUM(order_full_price) as total 
        FROM #__hikashop_order 
        WHERE order_type = "sale" 
        AND order_status IN ("confirmed","shipped","delivered") 
        GROUP BY order_user_id');
    $users = $db->loadObjectList();
    
    foreach($users as $user) {
        // Find the matching tier
        foreach($tiers as $groupId => $minAmount) {
            if($user->total >= $minAmount) {
                // Get the Joomla user ID from the HikaShop user
                $db->setQuery('SELECT user_cms_id FROM #__hikashop_user WHERE user_id = ' . (int)$user->order_user_id);
                $cmsId = $db->loadResult();
                if(!empty($cmsId)) {
                    // Add user to the tier group (if not already in it)
                    $db->setQuery('INSERT IGNORE INTO #__user_usergroup_map (user_id, group_id) VALUES (' . (int)$cmsId . ', ' . (int)$groupId . ')');
                    $db->execute();
                }
                break; // Assign only the highest matching tier
            }
        }
    }
    
    return true;
}

Hi,

I checked your configuration. The issue is that the affiliate fee settings are currently all at 0 (both the global percentage and flat fee, and the custom fee on the distributor user). With "Provide points instead of fees" enabled, the system converts the affiliate fee amount into points for the partner. Since the fee is 0, the partner gets 0 points from their customers' orders.

The custom product field "userpoints" only controls how many points the buyer earns when purchasing a product. It has no effect on partner/distributor points. Partner points are always calculated from the affiliate fee (percentage of order price + flat fee).

Here is what you need to configure to achieve your goals:

1. Distributor earns points when their customers buy:
In HikaShop > Configuration > Affiliate section:
- Set "Percentage fee on sales" to the desired value (e.g. 10 means the partner earns points equal to 10% of the order price)
- Or set "Flat fee on sales" if you prefer a fixed amount per order
- Keep "Provide points instead of fees" enabled
For example, if a customer buys a product at 30 EUR and the percent fee is 10%, the distributor will receive round(30 * 10 / 100) = 3 points.

2. Only distributor customers earn buyer points, not regular customers:
There is no built-in setting to automatically give buyer points only to customers linked to a distributor. The access level setting on the user points plugin controls which user groups can earn buyer points, but it does not check whether the customer is linked to a partner.
Two possible approaches:
- Create a dedicated Joomla user group for distributor customers. Manually assign customers to that group (or automate it with a custom plugin). Then restrict the user points plugin to that group.
- Develop a small custom plugin that checks if the buyer has a partner (user_partner_id) before allowing points to be earned.
Note that the user points plugin does not affect partner points from the affiliate system. Partners will still receive their points from "Provide points instead of fees" regardless of the plugin access level.