> ## 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.

# Payment Methods

> Manage payment options for your Viax trips

## Overview

Viax offers multiple payment methods to make your trips convenient and hassle-free. This guide covers available payment options, how to manage them, and the payment process.

## Available Payment Methods

<CardGroup cols={2}>
  <Card title="Cash" icon="money-bill-wave">
    Pay your driver directly in cash at the end of your trip
  </Card>

  <Card title="Digital Wallet" icon="wallet">
    In-app wallet with balance (coming soon)
  </Card>

  <Card title="Credit/Debit Card" icon="credit-card">
    Automated payment processing (planned feature)
  </Card>

  <Card title="Corporate Account" icon="building">
    Business accounts with invoicing
  </Card>
</CardGroup>

## Cash Payments

Cash is the primary payment method currently available:

### How It Works

<Steps>
  <Step title="Complete your trip">
    Arrive at your destination safely
  </Step>

  <Step title="View final fare">
    Check the total amount in the app

    ```json theme={null}
    {
      "trip_id": "12345",
      "final_fare": 12500,
      "currency": "COP",
      "payment_method": "cash"
    }
    ```
  </Step>

  <Step title="Pay the driver">
    Give cash payment to the driver

    <Tip>
      Always ask for change if you don't have exact amount. Drivers are required to carry change.
    </Tip>
  </Step>

  <Step title="Confirm payment">
    Driver marks payment as received in their app
  </Step>

  <Step title="Get receipt">
    Digital receipt generated and saved in your trip history
  </Step>
</Steps>

### Cash Payment Best Practices

<Accordion title="Have correct change when possible">
  While drivers carry change, having the exact amount or close to it helps speed up the process and ensures a smooth transaction.
</Accordion>

<Accordion title="Verify the amount before paying">
  Always check the final fare in the app before handing over payment. The amount shown in your app is the official fare.
</Accordion>

<Accordion title="Request receipt if needed">
  For business trips or reimbursement, save your digital receipt from the app or request a physical receipt from the driver.
</Accordion>

## Digital Wallet (Coming Soon)

The Viax digital wallet will allow you to:

* Pre-load money into your account
* Automated payments after trips
* No need to carry cash
* Instant payment confirmation
* Transaction history
* Refunds directly to wallet

### Planned Wallet Features

```dart theme={null}
// Future wallet implementation
class WalletBalance {
  final double balance;
  final String currency;
  final List<Transaction> recentTransactions;
  
  // Methods
  Future<void> addFunds(double amount);
  Future<void> payForTrip(String tripId, double amount);
  Future<void> requestRefund(String tripId);
}
```

<Info>
  Digital wallet functionality is planned for a future update. We'll notify users when this feature becomes available.
</Info>

## Card Payments (Planned)

Future card payment integration will include:

### Supported Cards

* Visa
* Mastercard
* American Express
* Local Colombian cards
* International cards

### Security Features

<CardGroup cols={2}>
  <Card title="Tokenization" icon="shield">
    Card details never stored on devices
  </Card>

  <Card title="3D Secure" icon="lock">
    Additional authentication for transactions
  </Card>

  <Card title="PCI Compliance" icon="certificate">
    Industry-standard security protocols
  </Card>

  <Card title="Fraud Detection" icon="eye">
    Real-time transaction monitoring
  </Card>
</CardGroup>

## Corporate Accounts

Businesses can set up corporate accounts with:

### Features

* Centralized billing
* Employee ride allocation
* Monthly invoicing
* Expense reporting integration
* Custom approval workflows
* Cost center assignment

### Setup Process

<Steps>
  <Step title="Contact sales">
    Reach out to Viax corporate team
  </Step>

  <Step title="Provide company information">
    Submit business registration and tax documents
  </Step>

  <Step title="Configure account">
    Set up billing rules, cost centers, and employee access
  </Step>

  <Step title="Add employees">
    Invite employees to use corporate account
  </Step>

  <Step title="Start using">
    Employees book trips charged to company account
  </Step>
</Steps>

## Payment Receipt

After each trip, you receive a detailed receipt:

### Receipt Information

```json theme={null}
{
  "trip_id": "VX-2024-12345",
  "date": "2024-03-05T14:30:00Z",
  "pickup_address": "Calle 72 #10-34, Bogotá",
  "destination_address": "Carrera 15 #85-23, Bogotá",
  "driver": {
    "name": "Carlos Rodríguez",
    "vehicle": "Chevrolet Spark - ABC123"
  },
  "fare_breakdown": {
    "base_fare": 4500,
    "distance_cost": 6240,
    "time_cost": 2250,
    "surge_multiplier": 1.0,
    "subtotal": 12990,
    "discount": 0,
    "total": 12990
  },
  "distance_km": 5.2,
  "duration_minutes": 15,
  "payment_method": "cash",
  "payment_status": "completed"
}
```

