Error handling
As the React Native SDK is a wrapper for the Android and iOS SDKs, many errors that are returned come directly from the native SDKs themselves. This is true for error codes in the ranges 9000 and higher.
These error codes are mostly consistent for the wrapper. However, there may be some small differences between the native platform errors. Every error returned from the SDK is an object that contains a code and description property. These can provide helpful information on how to recover from or handle a given error.
Every error returned from the SDK is an object that contains a code and description property. These can provide helpful information on how to recover from or handle a given error.
SDK error overview
| Error Code | Category | Scenario Occurrences | Platforms |
|---|---|---|---|
| 8000 | GENERIC ERROR | - Android & iOS | |
| 8001 | OBJECT DOES NOT EXIST | - User profile | - Android & iOS |
| 8002 | NOT AUTHENTICATED | - User | - Android & iOS |
| 8004 | OBJECT NOT FOUND | - Authenticator - Identity provider - Security Controller |
- Android & iOS - Android & iOS - Android |
| 8011 | HTTP REQUEST ERROR | - Internal - HTTP Code - No Response |
- Android & iOS - Android & iOS - iOS |
| 8012 | NOT INITIALIZED | - Onewelcome SDK | - Android |
| 8014 | INVALID URL | - iOS | |
| 8016 | ENROLLMENT FAILED | - iOS | |
| 8017 | PROCESS CANCELED | - Authentication - Registration - Login - Authenticator Registration - Authenticator Deregistration |
- iOS - iOS - iOS - iOS - iOS |
| 8023 |
Android
IDENTITY_PROVIDER_NOT_FOUND = 8001
WRONG_CONFIG_MODEL = 8002
MOBILE_AUTH_OTP_IS_DISABLED = 8003
WRONG_PIN_ERROR = 8004
RESOURCE_CALL_ERROR = 8005
AUTHENTICATOR_DOES_NOT_EXIST = 8006
PROFILE_DOES_NOT_EXIST = 8007
PARAMETERS_NOT_CORRECT = 8009
REGISTRATION_NOT_IN_PROGRESS = 8010
FINGERPRINT_IS_NOT_ENABLED = 8011
NO_PROFILE_AUTHENTICATED = 8012
MOBILE_AUTH_OTP_NOT_IN_PROGRESS = 8013
AUTHENTICATION_NOT_IN_PROGRESS = 8015
PIN_CREATION_NOT_IN_PROGRESS = 8016
ACTION_NOT_ALLOWED = 8017
INCORRECT_PIN_FLOW = 8018
nAUTHENTICATOR_NOT_REGISTERED = 8019
iOS
identityProviderNotFound = 8001
nauthenticatorDoesNotExist = 8006
profileDoesNotExist = 8007
parametersNotCorrect = 8009
registrationNotInProgress = 8010
noProfileAuthenticated = 8012
mobileAuthNotInProgress = 8013
malformedUrl = 8014
authenticationNotInProgress = 8015
pinCreationNotInProgress = 8016
actionNotAllowed = 8017
authenticatorNotRegistered = 8019
mobileAuthAlreadyInProgress = 8020
