Odoo Affiliate Manager
Run a full affiliate and referral program inside Odoo eCommerce. Track clicks
and sales. Set commission by custom rate, group, tier, or product. Catch fraud
automatically. Pull back money on refunds. Pay everyone in one monthly bill
run - all through a branded portal your affiliates log into themselves.
Here is a detailed explanation about all the features of this module.
Module installation and setup
What you need before you start
Trying it with sample data
Installing with demo data fills in some sample affiliates and commissions so you can look around before setting up your own. Use a test database for this, not your real one.Where to find things afterwards
A new affiliate manager menu appears. Inside it :-
Quick setup - six things to set
Open Affiliate Manager > Configuration > Settings. These six settings get you a working program.
Required
Without this, the monthly payout can't create bills.Physical products
Customers can return items after delivery. Keep a real hold window.Set to 30 days (a sensible default)
Digital products
No returns to worry about, so there's no reason to hold the money back.Set to 0 (no hold)
Selling both? Pick the number that matches your slower-moving line - usually physical.
Click Save. Your program skeleton is ready - next, give it commission rates.
Module installation and setup
Rates live on the commission plan: Configuration > Commission > Commission Plans.
The simple way
Set PPS Type to simple, pick fixed (a flat amount per sale) or percentage, and enter the number. Done.
Rates that climb (tiers)
Turn on tiered commission and build a ladder - each rung has a name, a sales threshold, and a rate.
Example:
Affiliates see the whole ladder on their dashboard, with a progress bar. Moving up a rung sends them an email - but only once, and never for the starting run.
Different rates per product
If your margins vary a lot by product, switch PPS Type to Product Commission and build a rate table at Configuration > Commission > Product Commission. You can set a rate for one specific product, a whole category, or a global fallback - the first matching line wins.
Can't combine
Product commission and tiered commission can't both be on - turning one on turns the other off.Groups (VIP, Bronze, custom cohorts)
Create named groups - like Bronze, Silver, or "Q4 influencers" - each with its own rate, then assign affiliates to a group from their contact form.
If more than one rate could apply
Only one rate is ever used per sale - the first one set, in this order :-
Good to know
A rate left at 0 is treated as "not set" - the system moves to the next one on the list instead of paying nothing. You can always see which rate was used on a commission's source field.Optional features and commission control settings
Everything here is off by default - only turn on what your program actually needs.
Pay per click
Pays affiliates for clicks, not just sales. Most programs leave this off. If you turn it on, set PPC Maturity (how long a click ages before it counts - 7 days is reasonable) and consider unique PPC for product so reloads don't pay out repeatedly.
Coupon commission
Coupon commission % is the rate for sales made using an affiliate's coupon. Since the customer already got a discount, this is usually set lower than the normal rate.
Coupon commission
Turn on enable advanced commission to unlock:
Excluding products
Tick no Affiliate Commission on any product or category you never want to pay commission on (gift cards, loss leaders, clearance). Delivery lines and discount lines never earn commission either way - no setup needed.
Auto-confirm sales
Auto confirm visit confirms sale commissions automatically every night instead of you approving each one. Watch one full cycle by hand first before turning this on.
Fraud detection and sub-affiliates also live in this settings block.
Your landing page and promo materials
Your recruitment page lives at /affiliate on your own website.
Before you launch: a 15-minute test
Walk one sale through whole chain yourself before inviting real affiliates. It catches almost everything.
Check your configuration
Run a real test order
Only then
Turn on auto confirm visit and auto approve request. Automate what you've already watched work by hand.Approving affiliates
Applications land at affiliate program > pending requests.
Check your configuration
Three buttons: Approve (grants access, generates their key, sends the welcome email), Reject, and cancel Affiliate (revokes someone already approved).
Their affiliate record
Every approved affiliate is a normal contact with an extra Affiliate Details tab, at Affiliate Program > All Affiliates. Key fields: their Affiliate Key (referral code), their group, who recruited them, and whether they have a custom rate.
Who gets credit for a sale
Two ways a sale gets traced back to an affiliate - and only one affiliate is ever credited.
Referral links
Coupon codes
If both are present
The coupon wins. Customers who use a coupon at checkout are crediting that affiliate on purpose.
Affiliates can never earn from buying their own products - this is checked automatically, even with a second account using the same email.
The four stages a commission moves through
Sale commissions confirm manually (or automatically overnight, if you turned that on). Click commissions confirm once they pass their maturity window.
Use the preview commission button any time to see what a commission would pay, without actually creating anything.
The four stages a commission moves through
The payout run happens daily but only does anything on your payment day.
On that day, for each affiliate, it gathers every commission that is : confirmed, past the refund hold window, and not flagged as suspicious. If the total meets your minimum payout balance, it drafts one vendor bill. Otherwise the balance just rolls into next month.
Pay these bills through your normal accounting process at Affiliate Manager > Invoicing > Invoice. A commission only shows as paid once its bill is fully reconciled - a payment that's registered but not yet reconciled shows as processing to the affiliate.
Paying someone early
Select any confirmed commissions in order report and run Create Visits Invoice to bill them right away.
Refunds and clawing back commission
When a customer gets a refund, the affiliate's commission on that sale is reversed automatically - how, depends on how far it's already travelled.
Why your refund hold window matters here :
Physical products
Returns happen after delivery - sometimes weeks later. A real hold window (e.g. 30 days) means most refunds happen while the commission is still just confirmed, so nothing is ever paid out & then clawed back.Digital products
With no returns expected, holding the money back only delays affiliates for no reason. A 0-day hold pays them faster - and clawback still works fine on the rare refund.Affiliates always see any active clawback amount stated plainly on their Payments page - never as an unexplained drop in balance.
Fraud control & sub-affiliates
Two ways a sale gets traced back to an affiliate - and only one affiliate is ever credited.
Fraud checks
Sub-affiliates (referral bonuses)
What an affiliate sees on their dashboard
An affiliate only ever sees their own data - this is enforced by the system, not just hidden in the screen.
Their promotion tools
All settings, automatic emails and scheduled tasks & troubleshooting.
All settings, quick reference
Automatic emails and scheduled tasks
Troubleshooting
- Likely cause - Check in order: order confirmed > referral cookie or coupon present > buyer isn't the affiliate > product isn't excluded > order meets the minimum value.
- Likely cause - Read the message - it names the cause (usually a missing rate, a zero value, or PPC being off).
- Likely cause - The run only fires on your payment day, and only once the total meets your minimum payout balance.
Here is a detailed explanation about all the features of this module.
Module installation and setup
What you need before you start
This adds AI to your existing affiliate module. It does not create a new app. The new options appear inside the Affiliate Manager menus you already use.
Good to know
After install, the AI is still off. Affiliates will not see any AI tools until you finish.Set-up AI access, tokens, providers, and affiliate summaries
Turn on AI and connect your AI provider
Here you tell Odoo which AI company to use and give it your API key.
The two number settings, in simple words :
Providers you can pick :
Good to know
- Each provider remembers its own key. You can switch to another provider and back without typing the key again.
- If you untick Enable AI Content Generation later, all AI tools disappear for affiliates straight away.
Choose how tokens are counted
The AI provider charges you for tokens. Token balances let you decide how much each affiliate can use.
Good to know
- Your own admin tools never use anyone's tokens.
- If an AI request fails, no tokens are taken.
- One click on generate writes 3 versions and usually uses a few hundred tokens.
Give an affiliate AI access
Nobody gets AI by default. You turn it on for each affiliate, one by one.
Add more tokens
Take access away
Good to know
- AI Tokens Used is the total this affiliate has spent so far. You can read it, but not change it.
Get a quick AI summary of one affiliate
The AI reads this affiliate's numbers and tells you, in 2 or 3 sentences, how they are doing and what you could do next.
Good to know
- This is free for you. It does not use the affiliate's tokens. The summary stays saved on the affiliate until you make a new one.
Make ready-made promo texts in bulk
The AI writes several promo texts at once and saves them in your Promo Content library. All affiliates can then copy them.
- Product templates: one text works for any product the affiliate picks.
- Generic: uses the affiliate's home referral link, no product.
Good to know
- New texts are live straight away. Affiliates can see them on their Promo Content page.
- You can find all texts later at Affiliate Manager > Configuration > Promo Content.
- This does not use any affiliate's tokens.
Ask the AI about your whole program
Ask questions in plain English, such as “Who are my top 5 affiliates?”. Or get a full health check of your program with numbers and advice.
Questions you can try
What Full Program Insights shows
Good to know
- The number cards and tables come straight from Odoo. Only the text under “Analysis & recommendations” is written by the AI.
- The gear menu item also works on Order Report and Traffic Report.
- For questions, the AI reads up to 60 affiliates at a time.
- This does not use any affiliate's tokens.
See every AI request and what it cost
Every AI request is saved here, from affiliates and from you, whether it worked or failed.
Tips
- Metered ticked means tokens were taken from the affiliate's balance.
- Group the list by Affiliate to see who uses the most tokens.
Ask the AI coach on your dashboard
Ask anything about your affiliate account. The coach answers using your own numbers: your plan, tier, earnings, last sale and payout rules.
Questions you can try
Good to know
- If the coach doesn't have the information, it says so. It does not make up numbers.
Open the AI Studio
AI Studio is your writing helper. It sits at the top of your promo content page.
Questions you can try
Write new posts with generate
Pick a few options and the AI writes 3 different posts for you. Your referral link is already inside each one.
Good to know
- With a product picked, the link opens that product's page. With Generic, it opens your home referral link.
- The text is plain, with no stars or odd symbols, so it pastes cleanly.
- Always read the post before you share it.
Make your own text better with improve
Already wrote something? Paste it here. The AI makes it clearer, shorter and more convincing, with the same meaning.
Good to know
- Your links and hashtags are kept. The AI reads about the first 2,000 characters, so very long text gets cut.
Translate text in any language
Translate your promotional messages into different languages while preserving their natural marketing tone and original formatting.
Good to know
- AI translates your message naturally, keeping its marketing tone, links, hashtags, and emojis intact.
Ask a question inside the studio
This is the same helper as the AI Coach, with a bigger box for longer questions.
Good to know
- Links, hashtags and emojis stay exactly the same.
Get a caption for a product in one click
The fastest way to post about a product. One click writes a social media caption with your product link inside.
Good to know
- This button always writes for social media, in a casual tone, in English. For other choices, use Generate in AI Studio
AI section on the affiliate landing page
A new section on your public affiliate page tells people about the AI tools. It helps you get new affiliates.
Good to know
- Everyone sees this section, even people who are not logged in.
- It shows even when AI is turned off in Settings. To hide it: turn on developer mode, go to Settings > Technical > User Interface > Views, search Affiliate Landing : AI Content, and archive that view.
Problems and fixes