Skip to content

Affiliate program ​

The affiliate program turns your customers into resellers. Anyone with an account can join, share a personal referral link and earn a percentage of what the accounts they bring pay you. Replora tracks the clicks, the sign-ups and every commission. Once a month you send each affiliate a bank transfer and record it, with the bank's receipt, on the Affiliates page.

10 minutesSaaS ownersSaaS
Available inSingle userSaaSThe Affiliates module is part of the SaaS edition (saas/modules/Affiliates).

The program has three sides:

WhereWhoWhat
Settings › Installation › Affiliate programadministratorsOpen or close the program, set the commission, how long it is paid, the cookie window, the holding period, the payout currency and the smallest payout
Administration › Affiliates (/affiliates)administratorsEvery affiliate with their earnings, recording payouts, own rates, pausing a link, voiding refunded commissions
Account › Affiliate program (/affiliate)every signed-in person, while the program is openJoining, the referral link, clicks, sign-ups, earnings, payouts with their proof, bank details
/affiliate-program on the public websitevisitorsThe program's terms and a Become an affiliate button (only while the program is open)

How it works ​

  1. An administrator opens the program in the settings.
  2. A customer joins from Account › Affiliate program and gets a link such as https://your-site.com/?ref=zhfrq7on.
  3. A visitor opens the link. Replora remembers the affiliate in the visitor's browser for the Link remembered for days and counts one click.
  4. The visitor creates an account in that browser. The new account becomes the affiliate's referral (once: an account is referred only once, and an affiliate never refers their own account).
  5. Each time the referred account pays (a paid Stripe invoice or a completed Paddle transaction), the affiliate earns their rate of the amount without tax, as long as the payment falls within the Paid for months after the sign-up.
  6. The commission is held for the holding period (so refunds and chargebacks come first), then becomes due.
  7. On the 1st of each month administrators get an email listing the affiliates that are ready to be paid. You send the bank transfers, then record each one on the Affiliates page. The affiliate gets an email and can download the proof.

Commission states

StateMeaning
HeldEarned less than Holding period days ago
DuePast the holding period, not paid yet: it will be included in the next payout
PaidIncluded in a recorded payout
VoidVoided by an administrator (for example the payment was refunded); doesn't count anywhere

Program settings ​

Settings › Installation › Affiliate program (administrators). The settings are stored in the database; the values below are the defaults from saas/modules/Affiliates/Config/affiliates.php.

SettingWhat it doesDefaultAllowed
Open the affiliate programOff: nobody can join, links aren't remembered, no sign-ups are credited, no commissions are earned, the Affiliate program menu item and the public /affiliate-program page disappear. Affiliates, commissions and payouts already recorded stay, and you can still pay due commissionsOffon / off
Commission (%)The share of each payment (without tax) a referrer earns. A new rate applies to payments from then on; commissions already earned keep their rate251–90
Paid for (months)Payments made within this many months after the referred account signed up earn a commission. 0 = for as long as the account pays120–120
Link remembered for (days)How long the referral cookie lasts in the visitor's browser601–365
Holding period (days)How long a commission stays Held before it becomes Due300–120
Payout currencyThe currency the smallest payout is set in, shown on the program pagesUSDUSD, EUR, GBP, CAD, AUD, CHF, JPY, INR, BRL
Smallest payoutAffiliates are listed as ready to be paid once their due balance in the payout currency reaches this amount (in whole units, e.g. 50 = $50). 0 = any balance500–100000

Choose the payout currency to match your prices

Commissions are recorded in the currency the customer paid in, and amounts in different currencies are never added together. Only a due balance in the payout currency can make an affiliate ready to be paid; balances in other currencies show under Due and wait for you to pay them by hand (see Record a payout).

The Affiliates page ​

Administration › Affiliates (/affiliates, administrators only).

your-site.com/affiliatesInteractive: click the numbers
1. TotalsHow many affiliates, what they earned in the chosen month, what is due now and how many are ready to be paid.

When the program is closed a notice at the top says so.

Columns ​

ColumnWhat it shows
AffiliateName, email and code. Paused when their link is paused, No bank details when they haven't entered them
RateTheir commission in %; own rate when it differs from the program's
ClicksVisits through their link (counted once per browser and code)
Sign-upsAccounts created through the link; n paying = how many of them paid at least once
(month)Commissions earned in the chosen month
HeldCommissions still in the holding period
DueCommissions that can be paid now
PaidEverything paid so far
(button)Pay when ready to be paid, otherwise Open

Amounts are shown per currency, e.g. $75.00 · €40.00. Voided commissions are left out everywhere.

One affiliate ​

Clicking an affiliate opens a dialog (its subtitle shows their email and link):

