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
- Connect your Square account so ViralRef can see when referred customers make purchases and issue gift card rewards
- Create a referral program with your reward rules and structure
- Add referrers (your staff, customers, influencers) or turn on the viral loop so new customers become referrers automatically
- Share referral links with your referrers and customers
- Purchases are tracked automatically — when a referred customer pays at your business, ViralRef sees it instantly
- 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
| Guide | Description |
|---|---|
| Getting Started | Account setup and first program |
| Connecting Square | Linking your Square account |
| Creating a Program | Reward types, commission rules, and scopes |
Core Features
| Guide | Description |
|---|---|
| Managing Affiliates | Add referrers, create groups, set tiers |
| Tracking Conversions | How referred purchases are tracked |
| Payouts | Gift card rewards and payout management |
| Viral Loop | Automatic referrer enrollment for every new customer |
Advanced
| Guide | Description |
|---|---|
| Affiliate Portal | Self-service dashboard for your referrers |
| Bounties & Challenges | Run time-bound incentive campaigns |
| Fraud Detection | Automatic fraud protection and review |