Products

A Product represents your application or service in RefRef. Each product has its own API credentials, programs, participants, and configuration settings.

How It Works

Create product: Set up a product within your organization
Get API credentials: Receive clientId and clientSecret for authentication
Configure settings: Set up app type and other settings
Integrate: Use API credentials in your application

Creating a Product

Create a product through the RefRef dashboard during onboarding or from the Products page.

Required fields:

Name: Your product or application name (1-100 characters)
URL: Your product's website URL

Optional onboarding fields:

App Type: Type of application (SaaS, E-commerce, Subscription, etc.)

Auto-generated:

Slug: Unique URL-friendly identifier (7 characters, auto-generated)
Client ID: API authentication identifier
Client Secret: API authentication secret (shown only once during creation)

Important: Save your clientSecret immediately after product creation. It is only shown once and cannot be retrieved later. If lost, you'll need to regenerate credentials.

Configuration

Configure your product settings in the RefRef dashboard:

Basic Settings:

Name: Update product display name
URL: Update product website URL
Logo: Upload product logo (optional)

Integration Settings:

App Type: Select your application type (affects onboarding recommendations)

Onboarding:

Onboarding Step: Track current onboarding progress (1-4)
Onboarding Completed: Boolean flag indicating setup completion

Onboarding Flow

New products go through a 4-step onboarding flow:

Step 1: Create organization (if needed) Step 2: Create product with basic details Step 3: Configure app type and settings Step 4: Complete setup and receive API credentials

Tracking onboarding progress:

onboardingStep: Current step number (1-4)
onboardingCompleted: true when all steps are finished

Updating Product Settings

Update product information via the RefRef dashboard:

Navigate to Settings → Product
Update name, URL, or other settings
Click Save Changes

What you can update:

Name: Product display name (1-100 characters)
URL: Product website URL (must be valid URL)

Product slug and API credentials cannot be changed after creation. Create a new product if you need different credentials.

Multiple Products

Organizations can have multiple products:

Use cases:

Multiple Applications: Different products for each app you manage
Brand Separation: Different products for different brands

Each product has its own:

API credentials (clientId, clientSecret)
Programs and reward rules
Participants and referral data
Events and analytics

Organizations - Manage your organization and team members
Programs - Create referral and affiliate programs for your product
Widget - Embed the RefRef widget using your product credentials
Attribution Script - Track referral codes in your application