Cards
The Cards section enables administrators to manage NFC card inventory, track card assignments, and monitor card operations.
Screenshot
Cards List
Statistics
| Stat | Description |
|---|---|
| Total Cards | Total cards in system |
| Active | Currently active cards |
| Linked | Cards linked to users |
| Blocked | Blocked cards |
| Unassigned | Not linked to any user |
Table Columns
| Column | Description |
|---|---|
| Card UID | Unique identifier (masked) |
| User | Linked user (name, phone) |
| Status | Active, Blocked, Unassigned |
| Linked Date | When card was linked |
| Last Used | Last transaction timestamp |
| Actions | View, Block, Unlink |
Search & Filters
| Filter | Options |
|---|---|
| Search | UID, user name, phone |
| Status | All, Active, Blocked, Unassigned |
Card Details
Info Card Fields
| Field | Description |
|---|---|
| Card UID | Full unique identifier |
| Card Type | Card type/brand |
| Status | Current status |
| Created | Registration date |
| Linked | When linked to user |
| Last Used | Last transaction |
| Blocked | Block timestamp (if blocked) |
| Block Reason | Reason for blocking |
Linked User
When card is linked to a user:
- User name
- Phone number
- Account status
- Link to user profile
Card Actions
Available Actions
| Action | Description | Condition |
|---|---|---|
| Reset PIN | Clear PIN for re-setup | Active, linked |
| Block Card | Block with reason | Active |
| Unblock Card | Restore to active | Blocked |
| Unlink | Remove user association | Linked |
Block Reasons
| Reason | Description |
|---|---|
lost | Reported Lost |
stolen | Reported Stolen |
fraud | Suspected Fraud |
user_request | User Request |
other | Other |
Card Transactions
Recent transactions made with the card:
| Column | Description |
|---|---|
| Date | Transaction timestamp |
| Type | Transaction type |
| Amount | Transaction value |
| Vendor | Processing vendor |
| Status | Transaction status |
Activity Log
Card activity history:
- Created
- Linked to user
- PIN set
- Transactions
- Blocked/Unblocked
- Unlinked
API Endpoints
| Endpoint | Method | Description |
|---|---|---|
/admin/cards | GET | List cards |
/admin/cards/stats | GET | Card statistics |
/admin/cards/:id | GET | Card details |
/admin/cards/:id/block | POST | Block card |
/admin/cards/:id/unblock | POST | Unblock card |
/admin/cards/:id/unlink | POST | Unlink from user |
/admin/cards/:id/reset-pin | POST | Reset PIN |
/admin/cards/:id/transactions | GET | Card transactions |
/admin/cards/:id/activities | GET | Activity log |
Related Files
| File | Purpose |
|---|---|
src/pages/cards/CardsPage.tsx | List page |
src/pages/cards/CardDetailPage.tsx | Detail page |
src/components/cards/ | Card components |
src/services/cardService.ts | API service |
src/types/card.ts | Type definitions |