Overview Referral links are unique URLs that partners share to track their referrals. When someone clicks a partner’s referral link, they’re cookied and any subsequent conversion is attributed to that partner.
Partnero supports multiple referral link formats:
Query Parameter Links The most common format using URL parameters:
https://yoursite.com/?ref=PARTNER_CODE https://yoursite.com/?via=PARTNER_CODE https://yoursite.com/pricing?ref=PARTNER_CODE
Custom Subdomain Links Professional-looking links using subdomains:
https://PARTNER_CODE.yoursite.com https://john.yoursite.com
Custom subdomain links require DNS configuration. Contact support for setup assistance.
Short Links Partnero can generate short, shareable links:
https://go.partnero.com/abc123
Managing Referral Links Default Referral Link Every partner automatically receives a default referral link based on their partner code:
{ "partner" : { "key" : "partner_123" , "code" : "JOHN20" , "referral_url" : "https://yoursite.com/?ref=JOHN20" } }
Custom Links Partners can create additional custom links for different campaigns:
Partners can create custom links from their portal:
Go to Referral Links
Click Create New Link
Set custom destination URL and tracking parameters
curl -X POST https://api.partnero.com/v1/partner_referral_links \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "partner_key": "partner_123", "destination_url": "https://yoursite.com/special-offer", "label": "Black Friday Campaign" }'
Link Parameters Add UTM parameters or custom tracking to links:
https://yoursite.com/?ref=JOHN20&utm_source=partner&utm_campaign=summer2024
Link Domains Configure which domains can be used for referral links:
Primary Domain Your main website domain:
https://yoursite.com/?ref=CODE
Additional Domains Add multiple domains for different products or regions:
curl -X GET https://api.partnero.com/v1/partner_referral_links:domains \ -H "Authorization: Bearer YOUR_API_KEY"
Response:
{ "domains" : [ { "domain" : "yoursite.com" , "primary" : true }, { "domain" : "shop.yoursite.com" , "primary" : false }, { "domain" : "eu.yoursite.com" , "primary" : false } ] }
Link Analytics Track performance for each referral link:
Metric Description Clicks Total clicks on the link Unique Clicks Unique visitors who clicked Leads Sign-ups from the link Conversions Sales from the link Revenue Total revenue generated
Referral Link API List Partner’s Links curl -X GET https://api.partnero.com/v1/partners/partner_123/referral_links \ -H "Authorization: Bearer YOUR_API_KEY"
Create a Link curl -X POST https://api.partnero.com/v1/partner_referral_links \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "partner_key": "partner_123", "destination_url": "https://yoursite.com/promo", "label": "Promo Page" }'
Update a Link curl -X PUT https://api.partnero.com/v1/partner_referral_links/link_456 \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "label": "Updated Campaign Name" }'
Delete a Link curl -X DELETE https://api.partnero.com/v1/partner_referral_links/link_456 \ -H "Authorization: Bearer YOUR_API_KEY"
Coupon Code Tracking In addition to links, partners can use coupon codes for tracking:
{ "partner_key" : "partner_123" , "coupon_code" : "JOHN20" , "discount_type" : "percentage" , "discount_value" : 20 }
When a customer uses the coupon code at checkout, the sale is attributed to the partner.
Next Steps
Track Transactions Learn how transactions are tracked
Referral Links API Full API documentation
