EMV chip card reading library with support for PSE/PPSE application selection, GPO processing, record reading, TLV parsing, JH Token generation, and event-driven card read notifications. Works with contact and contactless EMV cards via PC/SC readers. Updated for 2026 release with improved documentation and copyright. Now supports both 32-bit and 64-bit Windows systems through NfcReaderLib 1.0.3.
Get Started
$ dotnet add package EMVCard.CoreReadme
EMVCard.Core
This library provides core functionality for EMV card transaction storage and processing, including:
- Transaction data model (
CardTransaction) - Storage interfaces and implementations (JSON and SQLite)
- Batch and summary operations for high performance
- .NET Framework 4.7.2 compatibility
- New in 2.2.0: Default logging enabled for all operations
Features
- Save, retrieve, filter, and export EMV card transactions
- JSON and SQLite storage backends
- Batch insert with
SaveBatchAsync - Lightweight summary queries with
GetAllSummaryAsync - Designed for integration with Windows Forms and other .NET apps
- Event-driven: Subscribe to
CardReadto react to card reads in real time - Improved Documentation: Updated guides and examples for better developer experience
- Default Logging: Enabled by default for better debugging and monitoring
What's New in v2.2.0
- Default Logging: Logging is now enabled by default across all operations
- Maintenance and compatibility improvements
- Updated NuGet version: 2.2.0
- Enhanced SQLite transaction storage with better error handling
Usage
Install via NuGet:
Install-Package EMVCard.Core -Version 2.2.0
.NET CLI:
dotnet add package EMVCard.Core --version 2.2.0
Example:
using EMVCard.Storage;
var storage = new SQLiteTransactionStorage("transactions");
await storage.SaveAsync(transaction);
// Batch insert
await storage.SaveBatchAsync(transactions);
// Get summaries
var summaries = await storage.GetAllSummaryAsync();
// Subscribe to card read event
var reader = new EmvCardReader();
reader.CardRead += (s, e) =>
{
Console.WriteLine($"Card read: {e.CardData.PAN}");
};
Requirements
- .NET Framework 4.7.2
- Newtonsoft.Json
- (Optional) System.Data.SQLite for SQLite storage
License
MIT
Copyright
Copyright holders: Johan H
NfcReaderLib
A .NET library for PC/SC smart card communication, JH Token generation, and EMV/NFC card utilities.
NuGet Packages
| Package | Version | Description |
|---|---|---|
| NfcReaderLib | 2.0.3 | PC/SC communication, JH Token generation |
| EMVCard.Core | 2.0.4 | EMV card reading, storage, and export |
Installation
Package Manager Console:
Install-Package NfcReaderLib -Version 2.0.3
Install-Package EMVCard.Core -Version 2.0.4
.NET CLI:
dotnet add package NfcReaderLib --version 2.0.3
dotnet add package EMVCard.Core --version 2.0.4
Features
- PC/SC card reader support (contact/contactless)
- 32/64-bit Windows support
- JH Token (SHA-256) generation from ICC certificates
- EMV TLV parsing, PSE/PPSE, GPO, record reading
- Card polling, PAN masking, async operations
What's New in v2.0.4
- Maintenance and compatibility improvements
- Updated NuGet version: 2.0.4
Requirements
- .NET Framework 4.7.2
License
MIT