Skip to main content

Handling the Android Barcode Scanner 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 a free 7-day trial license, please submit the trial license form on our website.

Please note that you may only use a trial license in development and staging environments. You are not allowed to publish your app to the App Store, Play Store, or any third-party app store without a production license.

Purchasing a production license​

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

License checks in production apps​

The following is an example of how to check the license status:

Check License Status
loading...

The Scanbot Barcode Scanner SDK also has a special callback that helps handle the license status.

Handle License Status
loading...

licenseInfo - an object that represents the license information. It is also available from ScanbotBarcodeScannerSDKInitializer(context).licenseInfo

licenseInfo.status: An enum for the current license status.

licenseInfo.licenseStatusMessage: A string that helps to understand the current license status.

  • StatusOkay: The license is valid and accepted.
  • StatusTrial: No license set yet. The SDK is in trial mode.
  • StatusFailureNotSet: No license set yet. The SDK's trial mode is over.
  • StatusFailureCorrupted: No license active. The set license was unreadable or has an invalid format.
  • StatusFailureWrongOS: No license active. The set license does not cover the current operating system.
  • StatusFailureAppIDMismatch: No license active. The set license does not cover the current app's bundle identifier.
  • StatusFailureExpired: No license active. The set license is valid but it has expired.

licenseInfo.expirationDate: Returns Date of license key expiration or null if license is not valid.

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 free trial license

On this page