Referral & Affiliate Program changelog
All notable changes to Referral & Affiliate Program (kv_referral_program) are documented here.
The format follows Keep a Changelog and the project uses Semantic Versioning.
[Unreleased]
Section titled “[Unreleased]”[1.0.0] - 2026-10-22
Section titled “[1.0.0] - 2026-10-22”- Personal referral link and code for every customer; any store page can be a link target; codes editable in the admin panel.
- Consent-aware link tracking (cookie with the Cookie Consent Mode add-on, browsing session without consent), first or last click, attribution window, click statistics; full page cache safe.
- Refer a friend page with copy and share buttons, e-mail invitations with limits, friends and rewards; welcome bar and referral code field for invited visitors.
- Welcome coupon for friends (single-use codes of a core promotion with auto-generated coupons).
- Referrer reward as store credit (Store Credit Wallet add-on), reward points or a coupon, fixed or percent of the first order, after a paid status and a hold period; reversal on refund and cancel statuses.
- Fraud checks: same e-mail, IP, address, phone or payer name, duplicate friends, existing customers; monthly and total caps; minimum first order; manual approval or automatic rejection of flagged entries.
- Affiliate program: application form with terms, admin approval or automatic approval, suspension, commissions in percent or fixed per checkout, rates per category and per affiliate, new-customers-only option, link builder and dashboard.
- Payout requests with a minimum, mark paid with a reference, rejection, store credit payouts; negative adjustments for refunds after a payout.
- Admin: ledger with bulk approve/reject and CSV, affiliates, affiliate page, payouts with CSV, category rates, referrers; scheduler with cron, cron URL and admin fallback.
- E-mails: invitation, welcome coupon, reward earned, affiliate status, payout, admin notice.
- Read-only REST API (
/api/kv_referrals,/api/kv_affiliates) and a small PHP API. - Multi-Vendor: one reward per split checkout, one commission per vendor order, vendor payouts unchanged.