Referrals & Affiliates

Refer developers to Hanzo Cloud and earn. Every referral gives credits to both you and the person you invite, and as your referrals grow you become an affiliate -- earning ongoing commission on the usage you drive. Manage your link, track invites, and watch earnings from the Referrals and Affiliates tabs in the Console.

Link, Invites, and Earnings

The Referrals surface has three parts:

• Referral link -- your unique code, shareable as https://hanzo.ai/signup?ref=YOUR_CODE. It is generated automatically with your account.
• Invite history -- everyone who signed up with your code, and whether each has completed a qualifying billable action.
• Cloud-credit earnings -- credits earned per referral plus accrued revenue share, all settling into your Billing balance.

Credits land in the same balance every product spends from, so referral earnings directly offset usage.

Get Your Link and Stats

Referral operations are served under /v1 on the gateway. Authenticate with an API key (hk-...):

# Create (or fetch) your referral link
curl -X POST https://api.hanzo.ai/v1/referrer \
  -H "Authorization: Bearer hk-..." \
  -H "Content-Type: application/json" \
  -d '{ "channel": "blog" }'

{
  "code": "zach42",
  "url": "https://hanzo.ai/signup?ref=zach42",
  "channel": "blog"
}

Fetch your tier, invite counts, and earnings from your referrer profile:

curl https://api.hanzo.ai/v1/referrer/me \
  -H "Authorization: Bearer hk-..."

A referral qualifies once the invited user completes at least one billable action, which guards against fake signups. For tiers, revenue-share rates, and payout rules, see Hanzo Referral.

Affiliates

Referrals give both sides a one-time credit. Affiliates go further: you earn an ongoing commission -- a percentage of the referred user's spend -- for as long as they keep using the platform. Commission unlocks automatically as your qualified referral count climbs into the higher tiers, and it settles into your Billing balance on the first of each month alongside your referral credits.

This makes affiliates a fit for content creators, agencies, and anyone driving real, recurring usage rather than one-off signups. Manage your commission rate, referred-spend attribution, and payouts from the Affiliates tab in the Console. Full tier thresholds, revenue-share percentages, and fraud rules live in Hanzo Referral.

Related

• Getting Started -- what new referred users get ($5 free to start)
• Billing -- where referral credits and affiliate commission settle
• Hanzo Referral -- tiers, revenue-share rates, and payout rules
• Console -- the Referrals and Affiliates tabs for links, invites, and earnings
• API Keys -- credentials for the referral API
• API -- the full REST reference