Skip to content

Latest commit

 

History

History
44 lines (36 loc) · 1.54 KB

README.md

File metadata and controls

44 lines (36 loc) · 1.54 KB

NFC Bank Card Scanner Library

Platform API License

An Android library for reading bank card information via NFC technology.

✨ Features

  • ✅ Read bank card data via NFC
  • ✅ Retrieve card number (PAN)
  • ✅ Get expiration date
  • ✅ Access cardholder name (if available)
  • ✅ Simple integration
  • ✅ Supports major card networks (Visa, Mastercard, Humo, Uzcard, etc.)

📦 Installation

Add this dependency to your app's build.gradle:

dependencies {
    implementation 'io.github.kuvandikov:scan-card-nfc:0.1.4'
}

💳 BankCard Model

The library returns a BankCard object with these properties:

data class BankCard(
    val cardNumber: String,       // Primary Account Number (PAN)
    val expiryMonth: Int,         // Month (1-12)
    val expiryYear: Int,          // Year (last 2 digits)
    val cardholderName: String?,  // Cardholder name (nullable)
    val cardType: String?         // Card network (Visa, Mastercard, etc.)
)

⚠️ Important Notes

Tested with Android API 21+ Requires NFC-enabled device Works with contactless payment cards Some cards may not provide all information Read-only functionality (no writing support)

🤝 Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.