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"
{
"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
}
Next Steps
