A modern Android NFC card reader application for reading and parsing EMV contactless payment cards
THIS APPLICATION IS FOR EDUCATIONAL AND DEMONSTRATION PURPOSES ONLY.
- NOT intended for commercial or production use
- Does NOT store or transmit any card data
- All processing happens locally on the device
- PCI-DSS compliance is NOT guaranteed
- User assumes all responsibility for usage
By using this application, you acknowledge that it is intended solely for educational purposes to demonstrate NFC and EMV protocol knowledge.
Note: All card data shown in screenshots are test/sample cards, not real payment cards.
- EMV Protocol Support: Reads contactless payment cards using ISO-DEP technology
- Real-time Detection: Instant card detection with visual and audio feedback
- APDU Command Logging: Captures all communication between device and card
- Application Information: AID, application label, and priority indicator
- Transaction Data: Card number, expiration date, and card type detection
- Cardholder Data: Cardholder name when available
- EMV Tags Viewer: Browse all EMV tags organized by category with search functionality
- Material Design 3: Clean, modern interface following Material You guidelines
- Theme Support: Light, Dark, and System theme options
- Reactive Design: Built entirely with Jetpack Compose
- Sound Feedback: Success and failure audio cues (toggleable)
- APDU Commands Tab: View all command-response pairs with status codes
- Search & Filter: Find specific tags, AIDs, or APDU commands
- Detailed Logging: Configurable log verbosity levels (Not yet implemented)
- Settings Panel: Customize app behavior and appearance
- Kotlin 2.0.21
- Jetpack Compose
- Material 3
- MVVM Pattern - Clean architecture separation
- Coroutines - Asynchronous programming
- StateFlow - Reactive state management
- NFC API - Android NFC framework
- ISO-DEP - ISO 14443-4 protocol for contactless cards
- EMV Parsing - Custom EMV tag parser implementation
- Gradle KTS
- Android Studio - Koala Feature Drop | 2024.1.2 or higher
- Android device with NFC capability
- Android 15.0 (API 35) or higher
- NFC enabled in device settings
-
Clone the repository
git clone https://github.com/Pedro-kt/tap-to-pay-android.git cd tap-to-pay-android -
Open in Android Studio
- Open Android Studio
- Select "Open an Existing Project"
- Navigate to the cloned directory
-
Build and Run
- Connect your Android device via USB
- Click "Run" or press
Shift + F10 - Grant NFC permissions when prompted
Pre-built APKs will be available in the Releases section
- PPSE Selection: App sends SELECT command for Proximity Payment System Environment
- AID Discovery: Extracts Application Identifier (AID) from PPSE response
- Application Selection: Selects the payment application using discovered AID
- GPO Command: Sends Get Processing Options with PDOL data
- Record Reading: Reads card records from Application File Locator (AFL)
- EMV Parsing: Parses all EMV tags and organizes by category
- Data Display: Shows formatted card information with search capabilities
The app recognizes and parses EMV tags including:
- Application Info: AID (4F), Application Label (50), Priority (87)
- Transaction Data: PAN (5A), Expiration (5F24), Service Code (5F30)
- Cardholder Data: Name (5F20), Language (5F2D)
- Card Details: Track 2 (57), PDOL (9F38), AFL (94)
- And many more...
This is primarily a portfolio project, but suggestions and feedback are welcome!
- Fork the repository
- Create a feature branch (
git checkout -b feat/AmazingFeature) - Commit your changes with conventional commits (
git commit -m 'feat(feature): description of feature') - Push to the branch (
git push origin feat/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
Bustamante Pedro
- GitHub: @Pedro-kt
- Project: tap-to-pay-android
- No data storage: Card data is never persisted to disk
- No network requests: All processing is done locally
- No analytics: No tracking or telemetry
- Open source: Code is fully transparent and auditable
- EMV specifications by EMVCo
- Android NFC documentation
- Material Design 3 guidelines
- Jetpack Compose community
Remember: This is an educational project. Never use it to process real payment transactions.
Made for learning and demonstration purposes