Transactions
The Transactions screen provides a comprehensive view of all vendor operations with filtering, searching, and export capabilities.
Overview
Vendors can view:
- All transaction types (POS, top-ups, withdrawals)
- Transaction status and details
- Revenue and fee breakdowns
- Historical data with date filtering
Transaction List
List View
Each transaction displays:
- Transaction type icon
- Customer name
- Transaction time
- Amount (credit/debit indicator)
- Status label
Transaction Types
| Type | Icon | Description |
|---|---|---|
| POS | point_of_sale | Payment received |
| Top-up | add_circle | Customer deposit |
| Withdrawal | remove_circle | Cash-out processed |
Filtering
Filter Options
| Filter | Options |
|---|---|
| Type | All, POS, Top-up, Withdrawal |
| Status | All, Completed, Pending, Failed |
| Date | Today, Week, Month, Custom |
| Till | All tills, Specific till |
| Amount | Min-Max range |
Transaction Details
Detail View
Each transaction detail shows:
- Transaction reference
- Transaction type
- Date and time
- Till name
- Operator name (if sub-user)
Fee Breakdown
| Field | Description |
|---|---|
| Amount | Transaction amount |
| Customer Fee | Fee charged to customer |
| Your Commission | Agent commission earned |
| Net Amount | Final credited amount |
Refund Option
For POS transactions, vendors can request refunds within 24 hours.
Export
Export Options
| Format | Content |
|---|---|
| Formatted report | |
| CSV | Spreadsheet data |
| Excel | Full workbook |
Export Fields
- Reference
- Type
- Customer
- Amount
- Fee
- Commission
- Status
- Date
Pagination
Transactions load in pages:
- 20 transactions per page
- Infinite scroll loading
- Pull to refresh
API Endpoints
| Endpoint | Method | Description |
|---|---|---|
/vendor/transactions | GET | List transactions |
/vendor/transactions/:id | GET | Transaction details |
/vendor/transactions/export | POST | Export data |
/vendor/transactions/:id/refund | POST | Request refund |
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| page | number | Page number |
| limit | number | Items per page |
| type | string | Transaction type filter |
| status | string | Status filter |
| fromDate | date | Start date |
| toDate | date | End date |
| tillId | string | Filter by till |
| minAmount | number | Minimum amount |
| maxAmount | number | Maximum amount |
Related Files
| File | Purpose |
|---|---|
lib/screens/transactions/transaction_list_screen.dart | Transaction list |
lib/screens/transactions/transaction_detail_screen.dart | Transaction details |
lib/widgets/transaction_list_tile.dart | List tile widget |
lib/widgets/transaction_filters.dart | Filter widget |
lib/controllers/transaction_controller.dart | Transaction controller |
lib/services/transaction_service.dart | Transaction service |