Skip to content

NFC EMV

7h30th3r0n3 edited this page Aug 31, 2026 · 2 revisions

💳 NFC & EMV

Flipper Zero-style NFC reader/writer/emulator for the CardputerZero


📋 Overview

The Cap CC1101+NFC HAT includes an ST25R3916 NFC controller supporting ISO14443-A at 13.56 MHz. The cap_flipper_nfc payload provides a full NFC toolkit comparable to the Flipper Zero.

Feature Details
NFC Chip ST25R3916 (SPI)
Frequency 13.56 MHz
Standards ISO14443-A, ISO14443-4
Card Types MIFARE Classic 1K/4K, MIFARE Ultralight, NTAG21x, DESFire, EMV contactless
Crypto Crypto1 (MIFARE Classic), EMV 3-pass auth
File Format Flipper Zero .nfc compatible

🎛️ Menu Items

The NFC payload has 6 main functions:

# Menu Item Description
1 Read Detect and read any NFC card. Auto-identifies type (MIFARE Classic, Ultralight, EMV). Reads all sectors/pages and decodes NDEF if present.
2 Saved Browse saved card dumps. KEY2: Delete with confirmation.
3 Emulate Emulate a saved card's UID. The CZ appears as the original card to NFC readers.
4 EMV Dedicated EMV/contactless bank card reader. Shows PAN, expiry, cardholder name, AID, country, currency, AIP, PIN tries, transaction logs.
5 Write Write a saved card dump to a blank card. Supports MIFARE Classic and Ultralight.
6 NDEF Write NDEF records to NTAG/Ultralight tags. Supports URL, Text, and WiFi records.

🕹️ Controls

Read Mode

Button Action
OK Save card to file
KEY3 Back to menu

Saved Mode

Button Action
UP/DOWN Scroll saved cards
OK View card details
KEY2 Delete (with confirmation)
KEY3 Back to menu

EMV Mode

Button Action
UP/DOWN Scroll EMV data
KEY3 Back to menu

Emulate Mode

Button Action
KEY3 Stop emulation

NDEF Write Mode

Button Action
UP/DOWN Select NDEF type (URL / Text / WiFi)
OK Enter data via on-screen keyboard
KEY3 Back to menu

💳 EMV Data Fields

The EMV reader extracts the following data from contactless bank cards:

Field Tag Description
PAN 5A Card number
Expiry Date 5F24 Expiration month/year
Effective Date 5F25 Card issue date
Cardholder Name 5F20 Name on card
AID 4F Application ID (Visa, MC, CB, etc.)
App Label 50 Application label text
App Name 9F12 Preferred name
Country Code 9F1A Issuing country (ISO 3166)
Currency Code 5F2A Card currency (ISO 4217)
Language 5F2D Preferred language
AIP 82 Application Interchange Profile (SDA/DDA/CVM/TRM/CDA flags)
PIN Try Counter 9F17 Remaining PIN attempts
ATC 9F36 Application Transaction Counter
Last Online ATC 9F13 Last online transaction counter
Transaction Logs 9F4D Historical transaction records (amount, date, currency)

Multi-AID Scan

The reader supports 47 known AIDs and uses a smart discovery sequence:

  1. PPSE (2PAY.SYS.DDF01) — discovers all applications on the card
  2. Try each AID from PPSE response until one returns a PAN
  3. Fallback — if PPSE fails, tries direct selection of 9 common AIDs:
    • Visa (A0000000031010)
    • Mastercard (A0000000041010)
    • CB France (A0000000421010)
    • Amex (A00000002501)
    • JCB (A0000000651010)
    • Discover (A0000001523010)
    • Visa Electron (A0000000032010)
    • CB Debit (A0000000422010)
    • Maestro (A0000000042010)

Supported Card Networks

Network AIDs
Visa Visa, Visa Electron, V Pay, Visa Interlink, Visa Plus
Mastercard Mastercard, Maestro, Maestro UK, Mastercard Debit, Cirrus
CB (France) CB, CB Debit, CB Specific
American Express Amex, Amex Expresspay
JCB JCB
Discover Discover, Diners
Other Interac, Bancontact, Dankort, EAPS

🔑 MIFARE Classic

Full MIFARE Classic support with Crypto1 authentication:

  • 3-pass Crypto1 authentication with PRNG (matching Flipper Zero / Proxmark3 implementation)
  • Read all 64 blocks (1K) or 256 blocks (4K)
  • Write blocks to blank cards
  • Key A and Key B authentication
  • Default keys tried automatically (FFFFFFFFFFFF, A0A1A2A3A4A5, D3F7D3F7D3F7, etc.)

📑 NTAG / Ultralight

Full NTAG21x and MIFARE Ultralight support:

  • Read all pages + signature + counters
  • GET_VERSION command for chip identification
  • Write pages individually
  • NDEF decode — URL and Text records displayed on read

NDEF Write Types

Type Description Example
URL Web link with URI prefix https://example.com
Text Plain text with language code Hello World (en)
WiFi WiFi credentials (WPA2) SSID + password

📁 File Format

Cards are saved in Flipper Zero .nfc format for interoperability:

Filetype: Flipper NFC device
Version: 4
Device type: MIFARE Classic
UID: AA BB CC DD
ATQA: 00 04
SAK: 08
Block 0: AA BB CC DD 00 08 04 00 ...
Block 1: 00 00 00 00 00 00 00 00 ...
...

Files are stored in /root/Raspyjack/loot/NFC/ and can be transferred to/from a Flipper Zero.


⚠️ Important Notes

  • The NFC field draws significant power. The driver automatically manages ext_5v_out power.
  • EMV reading is passive and legal — it reads the same data as any payment terminal during a contactless transaction.
  • MIFARE Classic keys are needed to read protected sectors. The reader tries common default keys automatically.
  • Card emulation replicates the UID only — it does not clone the full card data for payment cards.

Clone this wiki locally