Troubleshooting

What you seeWhat 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 startThe 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 onceThe 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 / unsupportedDeviceThe 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 startCheck 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.2A 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 opensNo NSCameraUsageDescription in Info.plist
iOS: “requires iOS 15” / the project does not buildSet Minimum Deployments (and platform :ios in the Podfile) to 15.0 or higher
iOS simulator: no camera pictureThe simulator has no camera. Run sessions on an iPhone
React Native: the iOS Debug build with USE_FRAMEWORKS does not linkA React Native 0.87.1 issue. Use static linkage (the default) for Debug
No analytics eventsNeuroVisionKycPostHogKey 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.