Skip to main content
Version: v3000

iOS

v3000.0.0​

New fraud detection: BIN intelligence​

BIN intelligence enhances payment risk assessment at the moment of card capture. Real-time BIN lookup validates the PAN and returns detailed card information, including type, brand, category, issuing bank, and issuer country. This additional fraud signal helps customers identify high-risk transactions early, before the transaction begins.

Architectural shift: session-based API​

The legacy Recognizer architecture is deprecated. BlinkCard v3000 moves to a session-based model, decoupling scanning logic from the UI lifecycle and enabling a headless integration for custom implementations.

Epoch versioning scheme​

We are moving to an Epoch-based versioning system: (EPOCH * 1000 + MAJOR).MINOR.PATCH. This new versioning makes it easier for customers to immediately identify the impact of an update and plan upgrades with confidence.

  • EPOCH: Fundamental architectural rewrites.
  • MAJOR: Breaking API changes.
  • MINOR: New features, backward-compatible.
  • PATCH: Bug fixes.

Other improvements​

  • i18n: Expanded localization support to better serve a global user base: we added 33 new languages, bringing the total supported languages to 56, enabling a more convenient user experience across diverse regions.
  • a11y: Enhanced accessibility capabilities, including support for screen readers.
  • We introduced more granular event tracking throughout the SDK lifecycle, enabling customers to gain deeper insights into success rates and drop-off points during scanning sessions. These enhanced analytics help identify optimization opportunities and ensure an improved, more reliable user experience.
  • Improved photocopy detection model, reducing FAR@FRR of 1% from 27.53% to 13.69%, significantly enhancing reliability.

Highlights & integration improvements​

  • Lighter SDK: By incorporating dynamic model loading, BlinkCard v3000 drastically reduces download size from ~10MB to ~2.4MB, and lowers memory usage.
  • Backward compatibility: Existing production keys will continue to work with v3000.0.0. No new license key is required for the upgrade.
  • More maintainable codebase: This new architecture sets the stage for easier and faster updates.
  • Updated minimum OS requirement:
    • BlinkCard framework now requires iOS 15.0 or newer, while the BlinkCardUX package requires iOS 16.0 or newer. This update allows us to leverage modern development practices, improve stability, and streamline future updates.
    • Both frameworks are built for XCode 26.2.0

Architecture changes​

  • Modern Swift features: Written fully in Swift, the code is simple and easy to work with.
  • SwiftUI: SwiftUI is the main driver for the UI through BlinkCardUX package.
  • Simplified flow: More straightforward API with clearer separation of concerns.

Major API changes​

  • SwiftUI & modular SDK
    • UI is now built with SwiftUI, simplifying integration via BlinkCardUX.
    • The SDK is modular:
      • BlinkCard for scanning logic.
      • BlinkCardUX for prebuilt UI components.
  • Simplified initialization & result handling
    • New SDK initialization method: 
      let settings = BlinkCardSdkSettings(licenseKey: "<key>", helloLogEnabled: true)
      let sdk = try await BlinkCardSdk.createBlinkCardSdk(withSettings: settings)
    • Results are now retrieved through structured session-based async-await callbacks instead of recognizer bundles.
  • Enhanced UI customization & source-available UX
    • UXThemeProtocol enables direct customization of typography, colors, and strings.
    • The source-available UI layer allows advanced modifications for branding and accessibility.

Plan your upgrade​

We have prepared transition guides to help you get started with BlinkCard v3000.0.0:

These guides outline all major API changes and best practices for migrating existing code.

For any questions or feedback, reach out to support@microblink.com. We value your input and look forward to hearing how BlinkCard v3000 improves your app’s experience!

2.12.0​

Improvements​

  • Integrated a tilt detector that will improve the quality of captured images and the extracted data
    • new UI message Keep card parallel to phone for detection status MBCDetectionStatusCameraAngleTooSteep
  • Integrated a stability check to ensure consecutive images for extraction are consistent
  • Improved accuracy of owner field extraction

