Skip to main content
Your store’s affiliate program lets customers earn a commission for referring buyers. It is available on every plan, including Free. You set the commission rate and the discount referred buyers receive, Komerza tracks attribution and accrues balances, and you settle up with affiliates directly.

​
Setting it up

Go to Settings → Affiliates (sections: Commission, Permissions, Management) and switch on Enable affiliate program. Then configure: Per product you can override the customer discount on the product editor’s Affiliate tab: use the store default, disable the discount (the affiliate still earns commission), or set a custom percentage.

​
How attribution works

An affiliate shares your storefront link with ?ref=<code> appended. Attribution lasts 30 days, and the code can also be entered directly at checkout.
The Embed SDK handles this automatically. A visitor arriving at your own site with ?ref= is attributed without any setup, the affiliate cookie is read if present, and you can override it per checkout by passing affiliateCode to Komerza.open().

​
How commission accrues

Commission is a percentage of the money actually collected, credited once the order reaches delivery. Three consequences worth knowing before an affiliate asks:
  • A pending or unpaid order earns nothing yet.
  • The amount is based on what the buyer actually paid, after the affiliate’s own discount.
  • Refunding an order reverses the commission automatically.
If an affiliate says their balance hasn’t moved, walk that list in order - it is almost always the first item.

​
Managing affiliates

Manage them under Customers → Affiliates, which requires the View and Update Affiliates permissions. The page shows Total Affiliates, Commissions Paid, Referral Revenue, Avg. Commission and your top earner, and lets you Invite Affiliate by email, search, delete or blacklist. Affiliates see their own rate, referral link, balance and referred orders on your store’s customer dashboard under Affiliates.

​
Paying affiliates

There is no automatic cash payout. Komerza tracks balances; it does not move money to your affiliates.
When you settle up, open the affiliate’s detail page under Customers → Affiliates and record a payout against their balance. The actual transfer - PayPal, bank, whatever you agree - happens outside Komerza. A recorded payout can be voided, which restores the balance. If you enabled balance conversion, affiliates can instead convert their balance into store credit and spend it with you, which costs you nothing in cash and keeps the money in your store. See Customers & Store Credit.

​
Doing this by API

The affiliate endpoints cover the whole lifecycle: create, invite, update, blacklist, delete, list referred orders, and record, void or list payouts.

Affiliates API

List, search and manage affiliate profiles.

Record a payout

Log a settlement against an affiliate’s balance.

​
Next steps

Customers & Store Credit

Where converted affiliate balances end up.

Coupons & Discounts

How affiliate discounts differ from coupon codes.