Docs
Introduction

Introduction

Everything you need to know about setting up and running your referral program with ViralRef.

ViralRef is a referral platform built for Square merchants. It turns your existing customers into a growth engine by giving them unique referral links, rewarding them with Square gift cards, and automatically tracking every new customer they bring in.

This documentation covers everything from initial setup to advanced features like challenges and fraud protection.

What Can ViralRef Do for Your Business?

  • Create referral programs where you choose how much referrers earn (a percentage or a flat amount)
  • Reward your referrers automatically with Square gift cards or track payouts manually
  • Track new customers in real time as referred customers make purchases at your business
  • Turn every new customer into a referrer with the viral loop — they get a gift card and their own referral link automatically
  • Organize referrers into groups and tiers with custom reward rates for your top performers
  • Run challenges and contests to motivate referrers during specific time periods
  • Catch cheating automatically — ViralRef detects self-referrals, duplicate charges, and suspicious activity
  • Give referrers their own dashboard where they can see their link, track their earnings, and share with friends

How It Works

  1. Connect your Square account so ViralRef can see when referred customers make purchases and issue gift card rewards
  2. Create a referral program with your reward rules and structure
  3. Add referrers (your staff, customers, influencers) or turn on the viral loop so new customers become referrers automatically
  4. Share referral links with your referrers and customers
  5. Purchases are tracked automatically — when a referred customer pays at your business, ViralRef sees it instantly
  6. Rewards are issued as gift card balance top-ups or tracked for you to pay out manually

Getting Started

If you're new to ViralRef, start here:

Getting Started

Set up your account and launch your first referral program in minutes.

Connecting Square

Link your Square account to enable payment tracking and gift card rewards.

Creating a Program

Set up your reward rules, choose your commission type, and configure your program.

Documentation Overview

Setup

GuideDescription
Getting StartedAccount setup and first program
Connecting SquareLinking your Square account
Creating a ProgramReward types, commission rules, and scopes

Core Features

GuideDescription
Managing AffiliatesAdd referrers, create groups, set tiers
Tracking ConversionsHow referred purchases are tracked
PayoutsGift card rewards and payout management
Viral LoopAutomatic referrer enrollment for every new customer

Advanced

GuideDescription
Affiliate PortalSelf-service dashboard for your referrers
Bounties & ChallengesRun time-bound incentive campaigns
Fraud DetectionAutomatic fraud protection and review