Сессия завершается ровно одним результатом. Любой исход — вердикт, отмена, отказ в доступе к камере, отсутствие сети — это результат, а не исключение. Плагины Flutter и React Native бросают исключение только при неправильном использовании: второй start, пока идёт сессия, или пустой запрос.
| Результат | Android | iOS | Flutter | React Native |
|---|---|---|---|---|
| Сервер вынес вердикт по сессии | KycResult.Completed(verdict) | .completed(verdict) | KycCompleted(verdict) | { kind: 'completed', verdict } |
| Пользователь ушёл до конца сессии | KycResult.Cancelled | .cancelled | KycCancelled() | { kind: 'cancelled' } |
| Сессию не удалось продолжить | KycResult.Failed(reason, message) | .failed(reason, message:) | KycFailed(reason, message) | { kind: 'failed', reason, message } |
Сессия, по которой сервер уже вынес вердикт, завершается как completed с этим вердиктом, на каком бы экране пользователь её ни закрыл.
Вердикты
| Вердикт | Значение |
|---|---|
success | Проверка пройдена |
failed | Проверка не пройдена |
suspicious | Сервер подозревает мошенничество; пользователю SDK показывает это как непройденную проверку |
expired | Время сессии истекло |
unknown | Вердикт, который эта версия SDK не знает |
Вердикт в приложении нужен для следующего экрана. Важное решение (открытие счёта, лимит платежей) должно опираться на результат сессии, который ваш сервер получает от «Нейровижн» по вебхуку или запросом статуса сессии, а не на то, что сообщает приложение.
Ошибки
| Причина | Когда | Что показать пользователю |
|---|---|---|
cameraDenied | Пользователь не дал доступ к камере | Что камера нужна, и переход в настройки приложения |
network | Нет соединения, или оно оборвалось и повторные попытки исчерпаны | Проверить соединение и попробовать снова |
server | Сервер ответил ошибкой | Попробовать позже |
camera | Камеру не удалось открыть, или она перестала отдавать кадры (её заняло другое приложение) | Закрыть другие приложения, использующие камеру, и попробовать снова |
config | Запрос отклонён: неверный apiHost, id сценария или ключ клиента, которые сервер не принял, или уже идёт другая сессия (что именно — сказано в сообщении) | Общую ошибку; запишите сообщение в лог — это проблема интеграции, а не пользователя |
unsupportedDevice | Android: приложение работает как x86_64 (устройство или эмулятор x86_64); на iOS не возникает | Что это устройство не поддерживается |
internal | Непредвиденный сбой в SDK | Общую ошибку; пришлите в поддержку сообщение и время |
message — короткий технический текст для ваших логов, на английском. Не показывайте его пользователю как есть.
Совместимость с новыми версиями
Более новый SDK может добавить вердикт или причину ошибки:
- Flutter и React Native читают неизвестный вердикт как
unknown, а неизвестную причину ошибки — какinternal. - В Swift в
switchпо перечислениям SDK нужен@unknown default.