Skip to main content

Handling the iOS Data Capture SDK license

License key​

To run the Scanbot SDK within your production app, you must purchase and use a valid Scanbot SDK license.

Each license key is valid only for a given app bundle identifier. You will be unable to use any of the SDK features if the license key is corrupted, expired, or invalid in any other way.

Trial license​

The Scanbot SDK will run without a license for one minute per session.

To get an unrestricted, "no-strings-attached" 7-day trial license, please submit the Trial License Form on our website.

Kindly note that a trial license can only be used in a development and staging environment. You are not allowed to publish your app to the App Store, Play Store, or any third-party Android App Store with a trial license.

Purchase a production license​

To get pricing information and purchase a production license for the Scanbot SDK, please request a quote.

License checks in production apps​

If your Scanbot Data Capture SDK license has expired, any call to the Scanbot Data Capture SDK API will not work. You should always check for license expiration during the runtime by using one of the following methods:

  • Scanbot.isLicenseValid This method returns a simple boolean flag. false means the license is not valid or has expired and you should disable any usage of the Scanbot Data Capture SDK functions or UI components.

  • Scanbot.licenseStatus This methods returns more details about the status of the current license key.

We highly recommend implementing a suitable handling of this case in your app!

Example code for checking the license status:

if Scanbot.isLicenseValid {

  // Making your call to the Scanbot Data Capture SDK API is now safe.
  // E.g. launch the scanner UI, detecting documents on an image, etc ...
}

Updating the license in production apps​

The expiration date and the feature list of a license are contained in the license key string as encrypted data. This means that renewing or extending a license will cause a new license key string to be generated.

To renew an expired license or extend a valid license with additional Scanbot SDK features, you will have to deploy a new version of the app with an updated license key.

Alternatively, you can dispatch the new key via Firebase Remote Config or load it from your web API, but we do not provide an out-of-the box solution for this.

Want to scan longer than one minute?

Generate a free trial license to test the Scanbot SDK thoroughly.

Get your free Trial License

On this page