Referrals
Share your referral link and earn 500 credits each time someone you referred upgrades to a paid plan.
How-to guide
Share your referral link, and earn 500 credits the first time a person you referred upgrades to a paid plan. The reward lands on the balance you spend on AI generation. This page shows you where to find your link, how the reward is paid, and the exact rules that decide when it fires.
Open the referral panel
The referral panel lives inside the workspace. Open a project, then open the workspace menu and choose Parrainage (Referrals). The panel opens as a modal with two tabs: Partager (Share) and Mes parrainages (My referrals).
- The Partager tab shows your QR code, your referral code, your share link, and buttons to send it by email, WhatsApp, Twitter, or LinkedIn.
- The Mes parrainages tab shows three counters (signups, paid upgrades, credits earned) and a table of every person you referred with their status and the credits each one earned.
Your code is generated for you
Every account gets an 8-character alphanumeric referral code automatically the first time the account is created. You do not request or activate it. The panel reads it from your profile and builds the link around it.
Share your link
Your share link points at the signup page with your code attached as a query parameter:
https://workspace.mashop.app/signup?ref=YOURCODEIn the Partager tab, the Copier (Copy) button copies that full link to your clipboard. The QR code encodes the same link, so a phone camera lands the person on the signup page with your code already applied. The social buttons open a share dialog pre-filled with the link.
When someone signs up through your link, the code rides along through signup and is resolved on their first confirmed login. At that point a referral record is created with the status signed_up, and they appear in your Mes parrainages table as Inscrit (Signed up). No credits are paid yet at this stage.
When you earn the reward
You earn the reward when a person you referred moves from the free plan to a paid plan. The trigger fires on the plan change itself.
- The referred user upgrades from
freetoproormax. - A database trigger on that plan change runs the
award_referral_on_upgradefunction. - The function adds 500 credits to your balance, writes a bonus entry to your credit history, and posts a notification to your workspace bell.
- The referral row flips from signed_up to upgraded, and the table shows the status Plan payant (Paid plan) with +500 in the credits column.
The reward amount is a fixed constant in the code. The function declares v_reward INTEGER:= 500, and the workspace panel reads the same 500 value for its tip line. The credits-earned counter is separate: it sums the reward recorded on each of your upgraded referrals.
The notification
When the reward is paid, a referral notification is inserted for you with the title "Crédits de parrainage reçus" and a message naming the plan the referred user upgraded to. You see it in the workspace bell.
The exact rules
The reward is paid under a precise set of conditions, all enforced in the database function and the signup wiring.
| Rule | Behavior |
|---|---|
| Reward amount | 500 credits per referred user who upgrades. |
| What qualifies | The referred user must move to pro or max. A user who stays on free never triggers a payout. |
| How many times | Once per referred user. The function only acts on a referral still in signed_up status, so the same person upgrading cannot pay you twice. |
| One referrer per person | A referred account is linked to a single referrer. If they already have one, a later code does not overwrite it. |
| No self-referral | The link only attaches when the referrer and the referred account are different users. |
| Failure is silent | The trigger swallows errors so a referral problem never blocks the upgrade itself. If a payout cannot run, the upgrade still completes and you are not credited. |
Read your referral history
The Mes parrainages tab is your record. Each row shows the referred person (their email is masked), their signup date, their current status, and the credits they earned for you. The three counters at the top sum the same data: total signups, how many became paying, and total credits earned across all your referrals. A row only shows a credit figure once the person upgrades; before that the credits column shows a dash.
Where the credits go
Referral credits land on the same balance you spend on AI generation, alongside any plan credits and top-ups. See Credits for how the balance is drawn down, and Plans for what an upgrade to Pro or Max includes.
Troubleshooting
- No code or link shown. The panel reads your code from your profile after it loads. If the link area shows "Génération du lien..." or a placeholder code, wait for the panel to finish loading, then reopen it.
- A referred person upgraded but I was not credited. The reward only fires when their plan transitions from free to paid, and only while the referral is still in
signed_upstatus. If they were already on a paid plan when the link attached, or the referral was never recorded, there is nothing to upgrade and no payout runs. - The header shows a different number than 500. The amount that is actually paid is the 500-credit reward in the function and the panel tip line. Trust the credited amount in your Credits history and the +500 in your referral table.