| What you see | What to do |
|---|---|
| “Verification is not available on this domain. Please contact the site administrator.” | The app’s address is not on the server’s list of allowed origins — see Server integration, section “Allowing your app on the server”. Check the id of this very build (a debug suffix!) and the https:// prefix |
| A key or session error right after the start | The client key was encrypted with the wrong scenario secret key, or it was corrupted in transit. Check the encryption with the “Check” button next to the scenario secret key in your dashboard |
| The result of a previous check shows up at once | The session was started with a clientKey that was already used: one value has one session. Start each new attempt with a new clientKey |
Failed: UnsupportedDevice / unsupportedDevice | The app runs as x86_64 (an x86_64 emulator). Use a phone or an arm64 emulator |
Failed: Config with “a KYC session is already running” | A second session was started while the first one was running. Start the next one after the result arrives |
Failed: Config right after the start | Check apiHost: it must be the https address NeuroVision gave you; plain http works only for localhost |
| The session is cancelled when the user returns to the app through its icon (Android) | The launching activity has launchMode="singleTask". Use singleTop or standard |
Gradle: Could not find ru.neurovision.kyc:kyc-sdk:0.6.2 | A wrong path to the SDK’s Maven folder: it must hold the folder ru/neurovision/kyc/kyc-sdk/0.6.2 |
| iOS: the app crashes when the camera opens | No NSCameraUsageDescription in Info.plist |
| iOS: “requires iOS 15” / the project does not build | Set Minimum Deployments (and platform :ios in the Podfile) to 15.0 or higher |
| iOS simulator: no camera picture | The simulator has no camera. Run sessions on an iPhone |
React Native: the iOS Debug build with USE_FRAMEWORKS does not link | A React Native 0.87.1 issue. Use static linkage (the default) for Debug |
| No analytics events | NeuroVisionKycPostHogKey and NeuroVisionKycPostHogHost are missing from the manifest / Info.plist — see the guide for your platform |
What each result means and what to show the user — Results.
Still stuck? Send support the SDK version (NeuroVisionKyc.VERSION on Android, NeuroVisionKyc.version on iOS, NeuroVisionKyc.sdkVersion() in the plugins), the platform, the result's message, and the time of the session.