Referral API

Referral infrastructure for SaaS

Ship referral revenue without building referral infrastructure

Referral links, attribution, commissions, and payout reconciliation — one API and dashboard. Customize rules, keep payout control.

Start for $0.99Read the docs

$0.99 paid trial for 14 days. Full engine on every plan. No free tier.

  • $0.99 · 14-day trial
  • Test & live keys
  • Full engine on every plan
  • Commission ledger included

Build vs buy

Your product deserves referrals. Your roadmap does not deserve referral plumbing.

Building in-house

  • Attribution edge cases and race-safe claims
  • Multi-level and recurring commission rules
  • Refund, chargeback, and reversal ledgers
  • Payout reconciliation across CSV and API

Months of engineering before your first referred dollar.

Plugging in Referral API

  • Browser SDK plus server-side capture
  • Dashboard rules for codes, levels, and delays
  • Auditable commission balances out of the box
  • Referrer reporting API for your own UI

Integrate in an afternoon. Launch a program this week, not this quarter.

Built for indie SaaS, AI apps, and developer-led teams outgrowing spreadsheets — not enterprise partner platforms.

Integration path

Six calls between first click and commission owed

Test keys first. Same flow in production when you are ready.

  1. 01

    Capture referral intent

    Browser SDK or server-assisted capture stores attribution.

  2. 02

    Sync the signed-in user

    Create users with your immutable external_user_id.

  3. 03

    Claim attribution

    Lock the referrer relationship at signup.

  4. 04

    Send payment events

    Report payment.succeeded with stable event IDs.

  5. 05

    Render referrer reports

    Pull balances and history from the reporting API.

  6. 06

    Go live

    Switch to live keys after the full loop works in test.

What you get

Referral infrastructure, not a partner program platform

Full core engine on every plan. Limits scale with referred revenue — not with ledger accuracy.

Multi-level & recurring commissions

Percentage or fixed rules across up to three levels, including recurring and first-N payment windows.

Refund & chargeback reversals

Immutable ledger entries with linked reversals — not silent edits.

Referrer reporting API

Build your own in-app referral dashboard with summaries, lists, and time series.

Code templates & aliases

Merchant-selected generation policies plus one successful customization per referrer.

Live & test isolation

Separate keys, data, and allowances. Prove the loop before you flip live.

Payout reconciliation

Manual entry, CSV preview-before-confirm, and API recording on Growth and above.

Provider-agnostic events

Send subscriptions, payments, refunds, and chargebacks from any billing stack.

For developers

Drop in the SDK. Wire the server. Ship.

Public keys stay in the browser. Secret keys stay on your server. OpenAPI, TypeScript helper, and copy-paste AI install prompts included.

QuickstartInstall with AIOpenAPI JSON
<script
  src="https://referralapi.dev/sdk/v1.js"
  data-key="rapi_pk_test_REPLACE_ME"
  data-api-base="https://referralapi.dev"
></script>

// After signup, from your server:
await referralApi.referrals.claim({
  external_user_id: user.id,
  attribution_token: storedToken,
});

Plans that grow with your business

Start with a 14-day trial for $0.99. Every plan includes the full referral engine—choose the capacity that fits your growth.

Starter

Launch a powerful referral program without the enterprise price tag.

$19/month

Billed monthly

Try for $0.99Try ReferralAPI for 14 days

Then $19/month unless you change or cancel.

  • $5,000 referred revenue/month
  • 100 active referrers
  • 5,000 tracked users
  • 25,000 referral clicks/month

Starter includes:

  • Multi-level referrals
  • Recurring commissions
  • Refund and chargeback tracking
  • Advanced analytics
  • Payout reconciliation
  • Standard support

Growth

Most popular

Turn referrals into a serious, repeatable growth channel.

$59/month

Billed monthly

Try for $0.99Try ReferralAPI for 14 days

Then $59/month unless you change or cancel.

  • $40,000 referred revenue/month
  • 1,000 active referrers
  • 50,000 tracked users
  • 250,000 referral clicks/month

Everything in Starter, plus:

  • More room to grow
  • Higher rate limits
  • Priority support

Scale

Built for high-volume referral programs ready to scale.

$99/month

Billed monthly

Try for $0.99Try ReferralAPI for 14 days

Then $99/month unless you change or cancel.

  • $100,000 referred revenue/month
  • 4,000 active referrers
  • 200,000 tracked users
  • 1,000,000 referral clicks/month

Everything in Growth, plus:

  • Serious referral capacity
  • Maximum rate limits
  • Priority support

FAQ

Straight answers before you integrate

Is there a free tier?

No. Referral API uses a paid trial — $0.99 for 14 days — so you can run a real integration in test mode before committing to a recurring plan.

Does Referral API send payouts to referrers?

No. Referral API tracks attribution, calculates commissions, and reconciles what you report as paid. You execute payouts through your own bank, PayPal, or payout stack.

How is this different from a partner platform?

Referral API is API-first referral infrastructure — links, attribution, ledgers, and reporting. It is not an affiliate marketplace, CRM, contract portal, or payout processor.

Do you send outbound webhooks?

Not in V1. You push subscription and payment events to Referral API. Integration is request-driven through the REST API and browser SDK.

How many apps can one account run?

One merchant account equals one app and one referral program. Spin up a separate account for another product.

What happens after the trial?

Your selected plan continues at its recurring price. Trial allowances equal 10% of the plan limits for 14 days with the full feature profile.

Ready when you are

Launch a referral program without rebuilding the engine

Start in test mode, prove attribution and commissions, then switch to live keys. Referral links. Attribution. Commissions. Done.

Start for $0.99Read the docs