P2P-CARD

P2P Card - Digital Wallet Application
P2P Card is a comprehensive digital wallet (fintech) application built for the Haitian market, with a modern Flutter mobile app, Node.js backend, and Firebase infrastructure.

Core Purpose
A mobile-first digital wallet enabling users to:

Manage digital balances (USD, Crypto)
Order and manage virtual USD Mastercard cards (via Bridgecard integration)
Send/receive money P2P (peer-to-peer transfers)
Make crypto deposits
Integrate with local payment providers (MonCash)
Technology Stack
Layer Technology
Mobile App Flutter 3.x (iOS/Android)
Backend Node.js/Express
Database Firebase Firestore
Auth Firebase Authentication
Storage Firebase Storage
Push Notifications Firebase Messaging
Card Issuer Bridgecard (Mastercard virtual cards)
Hosting Google Cloud Run / Render.com
Web Portal Static HTML/JS hosted on Firebase
Key Features
User Features
Authentication: Email/password login with PIN-based quick access, 2FA support
KYC Verification: Mandatory identity verification before card issuance (ID upload, selfie camera)
Balance Management: View balances in USD, card balance, crypto
Virtual Cards: Order USD Mastercard, fund/unload, freeze/unfreeze, view transactions
Send Money: P2P transfers via QR code scanning
Deposits: MonCash integration, crypto deposits
Withdrawals: Cash out functionality
Transaction History: Full transaction tracking with receipts
Biometric Security: Local authentication support
Device Management: Track and manage logged-in devices
Admin Features (Web Dashboard)
User management
KYC review/approval
Card administration
Financial oversight
AML (Anti-Money Laundering) checks
Transaction logs
Promoter management
Backend API Endpoints
Category Routes
Auth Login, signup, OTP, web auth
Cards Create, fund, freeze, transactions (Bridgecard API)
KYC Submit documents, status checks
AML Risk scoring, compliance checks
User Profile, balance, device security
Fees Transaction fee calculations
MonCash Local payment integration
Webhooks Bridgecard events processing
Admin Dashboard, user management, finance
Mobile App Screens
Screen Purpose
home_screen Main dashboard with balance overview
card_screen Virtual card management
send_screen P2P money transfers
deposit_screen Add funds (MonCash, crypto)
withdraw_screen Cash out
kyc_screen Identity verification
transactions_screen Transaction history
security_screen 2FA, PIN, biometrics
qr_scanner_screen Scan QR for payments
profile_detail_screen User profile management
Design & Branding
Primary Color: Gold/Yellow accent
Background: Dark/Black theme
Typography: Google Fonts (modern, clean)
Aesthetic: Minimalist, fintech-focused, mobile-optimized
Target Market
Region: Haiti (Haitian Creole language support)
Users: Unbanked/underbanked population seeking digital financial services
Use Case: USD-based virtual cards for online purchases, P2P transfers, remittances