React Native Iranian Bank Card Scanner

A powerful React Native library for scanning Iranian bank cards (debit/credit cards) using OCR technology. This package is specifically designed for Iranian banking system and supports Persian/Farsi text display.

Features

• ✅ Iranian Bank Card Support: Optimized for Iranian debit and credit cards
• ✅ OCR Technology: Advanced card number and expiry date detection
• ✅ Persian/Farsi Support: Full support for Persian text display
• ✅ Cross-Platform: Works on both Android and iOS
• ✅ Easy Integration: Simple API for React Native apps
• ✅ Custom Fonts: Support for custom Persian fonts
• ✅ High Accuracy: Optimized for Iranian card formats

Supported Iranian Banks

This scanner works with cards from major Iranian banks including:

• Bank Melli Iran (بانک ملی ایران)
• Bank Tejarat (بانک تجارت)
• Bank Saderat (بانک صادرات)
• Bank Mellat (بانک ملت)
• Bank Parsian (بانک پارسیان)
• Bank Pasargad (بانک پاسارگاد)
• And other Iranian banks

Installation

npm install react-native-payment-card-scanner

iOS Setup

cd ios && pod install

Android Setup

No additional setup required for Android.

Usage

import PaymentCardScanner from 'react-native-payment-card-scanner';

// Scan Iranian bank card
PaymentCardScanner.scan(
  'اسکن کارت بانکی', // Top text in Persian
  'کارت بانکی خود را مقابل دوربین قرار دهید', // Bottom text in Persian
  'Vazir', // Persian font family name
  'Vazir' // Persian font family name
)
  .then((result) => {
    console.log('Card Number:', result.PAN);
    console.log('Expiry Date:', result.EXP);
    console.log('CVV:', result.CVV);
  })
  .catch((error) => {
    console.error('Scan failed:', error);
  });

API Reference

PaymentCardScanner.scan(topText, bottomText, topTextFontFamily, bottomTextFontFamily)

Scans an Iranian bank card and returns the extracted information.

Parameters:

• topText (string): Text displayed at the top of the scanner (supports Persian)
• bottomText (string): Text displayed at the bottom of the scanner (supports Persian)
• topTextFontFamily (string): Font family for top text
• bottomTextFontFamily (string): Font family for bottom text

Returns: Promise that resolves to an object with:

• PAN (string): Card number
• EXP (string): Expiry date in MM/YY format
• CVV (string): CVV code (if detected)

Example Result

{
  PAN: "1234567890123456",
  EXP: "12/25",
  CVV: "123"
}

Persian Font Support

The library supports Persian fonts. You can use fonts like:

• Vazir
• Samim
• Shabnam
• IRANSans
• And other Persian fonts

Requirements

• React Native 0.60+
• Android API 21+
• iOS 10.0+

Contributing

See the contributing guide to learn how to contribute to the repository and the development workflow.

License

MIT

Author

Mohammad Navabi - mohammadnavabi.ir

This package is specifically designed for Iranian banking system and Persian language support.