Transactions

The Transactions section provides comprehensive monitoring and management of all financial transactions in the Keshless system.

Screenshot

Transaction List

Table Columns

Column	Description
Reference	Transaction ID
Type	Payment, Top-up, Withdrawal, Transfer
From/To	Parties involved
Amount	Transaction value
Fee	Charged fees
Status	Completed, Pending, Failed
Date	Transaction timestamp
Actions	View details

Filtering

Filter Options

Filter	Options
Type	All, Payment, Top-up, Withdrawal, Transfer
Status	All, Completed, Pending, Failed, Reversed
Date Range	Today, Yesterday, Week, Month, Custom
Amount	Min-Max range
User	Search by phone
Vendor	Select vendor

Quick Filters

Filter	Description
Today	Transactions from today
Yesterday	Previous day transactions
This Week	Current week
This Month	Current month
Custom	Date range picker

Summary Cards

Metric	Description
Total Volume	Sum of transaction amounts
Transaction Count	Number of transactions
Total Fees	Sum of collected fees
Avg Transaction	Average transaction value

Transaction Details

Info Card Fields

Field	Description
Reference	Unique transaction ID
Type	Transaction type badge
Amount	Transaction value
Fee	Charged fee
Net Amount	Amount after fees
Date	Transaction timestamp
Status	Current status
Failure Reason	Error message (if failed)

Parties Card

Field	Description
Sender	Name and phone of sender
Recipient	Name and phone of recipient
Vendor	Processing vendor (if applicable)

Ledger Entries

Column	Description
Account	Account name
Debit	Debit amount
Credit	Credit amount

Shows the double-entry accounting entries for the transaction.

Timeline

Field	Description
Created	Initial creation timestamp
Processing	When processing started
Completed/Failed	Final status timestamp
Events	Additional status changes

Export Options

Format	Description
CSV	Spreadsheet compatible
Excel	Full workbook with formatting
PDF	Formatted printable report

Export Fields

• Reference
• Type
• Sender (name, phone)
• Recipient (name, phone)
• Amount
• Fee
• Net Amount
• Status
• Date/Time

Transaction Actions

Action	Description	Permission
View	Open transaction details	All
Reverse	Reverse completed transaction	Admin
Export	Download transaction data	Admin

API Endpoints

Endpoint	Method	Description
/admin/transactions	GET	List transactions
/admin/transactions/:id	GET	Transaction details
/admin/transactions/:id/ledger	GET	Ledger entries
/admin/transactions/:id/reverse	POST	Reverse transaction
/admin/transactions/export	POST	Export data
/admin/transactions/summary	GET	Summary stats

Related Files

File	Purpose
src/pages/transactions/TransactionsPage.tsx	List page
src/pages/transactions/TransactionDetailPage.tsx	Detail page
src/components/transactions/	Transaction components
src/services/transactionService.ts	API service
src/types/transaction.ts	Type definitions