> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/Braian551/viax/llms.txt
> Use this file to discover all available pages before exploring further.

# Earnings Tracking

> Track your driver earnings, view payment history, and understand your income

## Overview

As a Viax driver, you can track all your earnings in real-time, view detailed payment breakdowns, and monitor your financial performance through the driver app.

## Earnings Dashboard

The earnings screen provides a comprehensive view of your income:

<CardGroup cols={3}>
  <Card title="Today's Earnings" icon="dollar-sign">
    Current day's completed trip earnings
  </Card>

  <Card title="This Week" icon="calendar-week">
    Weekly earnings total
  </Card>

  <Card title="This Month" icon="calendar">
    Monthly income summary
  </Card>

  <Card title="Total Trips" icon="car">
    Number of completed trips
  </Card>

  <Card title="Average Fare" icon="chart-line">
    Mean trip earnings
  </Card>

  <Card title="Next Payout" icon="money-bill-transfer">
    Pending payment amount and date
  </Card>
</CardGroup>

## Earnings Breakdown

```dart theme={null}
class DriverEarnings {
  final double totalFares;
  final double platformCommission;
  final double netEarnings;
  final int totalTrips;
  final double averageEarning;
  final DateTime periodStart;
  final DateTime periodEnd;
}
```

### Income Components

<Tabs>
  <Tab title="Gross Earnings">
    Total trip fares before deductions:

    * Base fares
    * Distance charges
    * Time charges
    * Surge pricing
    * Tips (if applicable)
  </Tab>

  <Tab title="Platform Commission">
    Viax service fee (typically 20%):

    * Payment processing
    * Platform maintenance
    * Customer support
    * Insurance coverage
  </Tab>

  <Tab title="Net Earnings">
    Your take-home pay:

    * Gross earnings minus commission
    * What you actually receive
    * Basis for payout calculations
  </Tab>
</Tabs>

## Trip History and Earnings

View detailed information for each completed trip:

```json theme={null}
{
  "trip_id": "12345",
  "date": "2024-03-05T14:30:00Z",
  "passenger": "María García",
  "from": "Calle 72 #10-34",
  "to": "Carrera 15 #85-23",
  "distance_km": 5.2,
  "duration_minutes": 15,
  "earnings": {
    "base_fare": 4500,
    "distance_cost": 6240,
    "time_cost": 2250,
    "surge_multiplier": 1.0,
    "gross_total": 12990,
    "platform_commission": 2598,
    "net_earnings": 10392
  }
}
```

## Payment Schedule

<Steps>
  <Step title="Trips completed">
    Earn money from each completed trip
  </Step>

  <Step title="Daily accumulation">
    Earnings accumulate throughout the day
  </Step>

  <Step title="Weekly payout">
    Payments processed every Monday
  </Step>

  <Step title="Bank transfer">
    Funds deposited to your registered bank account
  </Step>

  <Step title="Confirmation">
    Receive notification when payment is sent
  </Step>
</Steps>

<Note>
  Payment processing may take 1-2 business days depending on your bank.
</Note>

## Viewing Earnings

### Daily View

See today's performance:

* Trips completed so far
* Current earnings
* Average per trip
* Hours online
* Efficiency metrics

### Weekly View

Track weekly trends:

* Day-by-day breakdown
* Peak earning days
* Total weekly income
* Hours worked
* Trips per day average

### Monthly View

Monitor monthly performance:

* Week-by-week analysis
* Month-to-date total
* Projected month-end earnings
* Comparison to previous months
* Growth trends

## Earnings Statistics

```dart theme={null}
class EarningsStatistics {
  final double highestTripEarning;
  final double lowestTripEarning;
  final double averageTripEarning;
  final int totalTripsCompleted;
  final double totalDistanceDriven;
  final Duration totalTimeOnline;
  final double earningsPerHour;
  final double earningsPerKm;
}
```

<CardGroup cols={2}>
  <Card title="Earnings per Hour" icon="clock">
    Average income per online hour
  </Card>

  <Card title="Earnings per Trip" icon="car">
    Mean income per completed trip
  </Card>

  <Card title="Best Day" icon="trophy">
    Highest single-day earnings
  </Card>

  <Card title="Acceptance Rate" icon="percentage">
    % of trip requests accepted
  </Card>
