Skip to main content

AI Bot #4 — Merchant Referral Tracking

Purpose: When a referred merchant signs up using a unique referral link, automatically log the referral in HubSpot under the referring merchant's record, trigger the credit notification to the referring agent, and enroll the referred merchant in the onboarding sequence.


Tech Stack

ComponentToolNotes
Unique referral linksHubSpot or dedicated referral toolOne unique link per merchant. Confirm tooling with coordinator — see Open Item #10.
TriggerZapier — new merchant signup via referral link
CRM actionHubSpot — log attribution, update referring merchant record
NotificationEmail to referring agent — credit confirmation

Open items blocking this bot:

  • Open Item #10: Referral link tool must be selected (HubSpot native referral tracking, ReferralHero, or equivalent) — confirm with Ben + Coordinator

Referral Program Rules

RuleDetail
Referrer incentive1 month SaaS fee credit per referral that becomes a paying merchant
Referee incentiveFirst month free
Tier bonusMerchant who refers 3+ paying customers: permanent 10% discount on monthly SaaS fee
Attribution windowReferral link click to signup must occur within 30 days (confirm window with Ben)

Credit Notification Email (to referring agent)

Sent automatically by Zapier when a referred merchant completes signup.

Subject: Your referral credit — [Referred Merchant Name] just signed up

[Referring Agent Name],

[Referred Merchant Name] just signed up for PeakPOS using your referral link. One month credit has been applied to your account.

[If 3rd+ referral, include:]
You've now referred [N] paying merchants. Your permanent 10% discount has been activated on your monthly plan.

— The PeakPOS Team

Zapier Workflow Steps

  1. Referred merchant clicks unique referral link and completes signup
  2. Zapier trigger: new contact created in HubSpot with referral source tracked
  3. Zapier looks up referring merchant's HubSpot contact record by referral link ID
  4. Zapier logs referral: adds referred merchant name and date to referring merchant's Referrals property
  5. Zapier checks referral count:
    • If count >= 3: flag for tier bonus activation (permanent 10% discount)
  6. Zapier sends credit notification email to referring agent
  7. Referred merchant enrolled in post-referral onboarding email sequence

HubSpot Data Model

Properties to set/update on the referring merchant's contact record:

PropertyAction
ReferralsAppend: "[Referred Merchant Name] — [Date]"
Referral CountIncrement by 1
Tier Bonus ActiveSet to Yes if Referral Count >= 3

Properties to set on the referred merchant's contact record:

PropertyAction
Referred BySet to referring merchant name/ID
Referral DateSet to signup date
First Month FreeSet to Yes
EnrollmentPost-referral onboarding email sequence