Welcome to nfc-emv-toolkit

[a7asoft]

Welcome to nfc-emv-toolkit

Thanks for stopping by. This is the home for questions, ideas, and show-and-tell around the project — a modern, read-only, PCI-safe toolkit for parsing EMV contactless card data on mobile, with native Android (Kotlin) + native iOS (Swift) and a KMP-shared parser.

Where to start

• README — project overview, scope, and what it is not
• API docs (Dokka 2) — https://a7asoft.github.io/nfc-emv-toolkit/
• Latest release — v0.3.0 — Real-card support
• CHANGELOG — CHANGELOG.md
• Contributing — CONTRIBUTING.md

Current status

v0.3.0 — pre-1.0. Real-card support shipped (Visa qVSDC kernel-3 verified against Chase Credit + Debit). API may still break before v1.0.

What this is

A focused library for the read-only contactless EMV flow: PPSE → SELECT AID → GPO → READ RECORD → parsed EmvCard. KMP-shared BER-TLV parser, AID directory, and brand detection. PCI-safe defaults: Pan.toString() masks always; no Track 2 in logs.

What this is not

Not a payment terminal SDK. No EMV kernel certification, no online auth, no ARQC, no DDA/CDA, no contact-chip reading.

How to use Discussions

• Q&A — integration questions, parser quirks, real-card troubleshooting. Answers are marked, so future readers find them fast.
• Ideas — feature wishlist, before opening a formal issue.
• Show and tell — share what you built with it. Demos, screenshots, blog posts, integrations — all welcome.
• Announcements — release notes, breaking changes, project direction. Read-only.

Reporting bugs

Bugs go on the Issues tab, not Discussions. Discussions is for open-ended conversation.

Welcome aboard.