react-native-nfc-card-scanner

EMV contactless credit & debit card reader for React Native. Extracts PAN and expiry via NFC in controlled environments, depending on card issuer policies and device support.

Platform note: Android is the supported path. Apple Core NFC does not support payment-related AIDs, so reading a bank-card PAN on iPhone is generally blocked.

Built on top of react-native-nfc-manager.

Features

• Read EMV contactless payment cards via NFC
• Extract card number (PAN) and expiration date
• Auto-detect card scheme from AID
• Built-in EMV TLV parser
• Supports flat (70) and nested (77) EMV response templates
• TypeScript support with full type definitions

Supported card schemes

Installation

npm install react-native-nfc-card-scanner react-native-nfc-manager

react-native-nfc-manager is a required peer dependency. This package cannot run in Expo Go; use a dev client / prebuild app.

Usage

import {
  scanNfc,
  stopNfc,
  isNfcSupported,
  isNfcEnabled,
} from "react-native-nfc-card-scanner";

async function handleScanCard() {
  try {
    const supported = await isNfcSupported();
    if (!supported) return;

    const enabled = await isNfcEnabled();
    if (!enabled) return;

    const result = await scanNfc();
    console.log("Card Number:", result.pan);
    console.log("Masked PAN:", result.maskedPan);
    console.log("Expiry Date:", result.exp);
    console.log("Card Scheme:", result.scheme);
  } catch (error) {
    if (error instanceof Error) {
      console.error("NFC scan failed:", error.message);
    }
  }
}

function handleCancel() {
  stopNfc();
}

Limitations

• Not all cards expose readable PAN data
• Some issuers return masked or partial values
• iOS cannot reliably read payment-card PANs
• Results depend on region and card configuration

License

MIT

For more details, please visit the GitHub repository.