Referly API Affiliate Program Integration
Connect Referly API once. Pay partners per sale.
Build your own custom integration using the Referly API
14-day free trial · No credit card required · Cancel anytime
What arrives in Referly
4 steps to connect, 3 of which need someone technical.
Overview
Referly and Referly API
Build your own custom integration using the Referly API
What connects
What Referly tracks in Referly API
Fourteen things, each one read from what Referly API reports rather than from a feature list. The two chips below are the short answer.
What it does
- YesReferral tracking — A signup, trial or new customer is recorded against the partner who sent them, before any money moves.
- YesSale tracking — Every completed payment arrives as a sale with its amount, products and currency, and a commission is calculated from it.
- YesCarries your own click id — An `rsubID` on the inbound link travels all the way to the sale, so an ad platform or a network can match the conversion back to its own click.
What it does not, or only sometimes
- With a conditionRecurring commissions on renewalsPost the renewal as a second sale and the commission schedule picks it up.
- NoRefunds reverse the commissionNothing is polled on your behalf. Reverse the sale with the API, or mark it refunded in the dashboard.
- NoCoupon-code attribution — A customer who types a partner's discount code at checkout is attributed to that partner, with no link click and no cookie involved.
- NoA discount code per partner — Referly creates the discount code inside your platform when a partner joins, so you never mint codes by hand.
- NoPer-product commission rules — Referly reads your product catalogue, so a rule can pay one rate on one product and a different rate on another.
- NoCollection-level rules — Target a whole collection instead of listing its products one by one, and new products in that collection inherit the rate.
- With a conditionCommission net of taxTax is deducted when you send a tax amount on the sale.
- NoCommission net of shipping — Shipping is subtracted before the commission is calculated. On by default, and switchable.
- NoPay partners in store credit — Instead of cash, a partner's balance can be issued as credit inside the platform they already shop in.
- NoConnects without a developerThis one is for developers by definition. The API is available on Business and up.
- With a conditionConnect from the dashboardYou generate an API key in your program settings. Available on Business and up.
- NoSyncs partners into a list — Partners are added to a named list or group in your email platform as they join, so onboarding and announcements go out from the tool you already write in.
- NoPays partners through it — Money actually leaves through this platform. Referly hands it the batch, and it moves the funds to each partner.
- NoPays everyone in one batch — One approval sends every partner what they are owed, rather than one transfer at a time.
Setup
Connect Referly API in four steps
Four steps, in order. The honest note underneath says which of them need someone technical and what the connection does not do.
- 1
Generate an API key in your program settings
Available on Business and up. Keep it server-side.
- 2
Create partners and links from your own app
Post partners, read their links, and hand them out wherever you already onboard people.
Needs a developer - 3
Report referrals and sales
Post a referral at signup and a sale at payment, with the amount and currency.
Needs a developer - 4
Subscribe to webhooks for anything you need back
Delivery logs and replay are built in, so a failed endpoint is not a lost event.
Needs a developer
API access and webhooks are both on Business and up, not on Startup. Everything the dashboard does is available here, including payout batches, but because you report the events, reversals and renewals are yours to send too.
Guides
Step-by-step for Referly API
Written for the setup you actually have, not the one that makes the shortest article.
Customer stories
What a program on Referly looks like
Three businesses, three different stacks, and the numbers their partners produced.

“We have been running affiliate programs for over a decade, and ours is one of the biggest parts of how OptimizePress grows. Referly is the first platform where an operation with thousands of partners actually feels manageable, from recruiting new affiliates to tracking every sale they send.”

James Dyson
Founder & CEO, OptimizePress
- 7 figures
- in affiliate-driven sales
- 4,554
- active affiliates
- 10,536
- referrals

“This platform is quite simple and easy to use, and you can start attracting people to your affiliate program very quickly. A big plus is that the founder, Ayo, is super responsive.”

Ilfat Khayrullin
CMO & Co-founder, Letterly
- 300K+
- app users
- 689
- active affiliates
- 24,114
- clicks tracked
“Affiliates drive a serious share of our revenue across three countries. Since we moved to Referly everything runs from one place, tracking has been spot on, and our partners get paid without me chasing spreadsheets.”

Alexander Koppers
Affiliate Manager, Moov
$6.9M
in total affiliate-driven revenue
- 1,154
- active affiliates
- 19,017
- affiliate sales
- 1,240,030
- clicks tracked
FAQ
Before you connect anything
The questions founders ask in the first ten minutes.
14-day free trial · No credit card required · Cancel anytime
Business and up. API access and webhooks are both off on Startup. Every other integration is available on every plan.
Related
Also connects to
StripeConnect Referly to Stripe to manage subscriptions, refunds, cancellations, coupons and one-time payments
See what it tracks
ShopifyConnect Referly to Shopify to to track orders, customers and coupon codes.
See what it tracks
WooCommerceConnect your woocommerce store to Referly to track sales and customer sign ups.
See what it tracks