Skip to main content
Referral tracking rewards customers for bringing new shoppers to your store. When a new customer makes their first purchase and mentions a referrer, you include the referrer’s code in the order, and Gameball rewards both parties based on your configured campaign rules.
Referral tracking is optional. If you don’t run a referral program, you can skip this page.

​
How It Works

Referrals are handled through the order submission flow. On the new customer’s first purchase, add a referrerCode to the order payload:

​
Referral Flow

1

Identify the new customer

Register the new customer with the Create Customer call (or let the order auto-create them).
2

Collect the referrer code

Capture the referrer’s code at checkout, entered manually by staff or scanned from a QR code.
3

Submit the order with the referrer

Include referrerCode in the order payload on the customer’s first purchase.
4

Gameball issues the rewards

Referral rewards are processed automatically based on your configured campaign rules.

​
Tips & Gotchas

  • Referral rewards are configured in your Gameball dashboard.
  • Both the referrer and the new customer may receive rewards, depending on your campaign settings.
  • Referral tracking must occur during the new customer’s first purchase.