Changelog

Stay up-to-date with the latest features, improvements, and fixes for Refgrow.

November 17, 2025
Feature Improvement
  • Webhook Payout Preferences: Enhanced webhook payloads to automatically include PayPal and Wise payout preferences for affiliates. When an affiliate has configured PayPal email or Wise payment details, these are now included in the referrer.payout_preferences field of all webhook events (referral_signed_up, referral_converted, referral_canceled). This eliminates the need for manual API enrichment steps, allowing finance systems to automatically process payouts directly from webhook data. Payout preferences are retrieved from both client_payment_settings table and custom attributes stored in the affiliates table.
November 4, 2025
Feature Improvement
  • Partner Referral Links: Launched partner referral link customization system enabling administrators to assign partner slugs to individual affiliates. When a partner slug is assigned, referral links automatically include the partner parameter (e.g., https://example.com?ref=CODE&partner=slugcompany). This allows clients to detect traffic from specific partners and customize their signup pages accordingly. Features include partner slug management in the affiliate management interface, automatic parameter inclusion in referral links across all tracking scripts (embed.js, tracking.js, multitracking.js), and persistent storage of partner parameters in localStorage and cookies for client-side customization. The partner parameter is passed through the entire referral tracking flow, from initial click through conversion tracking, enabling seamless integration with client-side registration page customization.
October 21, 2025
Feature Improvement
  • Advanced Search & Filtering System: Launched comprehensive search functionality across all management pages for faster data discovery and improved workflow efficiency. Features include intelligent live search with 500ms debounce for optimal performance, search across affiliates (by email and referral code), referrals (by referral email, affiliate email, and code), and coupons (by coupon code and affiliate email). Includes modern UI with search indicators, loading states, real-time result count badges, and clear/reset functionality. Search queries are preserved in URL for shareable filtered views and seamless navigation. Features context-aware empty states that distinguish between "no data" and "no results" scenarios, with quick clear options. Fully integrated with existing pagination and sorting systems, maintaining all filters across page changes and sort operations. Backend implementation uses case-insensitive partial matching for flexible search results.
September 2025
Feature Improvement
  • Advanced Widget Block Configuration System: Launched comprehensive widget customization system providing complete control over affiliate portal structure and appearance. Features include drag-and-drop block reordering with visual handles, individual hide/show toggles for all widget sections, granular sub-option controls for titles, descriptions, and specific elements within each block, real-time preview with instant updates, plan-based restrictions for premium features (commission levels, multi-tier, branding removal), comprehensive display options covering header, share links, statistics, daily stats, payment methods, payment history, commission levels, multi-tier commissions, exchange programs, and branding sections. Includes complete integration across both main design settings and onboarding flow, with persistent configuration storage in JSONB format and seamless application to the live widget via enhanced embed.js logic.
  • Multilevel Commission System: Launched advanced commission level system enabling affiliates to progress through multiple performance tiers. Features unlimited customizable commission levels with flexible progression criteria (earnings thresholds, referral counts, time-based achievements), sophisticated commission structures (percentage/fixed rates with lifetime/period/one-time durations), automatic level upgrades based on real-time performance monitoring, comprehensive level management interface with add/edit/delete functionality, detailed progress tracking and level overview in the affiliate widget, and optional integration with existing Multi-Tier system for complex commission hierarchies. Includes complete database schema with level tracking, achievement history, and multilevel commission transactions, plus automated cron job for periodic level checks and upgrades.
  • Dodo Payments Integration: Added complete integration with Dodo Payments payment system following the established patterns of Stripe, LemonSqueezy, Paddle, and Polar. Includes automatic webhook processing for payment.completed, subscription.created, subscription.renewed, subscription.updated, payment.refunded, and subscription.canceled events. Features secure HMAC-SHA256 signature verification, comprehensive affiliate attribution logic (referral codes via metadata, coupon-based attribution, email fallback), and seamless commission calculation.
August 2025
Feature Improvement
  • Automatic Coupon Generation System: Launched comprehensive auto-generation system for unique affiliate promotional codes. Project owners can enable this feature in project settings with configurable discount types (percentage or fixed amount), duration settings (forever, once, repeating), maximum redemptions, and Stripe product targeting. When enabled, each new affiliate automatically receives a personalized coupon code created in Stripe, while existing affiliates can generate their codes through the widget interface. Features intelligent form validation, comprehensive settings management, and seamless integration with existing coupon tracking systems. All auto-generated coupon conversions are automatically tracked and attributed to the corresponding affiliate.
  • Invoice Generation System: Launched automated tax-compliant invoice generation for affiliate payouts. Features EU VAT compliance with automatic tax-inclusive calculations, support for individual and business customers with VAT ID verification, configurable company information (name, address, VAT numbers), automated invoice numbering, and professional PDF generation. Handles complex VAT scenarios including reverse charge for intra-EU business transactions, local VAT rates for individuals, and tax-free transactions for non-EU customers. Includes comprehensive VAT calculation logic that automatically extracts net amounts from total payouts while maintaining compliance with European tax regulations.
  • White-Label Platform: Launched comprehensive white-label solution enabling partners to offer fully branded affiliate marketing services to their customers. Features include complete customer management system with project isolation, custom branding (logos, colors, domains), flexible multi-tier plan management with configurable limits and pricing, comprehensive team collaboration with role-based permissions (admin, manager, member), and advanced analytics dashboard with customer performance tracking. Partners can create unlimited customer accounts, each with isolated data and projects, while maintaining full control over branding and billing.
  • White-Label Customer Portal: Built dedicated customer-facing interface allowing white-label customers to manage their affiliate programs independently. Includes project creation and management, affiliate recruitment and tracking, conversion monitoring and analytics, payout processing, and complete integration setup guides. Customers operate within their assigned plan limits while enjoying seamless branded experience matching partner's identity.
  • Advanced Plan System: Implemented sophisticated subscription plan management with configurable limits for projects, affiliates, monthly conversions, API calls, and team members. Features include plan upgrade/downgrade workflows, usage monitoring with real-time limit enforcement, billing integration with multiple payment processors, and flexible commission settings per plan. Supports both fixed-price and percentage-based plans with custom billing periods.
  • Multi-Tenant Architecture: Redesigned core platform architecture to support complete data isolation between white-label accounts while maintaining performance and security. Each white-label customer operates in isolated environment with dedicated resources, custom domains support (CNAME), and independent billing cycles. Includes comprehensive audit logging, security controls, and compliance features for enterprise deployment.
  • Partner Management Dashboard: Created advanced administrative interface for white-label partners to manage customers, monitor platform usage, configure billing settings, customize branding elements, manage team permissions, and access detailed analytics across all customer accounts. Features include bulk operations, automated customer onboarding workflows, and comprehensive reporting tools for business intelligence.
  • Enterprise Integrations: Added support for enterprise-grade integrations including custom webhook endpoints, advanced API authentication, bulk data operations, automated customer provisioning, and integration with external billing systems. Includes comprehensive monitoring, logging, and alerting systems for reliable enterprise operations.
  • Coupons API: Added comprehensive REST API endpoints for managing affiliate coupons. New endpoints include GET /api/v1/coupons (list with filtering), POST /api/v1/coupons (create), GET /api/v1/coupons/:id (retrieve), PUT /api/v1/coupons/:id (update), and DELETE /api/v1/coupons/:id (delete). Supports coupon code management, affiliate association, and integration with Stripe and LemonSqueezy coupon systems. Includes complete API documentation with code examples in multiple languages (Node.js, Python, PHP, Ruby, cURL) and interactive language switcher.
  • Multi-Tier Commission System: Launched comprehensive two-tier affiliate program support, enabling affiliates to recruit sub-affiliates and earn commissions from their referrals. Features include configurable Tier 2 commission settings (percentage or fixed rates), customizable commission duration (lifetime or period-based), automatic parent-child relationship management, and comprehensive multi-tier earnings tracking. When a Tier 2 affiliate makes a sale, both the Tier 2 affiliate and their Tier 1 parent earn commissions.
July 2025
Feature Improvement
  • Enhanced Affiliate Details Modal: Added comprehensive affiliate details modal accessible by clicking on any affiliate row in the affiliates table. Features include performance summary (total clicks, signups, purchases, earnings), detailed conversion history table with filters by month/year and conversion type, monthly earnings breakdown with visual indicators, and complete transaction-level breakdown showing individual commissions and dates. Includes real-time filtering and chronological conversion timeline for better affiliate performance analysis.
  • Enhanced Referral Details Modal: Added detailed referral information modal accessible by clicking on any referral row in the referrals table. Features include referral summary (email, affiliate, join date), activity overview (total purchases and earnings), complete conversions history timeline showing first click date, registration date, and all subsequent payment dates with commission details, and full transaction transparency with references, coupons, and status tracking. Provides complete customer journey visibility from first click to conversion.
  • Conversion Approval System: Introduced manual approval/rejection system for conversions. Project owners can now enable manual approval in project settings, requiring new conversions to be approved before affiliates earn commissions. Features include pending/active/rejected conversion statuses, intuitive admin interface in the referrals page with approve/reject buttons, and automatic exclusion of non-approved conversions from earnings calculations. When manual approval is disabled (default), conversions are automatically approved. This feature provides enhanced control over commission payouts and helps prevent fraudulent or disputed conversions.
  • Hold Period Settings: Introduced configurable hold periods (0-365 days) that delay when affiliate earnings become eligible for payout. This feature protects against refunds, chargebacks, and subscription cancellations by ensuring commissions are only paid out after a safe waiting period. Affiliates now see both total earnings and payout-eligible earnings separately, with clear indicators of when held earnings will be released. Includes comprehensive admin controls, API integration with new earnings fields (eligible_earnings, held_earnings, next_release_date), and complete documentation at /docs/hold-periods.
  • Enhanced Wise Auto-Payouts: Significantly improved the Wise integration for automated affiliate payouts. Simplified the setup process. You can now set up payouts for your affiliates with ease.
  • Polar Payment Integration: Added complete integration with Polar payment system following the established patterns of Stripe, LemonSqueezy, and Paddle. Includes automatic webhook processing for subscription.created, subscription.updated, and subscription.canceled events. Features secure HMAC-SHA256 signature verification, comprehensive affiliate attribution logic (referral codes via metadata, coupon-based attribution, email fallback), and seamless commission calculation. Added Polar configuration to project onboarding and integration settings, plus complete documentation at /docs/polar with setup guides, implementation examples, and troubleshooting tips.
  • Paddle Payment Integration: Added complete integration with Paddle payment system following the established patterns of Stripe and LemonSqueezy. Includes automatic webhook processing for transaction.completed, subscription.created, and subscription.updated events. Features secure HMAC-SHA256 signature verification, comprehensive affiliate attribution logic (referral codes via custom data, coupon-based attribution, email fallback), and seamless commission calculation. Added Paddle configuration to project onboarding and integration settings, plus automatic referral code processing for Paddle payment links via Refgrow.processPaddleLinks() JavaScript helper. Includes complete documentation at /docs/paddle with setup guides, implementation examples, and troubleshooting tips.
  • Individual Affiliate Commission Duration Settings: Enhanced affiliate commission management with personalized duration settings. Now admins can set custom commission duration (lifetime, first purchase, limited period) for each affiliate individually, alongside existing commission type and value overrides. Includes complete UI integration in affiliate management modal with period specification for limited duration commissions. Applies affiliate-specific duration rules in conversion processing logic, allowing precise control over how long each affiliate earns commissions from their referred customers.
June 2025
Feature Improvement
  • Webhooks System: Launched complete webhook infrastructure for real-time event notifications. Supports configurable events (referral signup, conversion, cancellation) with secure HMAC-SHA256 signatures for authenticity verification. Features automatic retry logic (3 attempts), comprehensive delivery logging with status codes and error messages, and an intuitive testing interface directly from the project settings. Includes detailed English documentation at /docs/webhooks with implementation examples, security best practices, and troubleshooting guides.
  • Manual Affiliate Creation & Management: Introduced comprehensive manual affiliate management system. Admins can now directly create affiliates through the dashboard with email specification, automatic or manual referral code generation, and payment method configuration. Added full editing capabilities for existing affiliates including updating email addresses, referral codes, and payment settings. Includes validation for email uniqueness and referral code conflicts within projects.
  • Team Collaboration & Multi-User Access: Launched comprehensive team collaboration features. Project owners can now invite team members via email with automatic account creation. Enhanced invitation system with robust link handling, Google OAuth integration, and secure token-based authentication. Team members gain full project access while maintaining role-based permissions.
  • Reference Parameter Support: Added optional reference parameter to manual conversion tracking. Track conversions with custom identifiers using Refgrow(value, type, email, { reference: "ORDER-123" }). References are stored with conversions and displayed in dashboard for easy order matching and reconciliation.
  • Anti-Manipulation Protection: Implemented comprehensive protection against referral attribution manipulations. The system now prevents existing users (direct customers, previous referrals, or users with purchase history) from being retroactively attributed to affiliates. This blocks self-referral schemes and ensures only legitimate new referrals are tracked. Includes automatic detection of direct customers attempting to become referrals and server-side validation that cannot be bypassed.
  • Enhanced Existing User Detection: Added intelligent detection of users who were already in the system before clicking referral links. The system checks multiple data sources (referred_users, conversions, direct signups) to prevent attribution gaming.
  • Automatic Cookie Cleanup: When manipulation attempts are detected, the system automatically clears referral cookies and localStorage to prevent continued tracking of blocked users.
  • Detailed Logging & Diagnostics: Enhanced logging with specific reasons for blocking (direct customer, existing user, conversion history) to help administrators understand attribution decisions.
May 2025
Feature Improvement
  • Smart Trial Handling: Enhanced webhook processing to automatically ignore trial subscriptions and orders with $0 amount. Commissions are now only triggered for actual paid conversions, ensuring affiliates are rewarded only for genuine purchases.
  • Secure Public API & Optional Project Secret: Enhanced the security of public-facing API endpoints used by the embeddable widget. Introduced an optional project_secret for each project, which, if set, requires requests to /api/referral-data and other widget-related endpoints to be authenticated via an Authorization: Bearer <secret> or X-Project-Secret: <secret> header. If a project does not have a project_secret configured, the API remains accessible without this specific token. Updated embed.js to send the secret if provided via data-project-secret. Added UI in project settings to generate/manage this secret key.
  • Coupon Tracking System: Implemented a comprehensive coupon tracking system. Conversions can now be attributed to affiliates via unique coupon codes. This works for Stripe (matching Stripe Coupon IDs), LemonSqueezy (matching LemonSqueezy Discount Codes), and manual conversion tracking via `Refgrow(value, type, email, couponCode)`. Includes UI for managing coupons (add, edit, delete) per project.
April 2025
Feature Improvement Fix
  • Enhanced Auth Form UI: Redesigned the affiliate email authentication form in the embeddable widget (`embed.js`) with a modern, responsive two-column layout for improved user experience and visual appeal.
  • Multicurrency Support: Added the ability to select the display currency symbol ($, €, £, etc.) in project settings. This symbol is now used across the dashboard and embeddable widget.
  • Referral Exchange (Beta): Launched the Referral Exchange system, allowing Refgrow users to cross-promote programs. Includes a credit system (+1 for sending an affiliate, -1 for receiving), a public directory of participating programs (`/affiliate-programs`), and configuration options within project settings (enable/disable, listing details, credit purchase).
  • Exchange Widget Integration: The embedded affiliate widget (`embed.js`) now includes a block to discover other exchange programs. Display modes include a simple text link or a preview of recommended programs.
  • Localization Support: Added multi-language support for the embedded affiliate dashboard. Project owners can set a default language, and users can override it via the `data-lang` attribute in the embed code. Added initial translations for English, Romanian, Ukrainian, German, Spanish, French, Italian, and Portuguese.
  • Anonymous Payment Tracking: Added support for tracking payments without requiring user registration (via direct code integration with duplicate prevention to avoid conflicts with Stripe events).
  • Affiliate-Specific Commissions: Added the ability to set custom commission rates (percentage or fixed) for individual affiliates, overriding project defaults. Includes UI management within the project affiliates section.
  • Stripe Product ID Commissions: Introduced the ability to set specific commission rates based on the Stripe Product ID, allowing overrides for different products within a project.
  • REST API V1 Launch: Introduced a public REST API (v1) allowing programmatic access to manage affiliates and referrals. Includes API Key authentication.
  • API Documentation: Added comprehensive API documentation site including an overview, endpoint references, and guides (accessible via `/docs`).
  • Cookie Lifetime Setting: Added the ability to configure the cookie lifetime in days through project settings, giving more control over how long referral attributions remain active.
  • Custom Referral Link Parameter: Introduced support for customizing the URL parameter used in referral links, allowing projects to use their preferred parameter name instead of the default.
March 2025
Feature Improvement Fix
  • LemonSqueezy Integration: Added automatic conversion tracking via LemonSqueezy webhooks.
  • Manual Affiliate Approval: Added an option within project settings to require manual approval for new affiliates joining a program.
  • Embedded Dashboard Customization: Users can now customize the primary, secondary, and font colors of the embedded affiliate portal via project settings to better match their application's branding.
  • Mass Payouts (Beta): Introduced an initial version for processing payouts to multiple affiliates simultaneously.
  • Dark Mode Preset: Added a dark mode preset option for the embedded affiliate portal, allowing users to quickly apply a dark theme without manually configuring individual color settings.
February 2025
Feature Improvement Fix
  • Cross-Domain Tracking: Improved the `tracking.js` script to better handle scenarios where affiliate signups or purchases occur on a different domain than the initial referral click, relaxing strict domain checks for conversion tracking when initiated via `window.Refgrow(...)`.
  • Enhanced Analytics: Improved data points available in the dashboard and refined conversion tracking logic for accuracy.
  • Stripe Webhook Integration: Added comprehensive webhook handling for Stripe events, enabling automatic conversion tracking and commission calculations for all payment types.
  • Stripe Integration: Added support for Stripe's `invoice.paid` event to track recurring payments and calculate commissions for ongoing subscriptions.
~Late 2024 / Early 2025
Launch
  • Refgrow launched with core features including project creation, Stripe integration (initial checkout tracking), embeddable affiliate portal (`embed.js`), referral link tracking (`tracking.js`), basic commission structures (percentage/fixed, lifetime/first), and user management (Email/Pass, Google OAuth, Magic Link).

Try Refgrow for free today

Turn referrals into your most valuable growth channel

Try Refgrow for Free