Bug fixes​

  • Fixed issue with anonymization of vertical cards where in some cases sensitive fields were not anonymized correctly
  • Fixed issue with anonymization of cards when document was scanned at a steep angle
  • Fixed issue with images when extension are enabled that resulted in an incorrect aspect ratio

2.11.1​

Behavior Changes​

  • Improved extraction of the 'owner' field (3 consecutive frames are used)
  • Only digits are allowed in card number, CVV, and date of expiry result
  • Only alphas are allowed in owner result

2.11.0​

Improvements​

  • Improved data extraction accuracy across all supported card types

UI changes​

  • Added success checkmark after a successful first side scan
  • Added an error state when scanning the wrong side of the card
  • Minor changes in scanning instruction messages

2.10.1​

Bug-fixes:​

  • Fixed the incorrectly displayed strings and button action in the 'permission-denied' screen, which is displayed when the end-user denies the camera access.

2.10.0​

  • Improved performance of photocopy detection model
  • Adjusted thresholds for screen detection model in order to decrease FAR and FRR of existing model

2.9.1​

  • added privacy manifest
  • added support for license keys that support multiple application IDs

2.9.0​

What's new in the BlinkCard Recognizer?​

  • Improved scanning performance and added support for virtually any card layout
  • Improved IBAN parser which now supports more IBAN formats
  • Added option allowInvalidCardNumber which allows reading invalid card numbers to avoid endless scanning on samples and test cards:
    • use with care as it might reduce accuracy in certain situations in production
    • for invalid card number the flag cardNumberValid in BlinkCardRecognizerResult will be set to false

Improvements​

  • Better support for RTL languages in our default UX

Breaking API changes:​

  • Removed legacy recognizers: LegacyBlinkCardRecognizer and LegacyBlinkCardEliteRecognizer

2.8.2​

New features:​

  • Added reticle customizations in MBCBlinkCardOverlayTheme:
    • UIImage defaultReticleImage -
    • UIImage errorReticleImage
    • UIImage reticleColor
    • UIColor reticleDefaultColor

2.8.1​

  • Internal improvements

2.8.0​

Improvements​

  • Included hand, photocopy, and screen detection models to achieve liveness functionality
  • Added anonymization info on which side was anonymized. String data is anonymized using an asterisk instead of blanking the result.
  • Expanded the number of supported credit card types by 100%.
  • Improved data extraction, including a 30% reduction in incorrect processing of CVV field.

What's new in the BlinkCard Recognizer?​

  • Added new properties handScaleThreshold, handDocumentOverlapThreshold, screenAnalysisMatchLevel, photocopyAnalysisMatchLevel. These settings define behaviour of the new liveness features.
  • Added a new delegate BlinkCardRecognizerDelegate with a callback livenessStatusCallback that is called when each side of a card is scanned. It is called with one parameter, a LivenessStatus enum.

BlinkCard Recognizer Result​

  • Two new booleans: firstSideAnonymized and secondSideAnonymized.
  • New property DocumentLivenessCheckResult which has new liveness model results.

2.7.0​

New features:​

  • Improved support for diverse credit card designs.

New user instructions that lead to successful scans​

  • More detailed instructions on how to scan credit cards, via an intro tutorial or tooltip during scanning, leading to improved success rates in credit card scanning and data extraction.

New layout for BlinkCardOverlayViewController​

  • The scanning screen now shows a reticle in the center with scanning instruction.

What's new in the BlinkCard Recognizer?​

  • Added a new property fallbackAnonymization in AnonymizationSettings. If true, anonymization is applied on all fields of the image if extraction is uncertain.
  • Improved anonymization performance.

2.6.0​

​

Improvements​

  • We’ve added support for 1000+ new credit card types.
  • Decrease of wrongly PAN field processing by 30% for horizontal credit cards, and by 60% for vertical credit cards.
  • Improvements in the Anonymization functionality for Quick Read formats on VISA credit cards, as well as general improvements for all other credit card types.

