Partenaires
The Freelance OS partner program. Someone applies, you approve them, they get a referral code. Every account that signs up and pays through their link earns them a commission. A dedicated portal for the partner, an admin console for you, an owner-agnostic engine in between.
Overview
The program gathers three profiles under one mechanic: the referrer who recommends by word of mouth, the content creator with an audience, the agency that resells to its clients. Each one applies with their channels (LinkedIn, TikTok, newsletter, community), you approve, a unique referral code is allocated. The code follows the SDA-XXXX format and lives in their portal.
Attribution rests on a link and a cookie. The partner shares freelance-os.fr/r/<code>. The click sets an attribution cookie valid for the program window, 60 days by default, then redirects to signup. An account created inside that window is tied to the partner. The link can be tagged by channel (?ch=tiktok) so the partner knows where their best referrals come from.
The commission fires on the first collected payment, never on the click or the signup. The rate and duration depend on the tier: a fixed percentage over the first 12 months, for life, or a single payout. Amounts are computed in basis points, rounded to the cent, and pile up as pending then approved. Payout runs through Stripe Connect above the program threshold, with a clawback window if the customer gets refunded.
What the module does
Three tiers, three commission logics
The platform program ships three tiers by default. The tier is not picked by the partner, it is set at approval, and a referrer can climb automatically as they accumulate active converted referrals.
- Referrer: 20% over the first 12 months of every recommended account
- Pro Referrer: 30% for life, reached automatically from 5 active converted referrals
- Agency: 25% for life as an override, assigned manually, not earned by volume
Attribution by link and cookie
The /r/<code> link is resolved on the server. It sets the attribution cookie for the program window, keeps the origin channel if the link is tagged, then redirects to signup. The real attribution, tying the created account to the partner, happens at signup by reading that cookie. An account is never attributed twice.
Commission on the first payment
Nothing is owed until a euro is collected. When an invoice from the referred account is paid, the engine decides: if it is the first payment, or if we are still inside the tier window, a commission is created at the tier rate. An invoice outside the window earns nothing. A refund inside the clawback window cancels the matching commission.
The partner portal
Every approved partner has their own space. They find their link, a per-channel link builder, their referrals with status, the breakdown by origin channel, and their earnings: pending and payable. A pending, rejected or suspended partner sees a status message instead of the dashboard. The first login automatically links the account to the application carrying the same email.
- Referral link and per-channel tagged link, copied in one gesture
- Counters: referrals, converted, pending commissions, payable commissions
- List of referrals by status, from click to conversion
- Referral kit and downloadable resources
The admin console
On the platform side, you run the program from Hypervisor. You see applications, approve or reject, set the tier, suspend, archive. A partner's detail page shows their declared channels, their referrals, their commissions, and lets you export those commissions to CSV. The referral kit shared with partners is edited here, without touching code.
How to use it
- 01
The partner applies
From the partner site, they fill their application: name, email, country for the Stripe payout, channels and audience size. At least one channel is required. The application creates a pending partner.
- 02
You approve and set the tier
From Hypervisor, you open the application, see the declared channels, approve and pick the tier. A unique referral code is allocated to the partner.
- 03
They share their link
On first login, their account is linked to their application. They grab their /r/<code> link and can tag it by channel to trace where their referrals come from.
- 04
An account signs up via the link
The click sets the attribution cookie. Signing up inside the window ties the account to the partner. The referral shows up in their portal as signed up.
- 05
The commission fires on payment
When the referred account pays its first invoice, the engine creates the commission at the tier rate. It piles up as pending, then turns payable, and payout follows via Stripe Connect above the threshold.