Commission Management

Track, approve, and manage affiliate commissions

List Commissions

GET /api/v1/affiliate/commissions/

Query Parameters

Parameter Type Description
status string Filter by status (pending, approved, rejected, paid)
affiliate_id int Filter by affiliate
date_from date Commission date from
date_to date Commission date to
min_amount decimal Minimum commission amount
max_amount decimal Maximum commission amount

Example Response

{
  "success": true,
  "data": {
    "results": [
      {
        "id": 567,
        "affiliate_id": 123,
        "affiliate_name": "John Smith",
        "order_id": 789,
        "product_name": "Advanced Marketing Course",
        "commission_amount": 125.50,
        "commission_rate": 15.0,
        "order_total": 837.00,
        "status": {
          "value": "approved",
          "display": "Approved"
        },
        "created_date": "2024-01-15T10:30:00Z",
        "approved_date": "2024-01-16T09:15:00Z",
        "payment_due_date": "2024-01-30T23:59:59Z"
      }
    ],
    "summary": {
      "total_commissions": 15,
      "total_amount": 2456.78,
      "pending_count": 5,
      "approved_count": 8,
      "paid_count": 2
    }
  }
}

Approve Commission

POST /api/v1/affiliate/commissions/{id}/approve/

Request Body

{
  "approval_note": "Verified sale completion"
}

Bulk Approve Commissions

POST /api/v1/affiliate/commissions/bulk-approve/

Request Body

{
  "commission_ids": [123, 456, 789],
  "approval_note": "Bulk approval for January commissions"
}