### Accessing Receipts

1. **In-app**: Tap on trip in your history
2. **Email**: Receipts sent to registered email
3. **Download**: Export as PDF for records
4. **Print**: Print directly from the app

See [Ride History](/users/ride-history) for more details.

## Refunds and Disputes

### When Refunds Apply

* Overcharged fare
* Incorrect route taken
* Service quality issues
* Technical errors
* Driver cancellation after charge

### Refund Process

<Steps>
  <Step title="Report issue">
    Go to trip in your history and tap "Report Issue"
  </Step>

  <Step title="Select reason">
    Choose the reason for refund request

    * Overcharged
    * Poor service
    * Driver took wrong route
    * Technical issue
    * Other
  </Step>

  <Step title="Provide details">
    Explain the issue and upload evidence if needed
  </Step>

  <Step title="Submit request">
    Refund request sent to support team
  </Step>

  <Step title="Review">
    Support reviews within 24-48 hours
  </Step>

  <Step title="Resolution">
    Refund issued or dispute resolved
  </Step>
</Steps>

<Note>
  Refund processing time depends on payment method:

  * Cash refunds: Via wallet credit
  * Card refunds: 5-7 business days
  * Wallet refunds: Immediate
</Note>

## Tips and Gratuity

While tips are not required, you can:

* Give cash tip directly to driver
* Rate driver 5 stars for exceptional service
* Provide positive feedback in reviews

### Future Tip Feature

In-app tipping will be added:

```dart theme={null}
// Planned tip options
final tipOptions = [
  TipOption.noTip,
  TipOption.percentage(10), // 10%
  TipOption.percentage(15), // 15%
  TipOption.percentage(20), // 20%
  TipOption.custom, // Custom amount
];
```

## Payment Security

<CardGroup cols={2}>
  <Card title="Encrypted Transactions" icon="lock">
    All payment data encrypted in transit and at rest
  </Card>

  <Card title="Fraud Prevention" icon="shield-halved">
    Real-time monitoring for suspicious activity
  </Card>

  <Card title="Secure Storage" icon="database">
    Payment information stored securely
  </Card>

  <Card title="Privacy Protection" icon="user-shield">
    Payment details never shared with drivers
  </Card>
</CardGroup>

## Billing and Invoices

### For Individual Users

* Digital receipts for all trips
* Monthly summary email
* Export to PDF or CSV
* Filter by date range

### For Corporate Accounts

* Consolidated monthly invoices
* Breakdown by employee
* Cost center allocation
* Tax-compliant documentation
* Integration with accounting systems

## Currency and Exchange

Viax currently operates in Colombian Pesos (COP):

* All fares displayed in COP
* Cash payments in COP only
* Future: Multi-currency support for international cards
* Exchange rates updated daily for card payments

## Payment FAQs

<Accordion title="What if I don't have exact change?">
  Drivers are required to carry change for cash payments. However, it's helpful to have approximately the right amount to speed up the transaction.
</Accordion>

<Accordion title="Can I split payment with another passenger?">
  Currently, one person must pay the full fare. In a future update, we plan to add fare-splitting functionality.
</Accordion>

<Accordion title="What happens if the fare seems incorrect?">
  Check the fare breakdown in your trip details. If you believe there's an error, report it through the app within 24 hours of the trip.
</Accordion>

<Accordion title="Are there any hidden fees?">
  No. All charges (base fare, distance, time, surge) are shown upfront in the price estimate. The only additional charges would be tolls or waiting time, which are clearly displayed.
</Accordion>

<Accordion title="How do I add a payment method?">
  Currently, only cash is accepted. When digital payment methods become available, you'll be able to add them through Profile > Payment Methods.
</Accordion>

## Next Steps

<CardGroup cols={2}>
  <Card title="Pricing System" icon="calculator" href="/users/pricing-system">
    Learn how fares are calculated
  </Card>

  <Card title="Trip History" icon="clock-rotate-left" href="/users/ride-history">
    View past payments and receipts
  </Card>
</CardGroup>

## Support

For payment-related issues:

* In-app support chat
* Email: [support@viax.com](mailto:support@viax.com)
* Report issue on trip receipt
* FAQ section in app

<Warning>
  Never share your payment information outside the official Viax app. Viax will never ask for payment details via SMS or email.
</Warning>