Skip to main content

​
Overview

Commissions define how partners are rewarded for the sales they generate. Partnero supports flexible commission structures to match your business model.

​
Commission Types

​
Percentage Commission

Partners earn a percentage of each sale: 
{
  "type": "percentage",
  "value": 20,
  "description": "20% of sale amount"
}
Example: 100sale×20100 sale × 20% = 20 commission

​
Fixed Commission

Partners earn a fixed amount per conversion: 
{
  "type": "fixed",
  "value": 50,
  "currency": "USD",
  "description": "$50 per sale"
}
Example: Any sale = $50 commission

​
Tiered Commission

Commission rates increase based on performance: 
{
  "type": "tiered",
  "tiers": [
    {"min_sales": 0, "max_sales": 10, "rate": 15},
    {"min_sales": 11, "max_sales": 50, "rate": 20},
    {"min_sales": 51, "max_sales": null, "rate": 25}
  ]
}
Example:
  • Sales 1-10: 15% commission
  • Sales 11-50: 20% commission
  • Sales 51+: 25% commission

​
Recurring Commissions

For subscription products, partners can earn on all future payments: 
{
  "type": "percentage",
  "value": 20,
  "recurring": true,
  "recurring_duration": 12, // months, null for lifetime
  "recurring_type": "all_payments" // or "first_year_only"
}

​
Recurring Options

OptionDescription
LifetimePartner earns on all payments forever
Time-LimitedPartner earns for X months
First Payment OnlyPartner earns only on first payment

​
Commission Rules

​
Product-Specific Commissions

Set different rates for different products: 
{
  "default_commission": {
    "type": "percentage",
    "value": 20
  },
  "product_commissions": [
    {
      "product_id": "pro_plan",
      "type": "percentage",
      "value": 30
    },
    {
      "product_id": "enterprise",
      "type": "fixed",
      "value": 500
    }
  ]
}

​
Partner-Specific Commissions

Override commission rates for specific partners: 
{
  "partner_key": "partner_123",
  "custom_commission": {
    "type": "percentage",
    "value": 25
  }
}

​
Partner Tiers

Create partner tiers with different commission rates:
TierRequirementsCommission
BronzeDefault15%
Silver10+ sales/month20%
Gold50+ sales/month25%
Platinum100+ sales/month30%

​
Commission Calculation

When a transaction is recorded:
  1. Identify the partner - Via cookie, coupon, or direct attribution
  2. Determine commission rate - Based on product, partner tier, or custom rules
  3. Calculate commission - Apply rate to transaction amount
  4. Create reward - Add to partner’s pending balance

​
Example Calculation

Transaction: $149.00
Partner Tier: Silver (20% commission)
Commission: $149.00 × 20% = $29.80

​
Commission Caps

Limit maximum commission per transaction: 
{
  "type": "percentage",
  "value": 30,
  "max_commission": 100 // Cap at $100
}
Example: 500sale×30500 sale × 30% = 150 → capped at $100

​
Managing Rewards

​
View Rewards

List all rewards in your program: 
curl -X GET https://api.partnero.com/v1/rewards \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Get Reward Details

curl -X GET https://api.partnero.com/v1/rewards/reward_123 \
  -H "Authorization: Bearer YOUR_API_KEY"
Response: 
{
  "id": "reward_123",
  "amount": 29.80,
  "currency": "USD",
  "status": "pending",
  "partner_key": "partner_456",
  "transaction_key": "txn_789",
  "created_at": "2024-01-15T14:30:00Z"
}

​
Reward Statuses

StatusDescription
pendingReward created, awaiting payout
approvedReward approved for payout
paidReward has been paid out
cancelledReward was cancelled (refund, fraud)

​
Create Manual Reward

Add a bonus or adjustment: 
curl -X POST https://api.partnero.com/v1/rewards \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "partner_key": "partner_123",
    "amount": 50,
    "currency": "USD",
    "note": "Performance bonus"
  }'

​
Update Reward

curl -X PUT https://api.partnero.com/v1/rewards \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "reward_123",
    "status": "approved"
  }'

​
Delete Reward

curl -X DELETE https://api.partnero.com/v1/rewards \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "reward_123"
  }'

​
Next Steps

Payouts

Set up partner payouts

Rewards API

Full rewards API reference