Linkbay Documentation
Learn how to protect your affiliate links from hijacking with Linkbay's API and webhook integrations.
What is Linkbay?
Linkbay protects affiliate links from coupon and affiliate tag hijacking. When a creator shares a link, we ensure they get proper attribution for their referrals - even if someone tries to swap out their affiliate tag.
How It Works
1. Creator Generates Link
Creator uses Linkbay to generate a protected link. We record the original affiliate tag.
2. User Clicks Link
When clicked, Linkbay logs the click and redirects to the merchant with a unique click ID.
3. Merchant Receives Webhook
Your webhook receives the expected tag before the user even arrives at your site.
4. Verify at Checkout
Compare the arrived tag with the expected tag. If they don't match, credit the real creator.
Integration Methods
Linkbay offers two complementary integration methods:
Push: Webhooks (Real-time)
We send you click data the moment it happens. Configure a webhook URL in your merchant dashboard to receive click.created events.
- Best for: Real-time fraud detection
- Data available before user arrives
- No API calls needed during checkout
Pull: Lookup API (On-demand)
Query our API at checkout to verify a click. Use the lb_click parameter from the URL.
- Best for: Verification at checkout
- Fallback if webhook missed
- Simple REST API