Ripllo Affiliator Docs
⌘K

Links

A link is your tracking code for one program. Every active enrollment has exactly one link; every click and conversion against that link attributes to you. The Links page at /affiliators/dashboard/links lists all your codes.

Each link card shows:

  • Program name — the brand running this offer.
  • Commission rate and model — e.g. 10.0% · percent gmv.
  • Enrollment status — usually active once you have a link.
  • Promo code — the string buyers type at checkout to redeem.
  • Share link — a clickable URL you drop in posts, bios, DMs.
  • Clicks — total clicks across the share URL.
  • Conversions — successful redemptions / sales.
  • GMV — gross merchandise value attributed to your link, in IDR.

You get two surfaces, and which one to use depends on where you're sharing:

Promo code

The promo code is the bare string — something like MAMBO4K9X. It's 8 characters, alphanumeric, and uppercase. Buyers paste it at checkout to redeem.

Use the code in:

  • TikTok captions ("use code MAMBO4K9X at checkout for 10% off")
  • IG bios and Story stickers
  • YouTube video descriptions
  • Email newsletters where a clickable link isn't appropriate

The share link drops buyers on the merchant storefront with attribution pre-applied. There are two flavours:

  • LinkSnap-shortened URL — if the merchant has LinkSnap configured, Ripllo mints a short URL at link creation. Cleaner-looking, brandable.
  • Ripllo fallback — https://ripllo.com/r/<CODE>. Used when LinkSnap isn't configured or was unreachable at mint time. Still works perfectly.

Both URLs redirect (302) to the merchant's targetUrl with ?code=<CODE> appended, so the storefront knows which affiliator to credit. The fallback redirect also bumps your clicks counter in real time.

Use the share link in:

  • Bio links (Linktree, Beacons, your portfolio site)
  • Blog posts and SEO content
  • Discord channel pinned messages
  • DMs where a tap-to-shop is friendlier than typing a code

Use both. The promo code earns you credit even if the buyer doesn't click your link. The share link earns you credit even if they don't remember the code at checkout. Belt and braces.

Attribution and UTM

The Ripllo fallback redirect at /r/<code> does the simplest possible thing: it appends ?code=<CODE> to the merchant's target URL and 302s. If the target already has query params, the code joins as an additional param.

The merchant's storefront reads the code param at checkout and stamps it on the resulting order, which Ripllo turns into a commission row (see Earnings).

UTM parameters are merchant-side — Ripllo doesn't inject UTMs. If you want UTM-tagged links, paste a UTM-tagged version of the merchant's URL into LinkSnap directly and share that.

Click counter

Every hit on ripllo.com/r/<code> increments your clickCount as a fire-and-forget update. If LinkSnap is serving the short URL, LinkSnap counts the click on its side; Ripllo's counter only reflects fallback-redirect hits. The conversion counter and GMV come from the merchant's storefront firing a redemption event back to Ripllo.

Inactive or revoked codes

If a discount code attached to your link is deactivated (active: false on the merchant side), the redirect returns a 410 Gone with "this affiliate code is no longer active". Same for revoked enrollments — the underlying code is disabled.

If a program hasn't configured a storefront URL, the redirect returns a 503 with "this program has no storefront URL configured". Ping the merchant if you see this.

Awaiting approval

If your enrollment is pending (manual review or floor check failed), your link card shows "Awaiting merchant approval — your code will appear once approved." No code, no share URL. The card stays in this state until the merchant activates your enrollment.

What's next

  • Earnings — see commissions accrue from clicks and conversions.
  • Programs — join more programs to mint more codes.