Referly Developer Documentation

Install affiliate tracking, report conversions from your server, receive webhooks, and integrate Referly with your stack.

Referly tracks referrals, attributes sales to affiliates, and works out the commission owed. This section covers everything you build against: the tracking script, server-side conversion reporting, webhooks, and integrations.

Whether you are:

• adding affiliate tracking to a website
• reporting sales from your backend
• reacting to webhook events in your own systems
• connecting Referly through an integration

start here.

How Referly works

A visitor arrives through an affiliate’s link or coupon and Referly records a click. When that visitor becomes a customer, the click becomes a referral. Each payment that customer makes is a sale, every sale produces a commission for the affiliate, and commissions are settled in a payout.

Core concepts

How programs, affiliates, clicks, referrals, sales, commissions, and payouts fit together.

What would you like to do?

Install tracking

Add the script that attributes clicks and sales to affiliates.

Report a sale from your server

Record conversions from your backend rather than the browser.

Receive webhooks

Get notified when affiliates, referrals, and sales change.

Use the API

Read and write affiliates, referrals, sales, links, and coupons.

Quickstart

Add the tracking script to every page of your site:

<script
  data-affiliate
  data-program-id="YOUR_PROGRAM_ID"
  src="https://www.referly.so/affiliate-tracker.js"
></script>

Quickstart guide

Install the snippet, confirm attribution works, and record your first sale.

Integrations

If you use one of these platforms, you may not need to write any code.

Stripe

Shopify

WooCommerce

Zapier

Make

Everything else

Reference

Data model

The core objects and how they relate.

Statuses and enums

Every status value an object can hold.