Ripllo Affiliator Docs
⌘K

Programs

A program is an affiliate offer published by a merchant: "promote our store and earn X% commission". The Programs page at /affiliators/dashboard/programs lists every open program you can join.

What a program looks like

Each program card shows:

  • Name and description — the brand's pitch.
  • Commission rate — what percentage you earn per sale. Stored as a decimal (0.10 displays as 10.0%).
  • Cookie days — the attribution window. If a buyer clicks your link and converts within this many days, you get credit. Common values: 7, 14, 30.
  • Min follower count (if set) — minimum audience size the program expects.
  • Required audience countries (if set) — list of ISO country codes the program targets. If your profile country isn't in the list, your enrollment drops to manual review.
  • Auto-approve vs manual review — whether the merchant trusts the floor checks (auto-approve) or wants to review every enrollment (manual).
  • Requires KYC — some programs gate enrollment on verified KYC.

Joining a program

Click Join program on any card. Ripllo runs three checks before deciding:

  1. Program status — must be open. Paused or closed programs reject.
  2. Profile exists — you must have a created affiliator profile.
  3. KYC — if the program is requiresKyc: true, your KYC must be verified.

If those pass, Ripllo evaluates the floor checks:

  • If minFollowerCount is set and your audienceSize is below it, your enrollment drops to pending.
  • If requiredAudienceCountries is set and your country isn't in the list, your enrollment drops to pending.
  • If neither floor is set or you clear both, and the program is autoApprove: true, your enrollment activates immediately.

What happens on join

When enrollment is active (auto-approve passed all floors):

  • Ripllo mints an AffiliateLink with a unique 8-character code.
  • A success notice shows your code: "You're in! Your code: ABCD1234 — share it to earn commission."
  • The link appears in My links immediately, ready to share.

When enrollment is pending (manual review or floor check failed):

  • The notice says "Enrollment pending merchant review."
  • No code is minted yet — codes only mint when the enrollment activates.
  • The merchant reviews and either approves (enrollment → active, code mints) or rejects (enrollment → rejected).

Enrollment statuses

  • pending — awaiting merchant review.
  • active — you can use the code; clicks and conversions track.
  • rejected — merchant declined.
  • revoked — merchant disabled your enrollment after the fact (rare; usually ToS violations).

Once an enrollment exists, you can't re-enroll in the same program. The first attempt holds — if it's pending, that's where it stays until the merchant acts.

Commission models

Each program declares a commissionModel. The dashboard renders it under the link summary on My links. Common values:

  • percent_gmv — a percentage of the gross merchandise value (cart total).
  • flat_per_conversion — a flat IDR amount per conversion.

The rate (commissionRate) is interpreted relative to the model — a 0.10 rate on percent_gmv means 10% of GMV; on flat_per_conversion it means Rp 0.10 per conversion (uncommon, but possible).

Every program has a cookie days value. When a buyer clicks your share link, Ripllo's /r/<code> redirect stamps a tracking cookie on their device. If they convert within cookieDays, the commission attributes to you.

The cookie window is also enforced server-side via the buyer's code query parameter — even if they clear cookies, entering the code at checkout still attributes the redemption.

What's next

  • Links — your active codes and the share URLs to drop in your bio.
  • Earnings — track commissions as they accrue.