Results

A session ends in exactly one result. Every outcome — a verdict, a cancel, a refused camera, no network — is a result, not an exception. The Flutter and React Native plugins throw an exception only on misuse: a second start while a session runs, or an empty request.

ResultAndroidiOSFlutterReact Native
The server judged the sessionKycResult.Completed(verdict).completed(verdict)KycCompleted(verdict){ kind: 'completed', verdict }
The user left before the end of the sessionKycResult.Cancelled.cancelledKycCancelled(){ kind: 'cancelled' }
The session could not go onKycResult.Failed(reason, message).failed(reason, message:)KycFailed(reason, message){ kind: 'failed', reason, message }

A session the server has already judged ends as completed with that verdict, whatever screen the user closes it on.

Verdicts

VerdictMeaning
successThe verification passed
failedThe verification did not pass
suspiciousThe server suspects fraud; the SDK shows it to the user as a verification that did not pass
expiredThe session’s time ran out
unknownA verdict this SDK version does not know

The verdict in the app is for the next screen. A decision that matters (opening an account, a payment limit) should rest on the session result your server gets from NeuroVision through a webhook or a session status request, not on what the app reports.

Failures

ReasonWhenWhat to show the user
cameraDeniedThe user did not allow access to the cameraThat the camera is needed, and a way to the app’s settings
networkNo connection, or it dropped and retries ran outCheck the connection and try again
serverThe server answered with an errorTry again later
cameraThe camera could not be opened, or it stopped delivering frames (another app took it)Close other apps that use the camera and try again
configThe request was refused: a wrong apiHost, a scenario id or client key the server did not accept, or another session already running (the message says which)A generic error; log the message — it is an integration problem, not the user’s
unsupportedDeviceAndroid: the app runs as x86_64 (an x86_64 device or emulator); iOS never reports itThat this device is not supported
internalAn unexpected failure in the SDKA generic error; send the message and the time to support

message is a short technical text for your logs, in English. Do not show it to the user as is.

Forward compatibility

A newer SDK may add a verdict or a failure reason:

  • Flutter and React Native read an unknown verdict as unknown and an unknown failure reason as internal.
  • In Swift, a switch over the SDK's enums needs @unknown default.