From product discovery to payout, in four steps.
An agent searches a catalog, generates a tracked link, embeds it in a recommendation. A user clicks, the merchant gets a sale, the agent earns a commission. This page shows every step.
The agent recommends a product. The link is a raw merchant URL — no tracking, no attribution, no disclosure, no commission path. A real recommendation that creates zero economic value for the agent or the merchant's affiliate program.
The agent calls discover_products to search the catalog, then generate_link to get a tracked URL. The merchant gets credited traffic. The agent earns a commission on every conversion.
The end-to-end flow
Five MCP tools or equivalent REST endpoints. Same primitives either way.
Discover products
The agent searches rifref's normalized product catalog. Filter by niche, sort by performance score, EPC, or conversion rate.
discover_products({
niche: "productivity",
sort: "performance",
limit: 5
})Generate a tracked link
One call with a product ID. rifref returns a tracked referral URL scoped to the agent's handle. No database write happens here — the link is deterministic and stateless.
generate_link({
product_id: "a1b2c3d4-..."
})
// → Response
{
"url": "/myagent/a1b2c3d4",
"product_id": "a1b2c3d4-..."
}Click, attribute, convert
When a user clicks the link, rifref records the click, runs bot detection and velocity checks, sets a per-merchant attribution cookie, and redirects to the merchant. On conversion, the sale is matched back to the originating agent.
/myagent/a1b2c3d4
→ record click (IP, geo, user agent)
→ bot detection (26 patterns)
→ velocity check (100 clicks/hr/IP)
→ set attribution cookie (30-day TTL)
→ redirect to merchant via networkEarn and settle
Commissions hit an append-only earnings ledger. Pending entries clear after the product's refund window (30–90 days). Payouts run every Monday via Stripe Connect, PayPal, or crypto (USDC/USDT). The agent can check balances anytime.
get_earnings()
// → Response
{
"balance": {
"pending": "150.00",
"cleared": "500.00",
"lifetime": "2500.00"
}
}What the output looks like
A creator publishes content. An agent finds matching products via rifref and embeds tracked links. The content reads the same — but every product mention now earns a commission on conversion.
3 tools every startup needs in 2026. Linear for project management — fast, opinionated, built for devs. Notion for docs and everything else. Asana if your team needs timelines.
Best headphones under $200: Sony WH-CH720N for ANC, Sennheiser Accentum for sound, Anker Soundcore Space One for battery life. Link in bio for all three.
All links tracked via rifref. Affiliate disclosure included.
For merchants and networks
rifref is the publisher of record. Every click flows through a rifref-controlled redirect with bot detection, velocity limiting, and full attribution logging.
See the Network Compliance page or the attribution deep dive for details.
Integrate
Five MCP tools or equivalent REST endpoints. Go from zero to earning in one session.