itc_sunmi_card_reader 1.0.0 copy "itc_sunmi_card_reader: ^1.0.0" to clipboard
itc_sunmi_card_reader: ^1.0.0 copied to clipboard

PlatformAndroid

A Flutter plugin for SUNMI POS card reading functionality. Enables card scanning, EMV processing, and data extraction on SUNMI Android devices only.

Changelog #

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.0.0 - 2025-09-04 #

Added #

  • Initial release of ITC SUNMI Card Reader plugin
  • EMV card processing support for SUNMI devices
  • Card data extraction (number, expiry, cardholder name, service code)
  • Track 1 and Track 2 data access
  • Real-time scan status callbacks
  • Card type detection (Visa, MasterCard, UnionPay, Amex, JCB, RuPay)
  • App selection handling for multiple payment apps
  • Comprehensive error handling and recovery
  • Support for chip cards, magnetic stripe, and contactless payments
  • Utility methods for data formatting (card number, expiry date)
  • Example app demonstrating plugin usage

Features #

  • Android-only support (SUNMI devices exclusively)
  • Minimum SDK 21 (Android 5.0+)
  • Flutter 3.3.0+ compatibility
  • MIT License
  • Real-time status updates during scanning
  • Automatic card type detection
  • EMV-compliant processing

Supported Devices #

  • SUNMI P2 series
  • SUNMI P2 Pro
  • SUNMI P2 Lite
  • SUNMI V2 series
  • Other SUNMI POS terminals with card reading capabilities

Dependencies #

  • plugin_platform_interface: ^2.0.2
  • SUNMI PayLib SDK 2.0.07
  • SUNMI Printer Library 1.0.15
  • BouncyCastle cryptography library 1.70

Documentation #

  • Comprehensive README with usage examples
  • Complete API documentation
  • Troubleshooting guide
  • Device compatibility information
  • Security and privacy guidelines

API Methods #

  • ItcSunmiCardReaderService.startCardScan() - Start card scanning
  • ItcSunmiCardReaderService.stopCardScan() - Stop scanning
  • ItcSunmiCardReaderService.selectApp() - Select payment app
  • ItcSunmiCardReaderService.formatCardNumber() - Format card number
  • ItcSunmiCardReaderService.formatExpiryDate() - Format expiry date
  • ItcSunmiCardReaderService.getCardTypeDisplayName() - Get card type display name

Data Models #

  • CardScanResult - Complete card data container
  • CardScanStatus - Scan status enumeration
  • CardScanStatusUpdate - Status update model

Example App #

  • Simple demonstration app included
  • Clean UI with status updates
  • Error handling examples
  • App selection dialog implementation
2
likes
150
points
24
downloads

Publisher

unverified uploader

Weekly Downloads

A Flutter plugin for SUNMI POS card reading functionality. Enables card scanning, EMV processing, and data extraction on SUNMI Android devices only.

Repository

Topics

#sunmi #card-reader #pos #emv #android

Documentation

Documentation
API reference

Funding

Consider supporting this project:

www.itconsortiumgh.com

License

MIT (license)

Dependencies

flutter, plugin_platform_interface

More

Packages that depend on itc_sunmi_card_reader

Packages that implement itc_sunmi_card_reader