Media buyer tool 3 · Postback URL Tester for Tapfiliate
Test your Tapfiliate postback URL before the next conversion goes missing.
Tapfiliate calls the affiliate's HTTPS postback URL (provided by the affiliate) when a conversion occurs, replacing ${macro} placeholders. Below: Tapfiliate's postback format and macros as Tapfiliate's own docs give them, the ways a Tapfiliate postback usually breaks, and the tester, pre-filled with an example of the postback the platform fires to your tracker. Edit it to match yours and run the check.
Nothing you enter leaves your browser.
Tapfiliate's postback format
https://affiliate-network.com/postback?clickid=${click_subid}&payout=${commission_amount}¤cy=${currency}Tapfiliate's click-ID macro: ${click_subid}. Source: How to setup postback for affiliates (read on November 9, 2026). Networks rename macros and some show them only inside your account; if your dashboard differs, it wins.
Tapfiliate macros
| Macro | Meaning |
|---|---|
| ${click_subid} | Affiliate click ID (a content key chooses which SubID is sent) |
| ${click_id} | Tapfiliate click ID, empty if not linked to a click |
| ${conversion_id} | Unique conversion ID |
| ${conversion_amount} | Amount sent by the advertiser, defaults to 0.00 |
| ${commission_amount} | Approved commission for this affiliate |
| ${conversion_status} | Status of the conversion |
| ${conversion_currency} | Currency code of the conversion |
| ${conversion_external_id} | External ID of the conversion |
| ${currency} | Program currency |
| ${program_id} | Program ID |
Parameter names on the receiving side
clickid: Affiliate's click ID parameter, filled from ${click_subid}payout: Commission from ${commission_amount}currency: Program currency from ${currency}
How a Tapfiliate postback usually breaks
No content key set
Without a content key, ${click_subid} sends all SubIDs of the click as JSON, so your tracker gets a JSON string instead of its click ID.
Fix: Set the content key to the SubID name that carries your click ID (e.g. subid1 for tm_subid1).
Customer-event postbacks have empty conversion macros
Conversion macros are empty in customer-event postbacks, so ${conversion_id} and ${commission_amount} will be blank there.
Fix: Only read conversion macros on conversion postbacks.
Dollar-brace syntax mistyped
Macros use ${name}; plain {name} or $name is not substituted.
Fix: Write ${...} exactly.
Commission excludes unapproved/MLM amounts
${commission_amount} is only the approved commission for this affiliate, excluding upline MLM and unapproved commissions, so it can be lower than expected.
Fix: Use ${conversion_amount} if you need the sale value.
Test your Tapfiliate postback
Pre-filled with an example: Tapfiliate's macros in an example tracker postback (track.example.com stands for your tracker). Paste your own URL over it; the check runs in this page and fires nothing.
Want me to trace one real campaign?
This tool checks the postback URL and offer link you pasted from what you typed. It can't see your ad accounts, tracker, network or live traffic. If the result shows gaps, I'll look at one real campaign for free: I trace it from ad click to payout and back, and within 48 hours I send you a written report on where money or data leaks silently, the fix for each, and the tests that prove it's fixed.
In the review I fire a test conversion end to end on one real campaign and check it lands once, with the right payout, in your tracker and in your traffic source. You get the fix for every place it doesn't.
Shilpa Goel, [email protected]
This is an engineering checklist, not a security audit, legal, compliance or investment advice.
Not affiliated with or endorsed by Meta, Google, TikTok or any network or tracker named here.