Skip to content
Affiliatetrackingo

Refer-a-Friend Widget

Turn every customer into a referral partner

In-app referrals with double-sided Stripe rewards.

app.acme.com/settingsGive 20%, get a month freeFriends get 20% off their first year.acme.com/?via=samCopy linkCopied ✓Copy linkFriends referred23Free months earned12Pending rewards010Open full dashboard →FRIEND · CHECKOUTAcme Pro · yearly$490.00SAM20 · 20% off$392.00SubscribePaid ✓ · coupon appliedDiscount added to the Stripe customerSAM · REWARDNext chargeNov 12Dec 12+1 free monthtrial extension
A customer opens the in-app widget, shares their link with a friend, the friend receives a discount coupon at checkout, and the referrer's account is credited with a free month.

A customer opens the in-app widget, shares their link with a friend, the friend receives a discount coupon at checkout, and the referrer's account is credited with a free month.

01 /Overview

Turn every customer into a referral partner.

Embed the referral widget in your app and every logged-in user gets a personal link, without a separate signup. Their friends get your discount applied in Stripe automatically, and the referrer earns cash, account credit, free months on their own subscription, or points.

02 /How it works

How refer-a-friend widget works, step by step.

  1. 1

    Mint a token

    Your server calls POST /v1/embed-tokens for the logged-in user; they're enrolled on first use.

  2. 2

    Load the widget

    Your page loads embed.js with the token. Use the iframe or build your own UI from the JSON endpoint.

  3. 3

    Reward both sides

    The friend's discount becomes a Stripe coupon on their customer record; the referrer's reward is applied when approved.

03 /In depth

Everything you need to know about refer-a-friend widget.

Rewards customers actually want

Pay referrers in cash, credit their Stripe customer balance, push their next charge back by free months, or give points they spend on your rewards catalog. Refunds take any of these back automatically.

Double-sided discounts, automatic

The campaign's discount for referred customers becomes a Stripe coupon and is attached to the referred customer as soon as they're linked. Affiliate promo codes become real Stripe promotion codes.

Secure by construction

The embed token is only ever sent in a header, never in a URL. 'Open full dashboard' trades it for a single-use link valid for a minute. The widget is the only page allowed inside other sites' frames.

04 /FAQ

Questions about refer-a-friend widget.

Do customers need to create an affiliate account?

No. They're enrolled in the embed-enabled campaign the first time the widget loads for them.

Can I build my own referral UI?

Yes. GET /v1/embed/me returns the same data the widget shows, authorized with the embed token.

Which billing systems support free-month rewards?

Free months extend the referrer's own Stripe subscription as a trial extension, so rewards add up and nothing is prorated.

05 /Related

Works even better together.

Ready to grow through partners?

Connect your billing, add one script tag and invite your first partners. Import affiliates, codes and history from Rewardful, FirstPromoter, Tolt or a CSV.