Description
Referly.so runs affiliate and referral programs for online stores. This plugin connects your WooCommerce store to your Referly program: it tracks the visitors your affiliates send, credits each order to the affiliate who referred it and shows your program’s numbers right inside WordPress.
What the plugin does
- Credits orders to affiliates. Visitors who arrive through an affiliate link are tracked, and their WooCommerce orders are recorded as sales for that affiliate in Referly.
- Tracks affiliate coupon codes. An order placed with an affiliate’s coupon is credited to that affiliate, even when the customer never clicked a link.
- Keeps commissions right. When an order is refunded or cancelled, Referly reverses the sale so you don’t pay commission on it.
- Shows your program in WordPress. Add your Referly API key and the Referly menu shows revenue from affiliates, your top affiliates, recent sales, commissions owed and payouts, without leaving your dashboard.
- Works with your checkout. The classic checkout, the block checkout and “create an account” at checkout are all covered.
What you manage in Referly
- Commission plans: percentage or flat rate, one-time or recurring, per affiliate group or product.
- A branded affiliate portal where affiliates sign up, get their links and coupon codes and follow their earnings.
- Affiliate recruitment, announcements and marketing assets.
- Payouts: Referly works out what each affiliate is owed and prepares the payout.
Referly Atlas: ad tracking (optional)
Referly Atlas is a separate Referly product for stores that run ads. With an Atlas store token, the plugin also sends orders, refunds, add-to-cart and checkout events to Referly Atlas from your server. Atlas matches each sale to the ad that brought the visitor in and passes it to your ad platforms, so ad blockers and browser privacy settings don’t hide your sales from them. It also reports sign-ups, Contact Form 7 and WPForms leads, and WooCommerce Subscriptions trials and renewals.
Atlas is off until you add a store token. Affiliate tracking works the same with or without it.
Learn more
Trademarks
Referly.so is operated by Referly Technologies, LLC. WooCommerce is a trademark of Automattic Inc. WooCommerce Subscriptions, Contact Form 7, WPForms, Google Ads, Meta and TikTok are trademarks of their respective owners. Referly.so is not affiliated with, endorsed by or sponsored by any of them.
External services
This plugin connects your site to Referly (https://www.referly.so), the affiliate program service it is built for. Nothing is sent until the site owner enters a Referly program ID, API key or Atlas store token on the plugin’s settings page.
What is sent, and when:
- Tracking script. On every page of your store, the plugin loads Referly’s tracking script from referly.so. The script records visits from affiliate links (the affiliate’s referral code, the page and the referrer) so orders can be credited to the right affiliate.
- Sign-ups and orders. When a customer creates an account, places an order, or an order is refunded or cancelled, the plugin sends the customer’s email address and name, the order number, amount, currency, products and any coupon code to Referly, together with the affiliate’s referral code, so the right affiliate is credited.
- Coupons. When a coupon is used, updated or deleted in WooCommerce, the plugin tells Referly so affiliate coupon codes stay in sync.
- Signed requests. When you click Connect with Referly (or paste a connection key, or request approval), Referly issues this site a signing key. The plugin signs every order, refund, sign-up and coupon call with it, so Referly can prove the call came from your store. To approve a site that requested approval, Referly calls this site’s
/wp-json/referly/v1/handshakeroute, which answers with a signature of a one-time challenge and never reveals the key. - Dashboard data. If you add a Referly API key, the plugin requests your program’s summary (totals, recent sales, affiliates and payouts) from Referly to show it in WordPress. Nothing about your visitors is sent for this.
- Referly Atlas (only when an Atlas store token is added and Atlas is turned on). The plugin also sends cart, checkout, sign-up and lead events, and orders, refunds and cancellations, with the visitor’s IP address, browser user agent and ad-click identifiers (such as the click ids that Meta, Google and TikTok add to ad links), so Referly Atlas can match sales to ads.
Referly’s terms of service: https://www.referly.so/tos
Referly’s privacy policy: https://www.referly.so/privacy-policy
Screenshots




Installation
- In WordPress, go to Plugins > Add New, search for “Referly” and click Install Now. Or upload the plugin ZIP under Plugins > Add New > Upload Plugin.
- Activate the plugin through the Plugins menu.
- Click Referly in the left sidebar and click Connect with Referly: sign in to Referly, pick your program and approve the store. You can also paste your program ID (shown in Referly under Integrations, in the WooCommerce setup step) and connect from the Settings tab afterwards.
- Optional: to see your affiliates, sales and payouts in WordPress, create an API key in Referly under Settings > Advanced > API Keys and paste it on the plugin’s Settings tab.
- Optional: to turn on ad tracking, paste your Referly Atlas store token on the plugin’s Ad tracking tab.
FAQ
-
Do I need a Referly account?
-
Yes. The plugin connects your store to a Referly affiliate program. You can start a free trial at referly.so.
-
Will the plugin slow down my store?
-
The tracking script loads asynchronously, so it doesn’t block your pages. Orders and refunds are sent to Referly from your server.
-
Do I need the API key?
-
No. Tracking only needs your program ID. The API key is only used to show your program’s numbers on the plugin’s dashboard in WordPress.
-
What happens when an order is refunded or cancelled?
-
The plugin tells Referly, and the sale and its commission are reversed.
-
Does it work with the WooCommerce block checkout?
-
Yes. Orders from both the classic and the block checkout are tracked.
-
Where do I manage commissions and payouts?
-
In your Referly dashboard. The plugin shows what’s owed and links straight to the right page.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Referly.so – Affiliate & Referral Program for WooCommerce” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Referly.so – Affiliate & Referral Program for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
2.5.0
- Security: every order, refund, sign-up and coupon call to Referly is now signed with a key issued to this site (HMAC-SHA256 with a timestamp and a single-use nonce), so nobody else can send Referly orders in your store’s name. Referly is ending support for unsigned calls from older versions.
- New “Connect with Referly” button: sign in to Referly, pick your program and approve the store. It connects the program and the signing key in one step, and the key never passes through your browser.
- Can’t use the button? Paste a connection key created in Referly, or request approval from the plugin and approve the store in Referly.
- Calls that fail on the network or while Referly is busy are retried automatically through Action Scheduler (included with WooCommerce).
- The header shows whether this store’s requests are signed, and the Settings tab can test the connection.
2.4.1
- Security: every form handler checks a nonce before it reads submitted data, including the WooCommerce registration and checkout fields used for sign-up tracking.
- The plugin is now listed as Referly.so (text domain referly-so).
2.4.0
- The plugin is now Referly everywhere: the readme, the plugin description and the admin page.
- New dashboard in WordPress with tabs for Overview, Affiliates, Sales, Payouts, Ad tracking and Settings.
- Add a Referly API key on the Settings tab to see revenue from affiliates over the last 30 days, top affiliates, recent sales, commissions owed and payout batches. The data is cached for five minutes; Refresh fetches it again.
- Every form on the Referly page is now protected with a nonce and only works for administrators.
- The tracking script is now loaded through wp_enqueue_script(), and every value read from cookies, forms and request headers is sanitized.
- Requires WordPress 6.5 or newer.
- Removed the developer-only setting that pointed the plugin at a test copy of Referly, and the request relay that came with it. Every request goes to referly.so.
- Removed the unused “NET or GROSS” setting. It had no effect on how sales were recorded.
- Tested up to WordPress 7.1.
2.3.4
- Referly Atlas: changing an order’s status in the WordPress admin no longer tags the order with the shop manager’s own visit. Orders, sign ups and leads only carry the shopper’s identifiers when they come from the shopper’s own browser (the store, the classic checkout or the block checkout).
- Referly Atlas: orders now include WooCommerce’s own order attribution (the page the visit started on and its referrer), so an ad click still counts when an ad blocker stopped the Referly tracker. Needs WooCommerce order attribution turned on (WooCommerce 8.5 or later, on by default).
2.3.3
- Referly Atlas: every Google Ads conversion now fires on WordPress and WooCommerce sites. Sign ups, leads, trials and subscriptions were only sent to Referly from your server, so Google Ads never saw them. The plugin now also announces them in the visitor’s browser.
- Sign ups (any registration form, including “create an account” at checkout) are announced on the next page the new customer sees, for example the order received page.
- Contact Form 7 and WPForms leads are announced right after the form is sent, also when the form is sent without a page reload.
- With WooCommerce Subscriptions, the order received page announces a trial for each subscription that starts with a free trial, and a subscription for each one that does not. Referly Atlas now also records these trials and subscriptions, and a subscription when a trial turns into its first paid period.
- Each event carries the same id Referly Atlas records, so Google Ads never counts it twice and Referly Atlas reporting matches what fired.
- Affiliate tracking is unchanged.
2.3.2
- Referly Atlas: the Google Ads snippet from Referly Atlas now records add to cart, begin checkout and purchase conversions on WooCommerce stores. These events are sent to Referly from your server, so the snippet on your pages never saw them before. The plugin now also announces them in the shopper’s browser, where the snippet picks them up.
- Purchases are announced once per order on the order received page, with the same order id Referly Atlas uses, so Google Ads does not count a reload of that page twice.
- Add to cart and begin checkout events sent to Referly Atlas carry the same id as the ones announced in the browser, so Referly Atlas reporting matches what the Google Ads snippet fired to the right event.
- Nothing extra is sent to Referly Atlas, and affiliate tracking is unchanged.
2.3.1
- Referly Atlas: add-to-cart, checkout, sign-up and lead events are now sent at the end of the request, after the page has gone to the shopper, and the plugin waits for Referly’s reply. Before, they were sent fire-and-forget, and a proxy or host that drops a request whose sender has hung up lost them. Each event keeps the time it happened.
- Referly Atlas: “Verify and Save” accepts a token for a different store (for example after the store was deleted and created again in Referly). It no longer sends the previous store’s id with the new token.
2.3.0
2.2.0
- Referly Atlas: new site accounts (any registration form, including “create an account” at checkout) are sent as sign ups, and sent Contact Form 7 / WPForms forms as leads, with the visitor identifiers from the shopper’s cookies.
- Affiliate tracking is unchanged.
2.1.0
- Referly Atlas (ad tracking): new “Referly Atlas” admin card with a store token and “Verify and Save”.
- When Atlas is enabled the tracker script runs in Atlas mode, orders (with refunds and cancellations), add-to-cart and checkout events are sent to Referly Atlas server-side, and the visitor identifiers are saved on each order.
- Affiliate tracking is unchanged.
1.0.0
- Initial release.