SectionWhat you can do
TotalsDue now, Held, Paid, and Clicks / sign-ups / paying
Bank detailsAccount holder, Bank, IBAN or account number, SWIFT / BIC, Country, Notes, each with a copy button for your banking app. Without bank details the affiliate can't be paid
Record a bank transferShown when they have bank details and something is due (see below)
PayoutsDate, reference and note, amount, proof (download, Attach proof or replace it) and Undo
Rate and linkOwn commission (1–90 %, empty = the program's rate; applies to new payments) with Save rate; Pause link / Resume link
CommissionsThe last 200: date, referred account (its name), payment, commission and rate, state, and Void (refunded) / Count again

Record a payout ​

  1. Open Administration › Affiliates and turn on Ready to be paid (or wait for the monthly email).

  2. Click Pay next to an affiliate.

  3. Copy the bank details into your bank and send the amount shown in Record a bank transfer.

  4. Back in Replora fill in the form:

    FieldNotes
    CurrencyOnly when something is due in more than one currency: pick the balance to pay
    Transfer referenceOptional, up to 120 characters (e.g. TRX-…)
    Paid onThe transfer's date, today or earlier (default today)
    NoteOptional, up to 500 characters; the affiliate sees it
    Proof of paymentOptional: the bank's receipt or statement, PDF, PNG, JPG or WebP, up to 10 MB. The affiliate can download it
  5. Click Record payout of …. Every due commission in that currency is marked Paid and the affiliate receives the email Your affiliate payout of … is on its way with the date and reference.

The payout always covers all commissions due in that currency; you can't pay part of a balance. The form is available whenever something is due, even below the smallest payout or in another currency.

Undo only when the transfer didn't happen

Undo deletes the payout and its proof, and its commissions become Due again. The affiliate already received the "payout on its way" email; there is no email for the undo.

To add the proof later, click Attach proof in the payout's row (a new file replaces the old one).

Refunds and chargebacks ​

Replora does not void commissions by itself when a payment is refunded. When you refund a referred customer:

  1. Open the affiliate and find the commission in Commissions.
  2. Click Void (refunded). It no longer counts in any total. Count again restores it.

Only unpaid commissions can be voided. That is what the holding period is for: set it longer than your refund window.

Pause an affiliate ​

Pause link stops a person from earning: new payments of their referrals earn nothing and their link no longer records clicks or credits new sign-ups. Everything already earned stays and can still be paid. The affiliate sees Your affiliate link is paused on their page. Resume link makes it earn again (payments made while paused are not credited afterwards).

What affiliates see ​

Account › Affiliate program (/affiliate). The menu item appears for everyone while the program is open.

Before joining, the page explains the terms (the rate, how long the link is remembered, for how many months, monthly bank transfers) and shows Join the affiliate program. Joining is instant, there is no approval step: every person who joins is active straight away. Each person has one affiliate record with a random 8-character code; joining again returns the same link.

After joining:

PartWhat it shows
Your referral linkThe link with Copy link. Any page works: ?ref=CODE can be added to any address of your website
StatsClicks, Sign-ups, Paying accounts, Held for n days, Due at the next payout, Paid to you
Where we pay youThe bank account (see below), with Change
Earnings per monthMonth, number of payments, amount earned
PayoutsDate, reference and note, amount, proof download
CommissionsDate, Account #id (affiliates never see the names of the accounts they referred), payment, rate, commission, state

Bank details form:

FieldRules
Account holderRequired, up to 120 characters
BankRequired, up to 120 characters
IBAN or account numberRequired, up to 64 characters (stored upper-case)
SWIFT / BICOptional, 8 or 11 letters and digits; needed for transfers between countries
CountryOptional, up to 60 characters
Notes for the transferOptional, up to 500 characters (e.g. a routing number)

Bank details are stored encrypted and only the affiliate and administrators see them.

The public page ​

While the program is open the website footer links to Affiliate program (/affiliate-program). The page is built from the settings: the commission and for how long, three steps (Get your link, Share it, Get paid every month), and answers about earnings, payment dates, the minimum and self-referrals. Become an affiliate leads signed-in visitors to /affiliate and others to /signup (they join from the dashboard after creating their account). While the program is closed the page returns Not found.

Emails ​

EmailToWhen
n affiliates are ready to be paidevery administratorThe 1st of each month at 09:00 (affiliates:payouts-due), only when the program is open and at least one affiliate is ready; lists the total per currency and links to the Affiliates page
Your affiliate payout of … is on its waythe affiliateWhen you record a payout

The monthly email needs the scheduler; emails need email delivery. Run the check by hand with:

bash
php artisan affiliates:payouts-due

Data and privacy ​

  • The referral cookie is sr_ref: it holds only the public code, is HTTP-only and expires after Link remembered for days. The latest link a visitor opened wins.
  • Download my data includes the person's affiliate code, rate, bank details and payouts.
  • Deleting a person deletes their affiliate record, payouts and proof files. Deleting an account deletes the affiliate records of its people. The account's own referral stays with its affiliate, so what was earned and paid keeps adding up.
  • Proofs are kept on the server's private disk (storage/app/affiliate-proofs) and only downloaded by the affiliate and administrators.

API ​

The pages use the REST API (/api/v1): GET/POST affiliate, PUT affiliate/bank, GET affiliate-payouts/{id}/proof, and for administrators GET admin/affiliates, GET/PATCH admin/affiliates/{id}, POST admin/affiliates/{id}/payouts, POST admin/affiliate-payouts/{id}/proof, DELETE admin/affiliate-payouts/{id}, POST admin/affiliate-commissions/{id}/void. See REST API: overview.

Replora: see what your visitors see.