2.5.1​

Visual identity update​

  • We’ve updated Microblink logo and colors

2.5.0​

Improvements and fixes:​

  • Improved date extraction from partial dates.
  • Fixed broken anonymization in result screen when the PAN number was anonymized but the image was not. We now correctly anonymize the image too.

2.4.0​

Improvements and fixes:​

  • We now support landscape orientation on BlinkCardEditViewController screen
  • From now on, BlinkCard reads and extracts the expiry date in MM/YYYY format

2.3.0​

New features:​

  • We’ve added support for vertical payment cards.
  • As of this release, BlinkCard supports the Visa Quick Read format (the one where the card number spans through four lines).
  • We've changed the threshold for "Camera too far" and "Camera too near" callbacks. From now on, the card needs to be closer to the camera.

Carthage:​

  • To use BlinkCard SDK with Carthage, please update to Carthage v0.38.0.
  • We've added XCFramework support
    • Run carthage update --use-xcframeworks

2.2.0​

New features:​

  • We've added support for even more horizonal card layouts
  • We've added anonymization options for string and image results:
    • Anonymization is available for these fields:
      • Card number
      • Card number prefix
      • CVV
      • Owner
      • IBAN
    • Choose the MBCBlinkCardAnonymizationMode for each field:
      • None
      • ImageOnly - Black boxes will cover chosen data
      • ResultFieldsOnly - String data is redacted from the result, images are not anonymized
      • FullResult - Both images and string data are anonymized
    • Card number has further anonymization options available through MBCCardNumberAnonymizationSettings:
      • prefixDigitsVisible - Defines how many digits at the beginning of the card number remain visible after anonymization
      • suffixDigitsVisible - Defines how many digits at the end of the card number remain visible after anonymization

Bug fixes:​

  • We've fixed missing CFBundleVersion and CFBundleShortVersionString from Info.plist bug

2.1.0​

New features:​

  • We have full support for Apple Silicon!

Framework formats and architectures:​

  • Use .xcframework as we now have full Apple Silicon and Intel support.
  • We are still supporting fat binary .framework format, but we’ve removed simulator slices from it.

Carthage:​

  • Carthage still doesn't support binary .xcframework, so there is no support for simulator slices anymore.

Other improvements:​

  • We’ve updated our default UI with new error messages that appear when a user doesn’t place the card within a frame.
  • We’re no longer hiding the security code on the edit results screen.

Bug fixes:​

  • We’re now displaying whatever data we manage to extract before a user chooses to enter card details by hand.

2.0.0​

BlinkCard v2 Release Announcement​

  • We're proud to announce our AI-driven BlinkCard v2.0! Extract the card number (PAN), expiry date, owner information (name or company title), IBAN, and CVV, from a large range of different card layouts.

