Error Codes

The following table is a reference for possible errors within Schlage Mobile Access

PlatformError CodeMessageDescription
sdkConfigurationInvalidSubscripitionKeyAn error has occurred accessing the SDK Configuration, make sure all parameters are set.

Occurs when the parameters for the configuration method are incorrect.

Verify values provided to initialize the SDK configuration.

sdkConfigurationInvalidConfigConfig must not be null

Occurs when the SDK config has not been initialized.

Verify the SDK config has initialized correctly.

sdkConfigurationInvalidApplicationApplication must not be null

Occurs when the Application parameter is null or not included in the SDK config.

Verify Application object is initialized prior to initializing SDK config.

enrollmentInvalidIdTokenInvalid idToken. Please check with your access provider that your idToken is still valid.

Occurs when the idToken provided to the enrollment method of the SDK has expired or is incorrect.

Verify value of idToken

enrollmentInvalidIntegrationIdInvalid Integration Id. Please ensure that your integration has already been setup in the mobile access hub.

Occurs when the integrationId provided to the enrollment method of the SDK has expired or is incorrect.

Verify value of integrationId

enrollmentAccountConflictAn account is already registered for this device, please use that information or restart the entire enrollment process

Occurs when the mobile device being enrolled is already registered to another integration or account.

enrollmentDeviceEncryptionKeyErrorInvalid device encryption key. Please ensure you are using a proper context and your device supports secure storage.

Occurs during enrollment method of the SDK and the device doesn't have secure storage or proper encryption key.

Verify version of mobile OS that supports secure storage.

enrollmentAccountConnectionErrorAn unknown error occurred while attempting to connect your account

Occurs during enrollment method when a general error occurs.

Verify mobile device has access to a data network.

sdkDeviceNotRegisteredDevice is not registered, please perform enrollment before continuing

Occurs when attempting SDK methods prior to successful execution of the enrollment method.

Verify mobile device enrolled successfully prior to scanning for edge devices, retrieving access rights or payloads, or other SDK methods.

payloadsInvalidAccessRightRequest failed due to an invalid access right.

Occurs when trying to retrieve access payloads for the mobile device.

Verify access right is formatted correctly.

deviceNullErrorCredentialBleDevice not initialized

Occurs when trying to perform operations on a BLE edge device object that is null or not initialized.

deviceUnknownErrorAn unknown error occurred while attempting to access the device.

Occurs when communicating from the mobile device to an edge device and an error occurs.

deviceInvalidRequestPayload invalid

Occurs when presenting an access payload (credential) to the edge device and the payload is invalid.

Verify the credential has been added to the edge device correctly.

deviceConnectionFailDevice connection failedAndroid only

Occurs when connecting to an edge device and the connection request fails.

Verify good signal between mobile device and edge device.

deviceCommunicationFailDevice communication failed

Occurs when communicating with an edge device and the communication fails.

Clear SDK device cache by calling method clearDeviceCache() and retry.

devicePayloadFailAccess failed

Occurs when presenting an access payload (credential) to the edge device and the edge device fails to grant access.

Verify the credential has been added to the edge device correctly.

devicepPayloadTimeoutAccess request timed out

Occurs when presenting an access payload (credential) to the edge device and communication times out.

Verify good signal between mobile device and edge device.

searchFailedUnable to start scan

Occurs when scanning for edge devices.

Verify the mobile device is not already scanning.

unsupportedDeviceDevice type not supported

Occurs when trying to access an edge device that is not currently supported.

unknownErrorAn unknown error occurred 'specific action'

Refer to the 'specific action' to determine when the error occurred.

mahServerErrorRequest failed while attempting to contact the server

Occurs during mobile device enrollment or retrieval of access rights or access payloads.

Verify mobile device has access to a data network.

mahInvalidSubscriptionKeyAccess denied due to invalid subscription key. Make sure to provide a valid key for an active subscription.

Occurs during mobile device enrollment or retrieval of access rights or access payloads.

Verify subscription key is valid and not expired.

mahInvalidHeadersAccess denied due to invalid headers.

Occurs during mobile device enrollment or retrieval of access rights or access payloads.

Verify subscritpion key is valid and not expired..

sdkStorageErrorStorage facility failure.

Occurs during mobile device enrollment or retrieval of access rights or access payloads.

Verify version of mobile OS that supports secure storage.

sdkNullValueError'value' must not be null

Refer to the 'value' to determine the specific cause.