Find the page
In the affiliate portal, go to Settings, open the Advanced tab, and select Postback URL. The page is per program. A postback URL you save with one brand doesn’t carry over to another — set it up separately in each program you want events from.Save your tracking URL
Generate a postback URL in your tracking platform, paste it into the Postback URL template box, and select Save Postback URL. You’ll see Postback URL saved when it’s stored. Two rules for the URL itself:- It has to be a full address starting with
httporhttps. A partial path won’t save. - Anywhere you want Referly to fill in a real value, put a macro in curly braces. Referly swaps each one for the actual value just before it makes the call, including inside query-string values.
Pass your own click ID through
This is the part that makes attribution work, and the part people most often miss. Your tracker needs to know which of your clicks turned into this conversion. Referly can hand that back to you, but only if you sent it in the first place. AddrsubID to your referral link and put your tracker’s click ID placeholder in it. If your placeholder is wct_click_id, your link looks like this:
rsubID against that click. Later, when the postback fires, {extClickid} in your URL resolves back to that same value — and your tracker matches the conversion to the right click.
Know which macros you can use
The page lists every available macro in an Available macros panel, each with a short description. These are the ones you’ll reach for most:
There are more on the page — external IDs, tax and shipping amounts, commission rate and type, reward type, and separate timestamps for the referral and the sale. Use the ones your tracker actually needs and leave the rest out; a shorter URL is easier to debug.
A macro with no value simply resolves to nothing rather than breaking the call.
Understand when it fires
The same URL is called for two events, and it’s worth knowing the difference:1
referral.created
Someone signs up through your link. There’s no money attached yet, so
{commission_amount} comes back as 0. Handle this in your tracker as a lead, not a sale — otherwise you’ll be counting zero-value conversions as revenue.2
sale.created
A referral turns into an actual sale. This is the one carrying real commission, sale amount and product data.
{event} to tell them apart on your end.
Referly calls your URL as a normal web request and follows redirects. It gives up after ten seconds, so if your endpoint is slow to answer you may lose events — point the postback at your tracker’s own endpoint rather than something that does heavy work before responding.
Set it up with WeCanTrack
The page has a built-in guide for WeCanTrack specifically. Select the amber Follow these instructions to effectively set up postback on WecanTrack button to open it. It walks through connecting a custom integration under Affiliate Networks, creating an account and generating a postback URL, connecting your website, and — the important step — making sure your click ID placeholder is carried in a parameter namedrsubID. You then bring the generated URL back to this page and save it.
The same shape works for any other tracker. Generate the postback URL there, make sure your click ID reaches Referly as rsubID, and map their parameters to Referly’s macros.
Conversions aren’t reaching your tracker
Work through these in order.Your click ID isn't coming back
Your click ID isn't coming back
If conversions arrive but land unattributed, the click ID never got stored. Load your own referral link in a browser and check the address really carries
rsubID with a value in it — trackers sometimes strip or rename parameters when they rewrite links. Then confirm your postback URL uses {extClickid} and not some other macro.Nothing arrives at all
Nothing arrives at all
Take the URL you saved, replace the macros with test values by hand, and open it in a browser. If your tracker doesn’t register that, the problem is at their end or in the URL itself, not in Referly. Also check you saved it in the right program — the setting is per program.
You're seeing conversions with no value
You're seeing conversions with no value
Those are almost certainly signup events, where
{commission_amount} is 0 by design. Split them out using {event}.Numbers don't match your portal
Numbers don't match your portal
Postbacks fire when an event is created, which is before the brand has approved the commission. A sale that’s later declined or refunded still generated a postback. Use
{approval_status} if you need to reflect that in your own reporting.Related
Referral links
The links you’ll be adding
rsubID to.My programs
Set this up separately per program.
Getting paid
What happens to a commission after the postback fires.
Postback URLs for developers
The technical reference.