As of this version, BlinkCard SDK is fully compatible with other Microblink SDKs, which means that you can use it with other Microblink SDKs in the same application.

  • BlinkCard v2.0 now scans and extracts data from payment cards with all the information on the back side!

  • MBCBlinkCardRecognizer is a Combined recognizer, which means it's designed for scanning both sides of a card. However, if all required data is found on the first side, BlinkCard doesn’t require scanning of the back side. In that case, you'll receive results after scanning the side that contains all the information. A set of required fields is defined through the recognizer's settings.

  • "Front side" and "back side" are terms more suited to ID scanning. We start the scanning process with the side containing the card number. This makes the UX easier for users with cards where all data is on the back side.

  • We've expanded the set of possible recognizer states with StageValid. This state is set when first side scanning completes with valid data, and second side scanning is required.

  • Available MBCBlinkCardRecognizer:

    • You can toggle mandatory extraction of all fields except the PAN.
    • You can enable the blur filter. When blur filtering is enabled, blurred frames are discarded. Otherwise, we process the blurred frames but set the blur indicator result member.
    • You can define required padding around the detected document. This ensures some empty space exists between the document and the edge of the frame.

  • MBCBlinkCardRecognizerResult structure:

    • Contains:
      • The card issuer
      • PAN
      • PAN prefix
      • Expiry date
      • Owner information
      • IBAN
      • CVV
      • Cropped document images
      • Blur indicators for both sides
      • Processing status
    • Processing status can be one of:
      • Success - if the process ended successfully and data is valid
      • DetectionFailed - if detection of the document failed
      • ImagePreprocessingFailed - if preprocessing of the image failed
      • StabilityTestFailed - if inconsistent results were detected between different video frames (when video processing, we require at least two frames with consistent data, for image processing this isn't applicable)
      • ScanningWrongSide - if the first side presented in the scanning process does not contain the PAN, or when the user failed to present the second side
      • FieldIdentificationFailed - if we detected a field, but we're unable to parse it (possible glare issues, or a finger covering the field)
      • ImageReturnFailed - failed to return requested images
      • UnsupportedCard - this card layout is currently unsupported.

New features:​

  • We added a new BlinkCard screen that allows users to edit MBCBlinkCardRecognizer scan results:

    • This screen allows users to edit scanned data and input data that wasn't scanned.
    • Enable it by setting enableEditScreen to YES/true on MBCBlinkCardOverlaySettings.
    • Configure which fields should be displayed on this screen by using fieldConfiguration property on MBCBlinkCardOverlaySettings.
    • Set your custom theme with MBCBlinkCardOverlayTheme class
    • Change default strings - follow our Localization guide.
    • To get user-edited fields, implement blinkCardOverlayViewControllerDidFinishEditing method from MBCBlinkCardOverlayViewControllerDelegate protocol
    • This feature is available only for MBCBlinkCardRecognizer.
    • If you are using custom UI, you can launch edit screen by initializing MBCBlinkCardEditNavigationController and setting initialized MBCBlinkCardEditViewController as root view controller

  • We updated the default MBCBlinkCardOverlayController scanning screen:

    • Instructions on how to reduce glare wil be displayed when user enables flashlight, you can disable it with showFlashlightWarning property on MBCBlinkCardOverlaySettings.
    • If edit screen is enabled, new button will show up after 5 seconds of unsuccessful scanning to allow user to go directly to edit screen.

  • We added disableMicroblinkLogging method to MBLogger for easier implementation

    • This also enables disabling Microblink logging in Swift.

  • We added Carthage support

    • For now, Carthage is supported for fat binaries, .framework. We will support .xcframework as soon Carthage is updated.
    • Please check out our guide for implementation

  • We added Swift Package Manager support

    • Please check out our guide for implementation.

Note on ARM Macs​

  • We are supporting ARM64 Device slice through our .xcframework format.
  • We are still in development supporting ARM64 Simulator slice for newly released ARM Macs and we will update our SDK with ARM64 Simulator support as soon as development is done.

iOS Version support change:​

  • From now on, we are not supporting iOS 8 version.

Cocapods support change:​

  • We are updating our Cocoapods with .xcframework format from now on. Please download Cocoapods 1.10.0 or newer to use our SDK.

Improvements:​

  • We have translated complete SDK to following languages: Arabic(UAE), Chinese simplified, Chinese traditional, Croatian, Czech, Dutch, English, Filipino, French, German, Hewrew, Hungarian, Indonesian, Italian, Malay, Portuguese, Romanian, Slovak, Spanish, Slovenian, Thai and Vietnamese.
  • We have improved recognition timeout logic when using MBCBlinkCardRecognizer.
    • When credit card has multiple sides to scan, timeout timer for the second side starts after the second side of the card has been detected. Previously, it has been started immediately after the first side has been scanned.
    • Timeout duration can be configured by using partialRecognitionTimeout on MBCRecognizerCollection

Major API changes:​

  • To ensure compatibilty with other Microblink SDKs, we have reprefixed all classes. All classes have MBC prefix instead of MB
  • We have renamed framework from Microblink to BlinkCard
  • We added error callback when setting license keys on MBCMicroblinkSDK
    • You will be getting error callback and reason why you could not unlock SDK - see MBCLicenseError
  • We moved all resources inside framework, we are not shipping bundle anymore.

Minor API changes:​

  • We have renamed old MBBlinkCardRecognizer and MBBlinkCardEliteRecognizer recognizers to MBCLegacyBlinkCardRecognizer and MBCLegacyBlinkCardEliteRecognizer. They are now deprecated.
  • We renamed MBRecogitionMode to MBCRecognitionDebugMode in MBCRecognizerCollection.
  • Swift:
    • We renamed all sharedInstance to shared
    • All enums are now Int
    • All unsigned integers are now Int

Bug fixes:​

  • We fixed race conditions and camera asserts that could sometimes cause crashes.
  • We removed OpenGL entirely which was causing unexpected crashes.
  • We added a nullable attribute to the recognizerRunnerViewControllerWithOverlayViewController to fix a force unwrapping issue in Swift that could occur if the camera is broken or not working.

1.2.0​

New features:​

  • Introducing support for new framework format - XCFramework:
    • it contains all the necessary device and simulator architecture slices
    • no neeed to remove simulator slices before distributing your app to the App Store as described here
    • for now, only available from this repo, not available on Cocoapods
  • Added presets for camera - Preset1080p, and 4K; Optimal always chooses the highest quality
  • We added the option to disable Microblink logs in the console output. Use MBLogger class and conform to MBLoggerDelegate in AppDelegate. To disable logs, implement delegate method - (void)log:(MBLogLevel)level format:(const char *)format arguments:(va_list)arguments. Be careful with this option. We need full log outputs from the application for support purposes. In case of having problems with scanning certain items, undesired behavior on the specific device(s), crashes inside SDK or anything unmentioned, we will need a full log from your side. If you disable Microblink logging, you won't be able to provide us this information. Hence support might be limited
  • We are now delivering the complete list of open source dependencies used in the SDK. Please check the open-source-software-used directory

Improvements in existing features:​

  • When using MBPermissionDeniedViewController, it will prefer CFBundleDisplayName over CFBundleName

Bug fixes:​

  • Fixed missing umbrella headers - you can now use MBCustomOverlayViewController to create custom scanning views
  • Large memory consumption introduced in v1.1.1 is due to 4K video session on all 4K eligible iPhones; we introduced new camera presets 1080p and 4K, so to reduce your app memory consumption set camera preset on 1080p or 720p
  • Fixed catching exceptions as setting license key from MBMicroblinkSDK

1.1.1​

  • Bugfixes:
    • added missing extractIban property which says it should extract the payment card's IBAN
    • fixed Torch activation for all iOS versions
    • fixed OpenGL code which was fragile and sensitive to crashes if used from multiple threads

1.1.0​

  • Major API changes:

    • Swift Module has been renamed from MicroBlink to Microblink

  • Minor API changes:

    • methods pauseScanning and resumeScanningAndResetState in MBRecognizerRunnerViewController do not return anymore BOOL
      • use isScanningPaused to check if scanning is paused

  • Improvements in ID scanning performance:

    • improved MBBlinkCardRecognizer:
      • now extracts IBAN from the Payment / Debit card
    • in MBBlinkCardRecognizerResult and MBBlinkCardEliteRecognizerResult, documentDataMatch value is now returned as MBDataMatchResult enum with three possible values: NotPerformed, Failed and Success

  • Bugfixes:

    • fixed bug in MBBlinkCardRecognizer:
      • anonymizeCvv now works independently of any other anonymization setting
    • fixed memory leaks that could cause crashes in some cases
    • fixed turning on/off flashlight on iOS 13.1.3

1.0.1​

  • fixed bug in MBBlinkCardOverlayViewController which caused memory issues

1.0.0​

  • BlinkCard framework that includes only the capability to scan payment cards.
Last updated on