</CardGroup>

## Payment Methods

Configure how you receive payments:

<Tabs>
  <Tab title="Bank Transfer">
    * Direct deposit to bank account
    * Most common method
    * 1-2 day processing
    * No additional fees

    Required information:

    * Bank name
    * Account number
    * Account type (checking/savings)
    * ID number
  </Tab>

  <Tab title="Digital Wallet">
    * Nequi, Daviplata, etc.
    * Instant transfers
    * Mobile-friendly
    * May have fees
  </Tab>

  <Tab title="Cash Pickup">
    * Partner locations
    * Same-day availability
    * Service fee applies
    * Valid ID required
  </Tab>
</Tabs>

## Commission Structure

Viax retains a percentage of each fare:

| Component         | Driver | Viax Platform |
| ----------------- | ------ | ------------- |
| Standard trips    | 80%    | 20%           |
| Promotional trips | 85%    | 15%           |
| Referral bonuses  | 100%   | 0%            |

<Info>
  Commission rates may vary during promotional periods or for high-performing drivers.
</Info>

## Bonuses and Incentives

Earn extra income through:

<Accordion title="Peak Hour Bonuses">
  Additional earnings during high-demand periods:

  * Morning rush: 6-9 AM
  * Evening rush: 5-8 PM
  * +\$500-1000 per trip
</Accordion>

<Accordion title="Quest Rewards">
  Complete trip targets for bonuses:

  * 20 trips/week: +\$20,000
  * 40 trips/week: +\$50,000
  * 60 trips/week: +\$100,000
</Accordion>

<Accordion title="Referral Program">
  Earn by referring new drivers:

  * \$50,000 per successful referral
  * Paid after referee completes 20 trips
  * Unlimited referrals
</Accordion>

<Accordion title="Rating Bonus">
  High-rated drivers earn more:

  * 4.8+ rating: +2% on all fares
  * 4.9+ rating: +3% on all fares
  * 5.0 rating: +5% on all fares
</Accordion>

## Tax Information

<Warning>
  As an independent contractor, you are responsible for your own taxes. Viax does not withhold taxes from your earnings.
</Warning>

### Tax Documents

* Annual earnings statement (by February)
* Monthly earnings summaries
* Trip-by-trip records
* Expense tracking support

### Deductible Expenses

Track these for tax purposes:

* Fuel costs
* Vehicle maintenance
* Insurance premiums
* Phone bills
* Car washes
* Tolls and parking

## Earnings Reports

Generate and export reports:

<Tabs>
  <Tab title="Daily Report">
    * Trips by hour
    * Earnings by trip
    * Commission breakdown
    * Tips received
  </Tab>

  <Tab title="Weekly Report">
    * Day-by-day summary
    * Best performing days
    * Total weekly income
    * Average per shift
  </Tab>

  <Tab title="Monthly Report">
    * Complete month breakdown
    * Tax calculation support
    * Expense tracking
    * Year-over-year comparison
  </Tab>

  <Tab title="Custom Report">
    * Select date range
    * Choose metrics
    * Filter by trip type
    * Export to CSV/PDF
  </Tab>
</Tabs>

## Maximizing Earnings

<CardGroup cols={2}>
  <Card title="Drive Peak Hours" icon="chart-line">
    Work during high-demand periods for surge pricing
  </Card>

  <Card title="Accept More Trips" icon="check">
    Higher acceptance rate = more opportunities
  </Card>

  <Card title="Strategic Locations" icon="location-dot">
    Position yourself near high-demand areas
  </Card>

  <Card title="Maintain Rating" icon="star">
    High ratings unlock bonus multipliers
  </Card>
</CardGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Driver Statistics" icon="chart-bar" href="/api/drivers/statistics">
    View detailed performance metrics
  </Card>

  <Card title="Trip Execution" icon="route" href="/drivers/trip-execution">
    Learn how to complete trips efficiently
  </Card>
</CardGroup>
