Partner Lifecycle
Partners in your program go through several stages:
Partner Statuses
| Status | Description |
|---|
| Pending | Partner has signed up, awaiting approval |
| Active | Partner is approved and can earn commissions |
| Suspended | Partner is temporarily disabled |
| Archived | Partner has been removed from the program |
Recruiting Partners
Partner Signup Page
Every program has a public signup page where partners can apply:
https://partners.yoursite.com/signup
- Name and email (required)
- Company/website
- Social media profiles
- How they plan to promote
Invite Partners Directly
Invite specific partners via email:
- Navigate to Partners → Invite
- Enter partner email addresses
- Customize the invitation message
- Click Send Invitations
curl -X POST https://api.partnero.com/v1/partners:invite \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"name": "John Doe",
"send_invitation": true
}'
Create Partners Programmatically
Use the API to create partners from your own systems:
curl -X POST https://api.partnero.com/v1/partners \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"name": "John Doe",
"key": "partner_123",
"metadata": {
"source": "website",
"tier": "gold"
}
}'
Managing Partner Details
Access detailed partner information from the dashboard:
- Overview - Performance metrics and status
- Referrals - List of referred leads and customers
- Transactions - Sales attributed to the partner
- Rewards - Commission history
- Payouts - Payment history
Updating Partners
- Go to Partners and select a partner
- Click Edit to modify details
- Update fields and save
curl -X PUT https://api.partnero.com/v1/partners/partner_123 \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "John Smith",
"metadata": {
"tier": "platinum"
}
}'
Partner Approval Workflow
Auto-Approval
Enable auto-approval for all new partners:
- Go to Program Settings → Partner Signup
- Toggle Auto-approve new partners
Manual Approval
Review each partner application:
- Navigate to Partners → Pending
- Review partner details and application
- Click Approve or Reject
Use manual approval to vet partners and maintain program quality.
Partner Tiers & Groups
Organize partners into tiers for different commission rates:
{
"tiers": [
{
"name": "Bronze",
"commission_rate": 15,
"requirements": null
},
{
"name": "Silver",
"commission_rate": 20,
"requirements": {"min_sales": 10}
},
{
"name": "Gold",
"commission_rate": 25,
"requirements": {"min_sales": 50}
}
]
}
Suspending & Archiving Partners
Suspend a Partner
Temporarily disable a partner (preserves data):
curl -X POST https://api.partnero.com/v1/partners/partner_123/archive \
-H "Authorization: Bearer YOUR_API_KEY"
Restore a Partner
Reactivate a suspended partner:
curl -X POST https://api.partnero.com/v1/partners/partner_123/revoke-archive \
-H "Authorization: Bearer YOUR_API_KEY"
Delete a Partner
Permanently remove a partner:
Deleting a partner is irreversible and removes all associated data.
curl -X DELETE https://api.partnero.com/v1/partners/partner_123 \
-H "Authorization: Bearer YOUR_API_KEY"
Next Steps
