> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Flutter KYC SDK: мобильная верификация в Dart > Didit: Flutter KYC SDK с нативными iOS и Android, проверкой живости и NFC-паспортов. От $0.33 за полную KYC-проверку, $10 бесплатно в месяц. Промпт для интеграции Flutter SDK Скопировать промпт в буфер обмена \

\`Integrate Didit identity verification into my Flutter app using the native SDK.

\## Requirements
\- Flutter 3.3+, Dart 3.11+
\- iOS 13.0+ (NFC requires iOS 15+)
\- Android API 23+ (Android 6.0)

\## Installation
flutter pub add didit_sdk

iOS — the plugin picks the native variant from the $DiditSdkIosVariant Ruby global in ios/Podfile (or the DIDIT_SDK_IOS_VARIANT env var); valid values are 'all' (default), 'core', 'autodetection', 'nfc'. At the top of ios/Podfile:
$DiditSdkIosVariant = 'all'
platform :ios, ['all', 'nfc'].include?($DiditSdkIosVariant) ? '15.0' : '13.0'
Inside the target block, add the matching subspec:
pod 'DiditSDK/All', :podspec => 'https://raw.githubusercontent.com/didit-protocol/sdk-ios/4.13.2/DiditSDK.podspec'
The tag in that URL must equal the native iOS SDK version the didit_sdk release pins (4.13.2 pins 4.13.2); do not use 'main', because the plugin requires that exact version and pod install fails when the URL resolves to a different one.
'all' and 'nfc' require platform :ios, '15.0'; 'core' and 'autodetection' run on iOS 13.0+.
Then: cd ios && pod install
Info.plist must include NSCameraUsageDescription, NSMicrophoneUsageDescription, NSPhotoLibraryUsageDescription (required) and NFCReaderUsageDescription if using NFC.

Android — for no-NFC builds add to android/gradle.properties:
diditSdkAndroidNfcEnabled=false
For NFC-enabled (default), add to android/app/build.gradle.kts inside android block:
packaging {
  resources {
      pickFirsts += "META-INF/versions/9/OSGI-INF/MANIFEST.MF"
  }
}

\## Backend: Create Session (your server)
POST https://verification.didit.me/v3/session/
Headers: { "x-api-key": DIDIT_API_KEY, "Content-Type": "application/json" }
Body: { "workflow_id": DIDIT_WORKFLOW_ID, "vendor_data": "user-id" }
Response: { "session_id": "uuid", "session_token": "short-token", "url": "https://verify.didit.me/session/short-token", "status": "Not Started" }
Send session_token to the Flutter app (never expose DIDIT_API_KEY to the device).

\## Integration
import 'package:didit_sdk/sdk_flutter.dart';

// Option A: With session token from your backend (recommended)
final result = await DiditSdk.startVerification('session-token-from-backend');

// Option B: With workflow ID (SDK creates session internally)
final result = await DiditSdk.startVerificationWithWorkflow('your-workflow-id',
vendorData: 'user-123',
);

// Handle result
switch (result) {
case VerificationCompleted(:final session):
if (session.status == VerificationStatus.approved) { /* grant access */ }
case VerificationCancelled():
// User dismissed the verification flow
case VerificationFailed(:final error):
// SDK error — show error.message
}

\## Result Statuses (VerificationStatus enum)
\- VerificationStatus.approved — user identity verified, grant access
\- VerificationStatus.declined — verification failed, show retry or contact support
\- VerificationStatus.pending  — needs manual review by your compliance team

\## Error Types (VerificationErrorType enum)
sessionExpired, networkError, cameraAccessDenied, notInitialized, apiError, retryBlocked, unknown

\## Advanced Session Parameters
contact_details, expected_details, and metadata are only available via the Session Token method (your backend creates the session). The Dart startVerificationWithWorkflow API only accepts workflowId, vendorData, and config.

\## Full Verification Results
The SDK only returns the status. Full decision data (document fields, face match scores, AML hits, etc.) arrives via webhook to your backend.
Set up webhooks: https://docs.didit.me/integration/webhooks

\## Rate Limits (session creation)
\- 600 session-create requests / minute per x-api-key (see https://docs.didit.me/integration/rate-limiting)
\- On 429, retry honouring Retry-After / X-RateLimit-* headers

\## Environment Variables (backend only — never expose in the app)
\- DIDIT_API_KEY — from Didit Console > API & Webhooks
\- DIDIT_WORKFLOW_ID — from Didit Console > Workflows

\## Docs
\- Flutter SDK: https://docs.didit.me/integration/native-sdks/flutter-sdk
\- GitHub: https://github.com/didit-protocol/sdk-flutter
\- pub.dev: https://pub.dev/packages/didit_sdk
\- Webhooks: https://docs.didit.me/integration/webhooks
\- API Reference: https://docs.didit.me/api-reference/overview`

\
Вставьте в Кроссплатформенный плагин Flutter, который оборачивает нативные SDK для iOS и Android и предоставляет единый Dart API для верификации личности.> [card] [Репозиторий на GitHub](https://github.com/didit-protocol/sdk-flutter) > > Исходный код и примеры на GitHub> [card] [Пакет на pub.dev](https://pub.dev/packages/didit_sdk) > > didit\_sdk> [!NOTE] > > ### **Нативный SDK**: Это рекомендуемый подход для приложений на Flutter. SDK оборачивает нативные SDK для iOS и Android через платформенные каналы, что обеспечивает лучший пользовательский опыт, оптимизированную работу с камерой и полную поддержку NFC.***## Требования| Требование | Минимальная версия | | - | - | | Flutter | 3.3+ | | Dart | 3.11+ |### Требования к платформам| Платформа | Минимальная версия | Примечания | | - | - | - | | iOS | 13.0+ | Считывание NFC-паспортов требует iOS 15.0+ | | Android | API 23+ (6.0) | Java 17+ |> [!NOTE] > > **Биометрическое согласие требует нативный SDK версии 4.10.0 или новее.** Для пользователей, на которых распространяется законодательство Иллинойса, Техаса или Колорадо, Didit может запросить явное [биометрическое согласие](https://docs.didit.me/ru/getting-started/biometric-consent.md) перед первым захватом лица. Релиз Flutter SDK, который закрепляет нативные SDK для iOS и Android версии 4.10.0 или новее, отображает этот шаг. Более ранние версии не могут его показать: их сессии работают как прежде, а решение сообщает, что согласие не было собрано (`biometric_consent.reason: "BIOMETRIC_CONSENT_UNSUPPORTED_SDK"`). Если вы верифицируете пользователей в этих штатах, обновите SDK.***## Installation```bash theme={null} flutter pub add didit_sdk ```Или добавьте его вручную в `pubspec.yaml`:```yaml theme={null} dependencies: didit_sdk: ^4.13.2 ```Затем выполните:```bash theme={null} flutter pub get ```### Варианты нативного SDK`didit_sdk` включает полный нативный SDK. Чтобы собрать более компактный бинарный файл, подключите вместо него пакет-вариант: он предоставляет точно такой же Dart API и фиксирует соответствующий нативный SDK на обеих платформах:| Пакет | Автоматическая съёмка | Считывание паспорта через NFC | Минимальная версия iOS | | - | - | - | - | | `didit_sdk` (по умолчанию) | Да | Да | 15.0 | | `didit_sdk_core` | Нет | Нет | 13.0 | | `didit_sdk_autodetection` | Да | Нет | 13.0 | | `didit_sdk_nfc` | Нет | Да | 15.0 |```yaml theme={null} dependencies: didit_sdk_core: ^4.13.2 ```Подключите ровно один из этих пакетов и импортируйте из выбранного, например `package:didit_sdk_core/sdk_flutter.dart`.### Настройка iOSПлагин поддерживает оба менеджера зависимостей iOS во Flutter: Swift Package Manager и CocoaPods.#### Swift Package ManagerЕсли в вашей версии Flutter включена поддержка Swift Package Manager (включается командой `flutter config --enable-swift-package-manager` в Flutter 3.24+), плагин подключается как Swift-пакет автоматически. Конфигурация Podfile не требуется: нативная зависимость DiditSDK разрешается из GitHub самостоятельно. Установите минимальную версию развёртывания iOS для вашего приложения в Xcode (цель Runner и проект) в соответствии с выбранным пакетом: 15.0 для `didit_sdk` и `didit_sdk_nfc`, 13.0 для `didit_sdk_core` и `didit_sdk_autodetection`.#### CocoaPodsДля `didit_sdk` плагин выбирает вариант нативного SDK для iOS из `$DiditSdkIosVariant`, глобальной переменной Ruby, которую вы задаёте в `ios/Podfile` вашего приложения (пода DiditSDK не опубликована в CocoaPods trunk):```ruby theme={null} # Pick one: 'all', 'core', 'autodetection', 'nfc' $DiditSdkIosVariant = 'all' didit_sdk_ios_deployment_target = ['all', 'nfc'].include?($DiditSdkIosVariant) ? '15.0' : '13.0' platform :ios, didit_sdk_ios_deployment_target didit_sdk_ios_pod = case $DiditSdkIosVariant when 'all' then 'DiditSDK/All' when 'core' then 'DiditSDK/Core' when 'autodetection' then 'DiditSDK/AutoDetection' when 'nfc' then 'DiditSDK/NFC' end didit_sdk_ios_podspec = 'https://raw.githubusercontent.com/didit-protocol/sdk-ios/4.13.2/DiditSDK.podspec' target 'Runner' do use_frameworks! pod didit_sdk_ios_pod, :podspec => didit_sdk_ios_podspec flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__)) end post_install do |installer| installer.pods_project.targets.each do |target| flutter_additional_ios_build_settings(target) target.build_configurations.each do |config| config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = didit_sdk_ios_deployment_target end end end ```Если вы используете пакет-вариант (`didit_sdk_core`, `didit_sdk_autodetection`, `didit_sdk_nfc`), он фиксирует свой нативный subspec напрямую и игнорирует `$DiditSdkIosVariant`. Строка `pod` в вашем Podfile и минимальная версия развёртывания должны соответствовать этому варианту (например, `pod 'DiditSDK/Core', :podspec => ...` с `platform :ios, '13.0'`).> [!NOTE] > > Варианты `all` и `nfc` требуют минимальную версию развёртывания iOS 15.0+; `core` и `autodetection` могут использовать iOS 13.0. При переключении вариантов сначала очистите CocoaPods (`rm -rf Pods Podfile.lock`), чтобы не использовался ранее собранный вариант SDK.> [!WARNING] > > Тег в URL podspec должен совпадать с версией нативного SDK для iOS, которую фиксирует ваш релиз `didit_sdk` > (`4.13.2` фиксирует нативный `4.13.2`). Если URL указывает на более старый тег, `pod install` завершится ошибкой разрешения зависимостей: > CocoaPods найдёт podspec, объявляющий более старую версию, тогда как плагин требует точного совпадения. > При обновлении `didit_sdk` измените тег в этом URL на ту же версию.### Настройка AndroidПо умолчанию плагин подключает полный нативный SDK для Android, включая NFC. Чтобы собрать приложение без NFC, добавьте в `android/gradle.properties` следующую строку:```properties theme={null} diditSdkAndroidNfcEnabled=false ```Это переключает зависимость с `me.didit:didit-sdk` на `me.didit:didit-sdk-core`, убирая модуль считывания NFC и его зависимости JMRTD/SCUBA/BouncyCastle.Если NFC включён (по умолчанию), добавьте в `android/app/build.gradle.kts` следующее правило упаковки, чтобы устранить дублирующийся файл метаданных из BouncyCastle:```kotlin theme={null} android { packaging { resources { pickFirsts += "META-INF/versions/9/OSGI-INF/MANIFEST.MF" } } } ```Без этого правила сборка завершается ошибкой `mergeDebugJavaResource`. Правило не нужно, если задано `diditSdkAndroidNfcEnabled=false`.> [!NOTE] > > Нативный SDK для Android загружается из удалённого Maven-репозитория на GitHub (начиная с плагина 3.4.0), поэтому дополнительная настройка Maven в вашем приложении не требуется.***## Разрешения### iOSДобавьте следующие ключи в `Info.plist` вашего приложения:| Разрешение | Ключ Info.plist | Описание | Обязательно | | - | - | - | - | | Камера | `NSCameraUsageDescription` | Сканирование документов и проверка лица | Да | | Микрофон | `NSMicrophoneUsageDescription` | Запись видео для проверки живости | Да | | Фотобиблиотека | `NSPhotoLibraryUsageDescription` | Загрузка документов из галереи устройства | Да | | NFC | `NFCReaderUsageDescription` | Чтение NFC-чипов в паспортах и ID-картах | Если используется NFC | | Геолокация | `NSLocationWhenInUseUsageDescription` | Геолокация для предотвращения мошенничества | Необязательно |> [!WARNING] > > Если отсутствует какой-либо обязательный ключ конфиденциальности iOS, iOS завершит работу приложения, как только SDK попытается обратиться к защищённому ресурсу. Например, при отсутствии `NSCameraUsageDescription` приложение аварийно завершится, когда пользователь нажмёт кнопку съёмки в камере документов.#### Настройка NFCЧтобы включить чтение NFC для паспортов и ID-карт с чипами:1) **Добавьте возможность NFC** в Xcode: * Выберите ваш target > **Signing & Capabilities** > **+ Capability** > **Near Field Communication Tag Reading** 2) **Добавьте идентификаторы ISO7816** в `Info.plist`:```xml theme={null} com.apple.developer.nfc.readersession.iso7816.select-identifiers D23300000045737445494420763335 A0000002471001 A0000002472001 00000000000000 D392F000260100000001 ````D392F000260100000001` позволяет SDK читать карту My Number Card (Япония) через [JPKI](https://docs.didit.me/ru/core-technology/nfc-verification/overview.md#карта-my-number-в-японии-jpki): без него iOS не передаёт карту в SDK. Чтение My Number Card пока не включено в продакшне, а этот идентификатор не влияет на другие документы, поэтому его можно добавить уже сейчас.3) **Добавьте файл entitlements** с включённым чтением NFC-тегов:```xml theme={null} com.apple.developer.nfc.readersession.formats TAG ```Убедитесь, что профиль подготовки приложения включает возможность NFC Tag Reading. Если bundle ID не настроен для NFC в вашем аккаунте Apple Developer, Xcode завершится ошибкой подписи из-за отсутствующего права `com.apple.developer.nfc.readersession.formats`.Эта настройка NFC не нужна для вариантов `core` и `autodetection` (`$DiditSdkIosVariant`), а также для пакетов `didit_sdk_core` и `didit_sdk_autodetection`: ни один из них не читает чипы.### AndroidСледующие разрешения объявлены в `AndroidManifest.xml` SDK и объединяются автоматически:| Разрешение | Описание | Обязательно | | - | - | - | | `INTERNET` | Доступ к сети для обмена данными с API | Да | | `ACCESS_NETWORK_STATE` | Определение доступности сети | Да | | `CAMERA` | Сканирование документов и проверка лица | Да | | `NFC` | Чтение NFC-чипов в паспортах и ID-картах | Если используется NFC |Функции камеры и NFC объявлены как необязательные (`android:required="false"`), поэтому приложение можно установить на устройства без этих функций. Если `diditSdkAndroidNfcEnabled=false`, SDK не добавляет разрешение и функцию NFC для Android.#### Разрешения во время выполненияSDK автоматически обрабатывает запросы разрешений Android во время выполнения. Когда пользователь доходит до шага, которому нужен доступ к камере:1) SDK запрашивает разрешение на камеру, если оно ещё не предоставлено 2) Если пользователь **отклоняет** разрешение, отображается сообщение об ошибке с кнопкой **Try Again** 3) Если пользователь **предоставляет** разрешение, процесс верификации продолжаетсяЗапрашивать разрешение на камеру в коде приложения перед вызовом `startVerification()` не нужно: SDK управляет этим самостоятельно.***## Быстрый старт```dart theme={null} import 'package:didit_sdk/sdk_flutter.dart'; // Start verification with a session token from your backend final result = await DiditSdk.startVerification('your-session-token'); switch (result) { case VerificationCompleted(:final session): if (session.status == VerificationStatus.approved) { print('Identity verified!'); } case VerificationCancelled(): print('User cancelled'); case VerificationFailed(:final error): print('Error: ${error.message}'); } ```***## Способы интеграцииSDK поддерживает два способа интеграции:### Способ 1: токен сессии (рекомендуется для продакшна)Создайте сессию на вашем бэкенде с помощью [API создания сессии верификации](https://docs.didit.me/ru/sessions-api/create-session.md), затем передайте токен в SDK:```dart theme={null} import 'package:didit_sdk/sdk_flutter.dart'; // Your backend creates a session and returns the token final sessionToken = await yourBackend.createVerificationSession(userId); // Pass the token to the SDK final result = await DiditSdk.startVerification(sessionToken); ```Этот подход даёт вам полный контроль над:- Связыванием сессий с вашими пользователями (`vendor_data`) - Настройкой пользовательских метаданных - Настройкой обратных вызовов для каждой сессии### Способ 2: ID сценария (более простая интеграция)Для более простых интеграций SDK может создавать сессии напрямую по ID вашего сценария, без бэкенда:```dart theme={null} import 'package:didit_sdk/sdk_flutter.dart'; final result = await DiditSdk.startVerificationWithWorkflow( 'your-workflow-id', vendorData: 'user-123', config: const DiditConfig(loggingEnabled: true), ); ```> [!NOTE] > > Расширенные параметры сессии (`contact_details`, `expected_details`, `metadata`) поддерживаются **только** при использовании способа с токеном сессии, когда ваш бэкенд вызывает [API создания сессии](https://docs.didit.me/ru/sessions-api/create-session.md) с полной поддержкой параметров. Передайте полученный `session_token` в `DiditSdk.startVerification()`.***## КонфигурацияНастройте поведение SDK, передав объект `DiditConfig`:```dart theme={null} final result = await DiditSdk.startVerification( 'your-session-token', config: const DiditConfig( languageCode: 'es', // Force Spanish language showLanguageSelector: true, // Let the user change language fontFamily: 'Avenir', // Custom font loggingEnabled: true, // Enable debug logging ), ); ```Для `startVerificationWithWorkflow` передайте `config` как именованный параметр:```dart theme={null} final result = await DiditSdk.startVerificationWithWorkflow( 'your-workflow-id', vendorData: 'user-123', config: const DiditConfig( languageCode: 'es', showLanguageSelector: true, loggingEnabled: true, ), ); ```### Параметры конфигурации| Свойство | Тип | По умолчанию | Описание | | - | - | - | - | | `languageCode` | `String?` | Локаль устройства | Код языка ISO 639-1 (например, `"en"`, `"fr"`, `"ar"`) | | `showLanguageSelector` | `bool` | `false` | Показывать на приветственном экране выбор языка в веб-стиле | | `fontFamily` | `String?` | Системный шрифт | Имя семейства пользовательского шрифта (должен быть зарегистрирован на нативной стороне) | | `loggingEnabled` | `bool` | `false` | Включить отладочное логирование SDK | | `showCloseButton` | `bool` | `true` | Показывать кнопку закрытия (X) на экранах шагов верификации | | `showExitConfirmation` | `bool` | `true` | Показывать диалог подтверждения, когда пользователь пытается выйти | | `closeOnComplete` | `bool` | `false` | Автоматически закрывать интерфейс верификации по завершении | | `defaultDocumentCamera` | `CameraLens?` | Нативное значение по умолчанию (`CameraLens.back`) | Объектив, который используется при открытии экрана съемки документа | | `defaultLivenessCamera` | `CameraLens?` | Нативное значение по умолчанию (`CameraLens.front`) | Объектив, который используется при открытии экрана съемки лица (проверка живости) | | `showDocumentCameraSwitchButton` | `bool` | `true` | Показывать переключатель камеры во время съемки на экране съемки документа | | `showLivenessCameraSwitchButton` | `bool` | `true` | Показывать переключатель камеры во время съемки на экране съемки лица |### Параметры камерыПараметры камеры совпадают с [параметрами камеры Web SDK](https://docs.didit.me/ru/integration/web-sdks/javascript-sdk.md#параметры-камеры). Каждый объектив задается значением `CameraLens.front` или `CameraLens.back`. Если на устройстве нет запрошенного объектива, SDK использует первую доступную камеру. Переключатель камеры также скрывается на устройствах, где есть только одна камера. Установите для переключателя значение `false`, чтобы зафиксировать пользователя на объективе по умолчанию для этого шага.```dart theme={null} config: const DiditConfig( defaultLivenessCamera: CameraLens.back, showLivenessCameraSwitchButton: false, ), ```> [!NOTE] > > **Темы и цвета**: цвета, фоны и настройки вступительных экранов задаются через ваши [настройки White label](https://business.didit.me) в Didit Console, а не в конфигурации SDK. Так обеспечивается единый брендинг на всех платформах.***## Поддержка языковSDK поддерживает **54 языка**. Если язык не указан, SDK использует локаль устройства, а в качестве запасного варианта английский.```dart theme={null} // Use device locale (default) await DiditSdk.startVerification(token); // Force specific language await DiditSdk.startVerification(token, config: const DiditConfig(languageCode: 'fr'), ); // Let the user change language on the welcome screen await DiditSdk.startVerification(token, config: const DiditConfig(showLanguageSelector: true), ); ```**[Посмотреть все поддерживаемые языки →](https://docs.didit.me/ru/integration/supported-languages.md)*****## Расширенные параметры сессииТакие параметры, как `contact_details`, `expected_details` и `metadata`, **поддерживаются только** через метод Session Token. Ваш бэкенд вызывает [`POST /v3/session/`](https://docs.didit.me/ru/sessions-api/create-session) с полной поддержкой параметров, а затем передает возвращенный `session_token` в SDK.```dart theme={null} // Your backend handles the full session creation: // POST /v3/session/ with contact_details, expected_details, metadata, etc. final sessionToken = await yourBackend.createSession(userId); // The SDK only needs the token final result = await DiditSdk.startVerification(sessionToken); ```> [!NOTE] > > Метод Dart `startVerificationWithWorkflow` принимает только `workflowId`, `vendorData` и `config`. Версии до 3.4.0 поддерживали параметры `contactDetails`, `expectedDetails` и `metadata`, но они были удалены, потому что эндпоинт Unilink их не учитывает.***## Обработка результатовОба метода, `startVerification` и `startVerificationWithWorkflow`, возвращают `Future`. Результат представлен sealed-классом: используйте сопоставление с образцом (pattern matching), чтобы определить исход.### Типы результатов| Тип | Описание | | - | - | | `VerificationCompleted` | Поток верификации завершен (результат смотрите в `session.status`) | | `VerificationCancelled` | Пользователь отменил поток верификации | | `VerificationFailed` | Во время верификации произошла ошибка |### Свойства SessionData| Свойство | Тип | Описание | | - | - | - | | `sessionId` | `String` | Уникальный идентификатор сессии | | `status` | `VerificationStatus` | `approved`, `pending` или `declined` |### Типы ошибокПеречисление `VerificationErrorType` содержит следующие значения:| Ошибка | Описание | | - | - | | `sessionExpired` | Срок действия сессии истек | | `networkError` | Проблема с сетевым подключением | | `cameraAccessDenied` | Разрешение на доступ к камере не предоставлено | | `notInitialized` | SDK не инициализирован (только Android) | | `apiError` | Запрос к API завершился ошибкой | | `retryBlocked` | Превышено максимальное количество повторных попыток для текущего шага | | `unknown` | Другая ошибка: подробности смотрите в `error.message` |### Потеря соединенияЕсли во время верификации устройство теряет соединение, SDK перекрывает поток экраном «Нет подключения к интернету» вместо того, чтобы оставлять шаг в состоянии загрузки. SDK продолжает проверять соединение в фоновом режиме и сам закрывает экран, как только Didit снова становится доступен. Пользователь продолжает с того шага, на котором остановился. На экране есть кнопки **Повторить** и, если кнопка закрытия не отключена, **Выйти из верификации**. Выход завершает верификацию результатом `VerificationFailed` с типом ошибки `networkError`, поэтому ваше приложение узнает, что пользователь ушел из-за потери соединения.### Полный пример обработки результатов```dart theme={null} import 'package:didit_sdk/sdk_flutter.dart'; Future verify(String token) async { final result = await DiditSdk.startVerification(token); switch (result) { case VerificationCompleted(:final session): switch (session.status) { case VerificationStatus.approved: print('Approved! Session: ${session.sessionId}'); // User is verified — grant access case VerificationStatus.pending: print('Under review. Session: ${session.sessionId}'); // Show "verification in progress" UI case VerificationStatus.declined: print('Declined. Session: ${session.sessionId}'); // Handle declined verification } case VerificationCancelled(:final session): print('User cancelled.'); if (session != null) { print('Session: ${session.sessionId}'); } // Maybe show retry option case VerificationFailed(:final error): print('Error [${error.type}]: ${error.message}'); // Handle error — show retry or contact support } } ```***## Пример сквозной интеграции (сессия на бэкенде → Flutter SDK → Webhook)Готовая к продакшену интеграция: ваш бэкенд создает сессию, ваше Flutter-приложение получает `session_token`, а SDK запускает поток. Итоговое решение доставляется на ваш бэкенд через webhook. Никогда не полагайтесь только на результат на стороне клиента.### 1. Бэкенд: создание сессии```ts theme={null} // Node.js / Express example. Run on your server. NEVER ship DIDIT_API_KEY to the device. import express from "express"; const app = express(); app.use(express.json()); app.post("/api/verification/start", async (req, res) => { const response = await fetch("https://verification.didit.me/v3/session/", { method: "POST", headers: { "x-api-key": process.env.DIDIT_API_KEY!, "Content-Type": "application/json", }, body: JSON.stringify({ workflow_id: process.env.DIDIT_WORKFLOW_ID, vendor_data: req.body.userId, // your stable user id }), }); if (!response.ok) { return res.status(500).json({ error: `Didit ${response.status}` }); } const { session_id, session_token } = await response.json(); // Persist session_id <-> userId so you can match the webhook later. res.json({ session_id, session_token }); }); ```### 2. Flutter: обмен токеном и запуск SDK```dart theme={null} import 'dart:convert'; import 'package:flutter/material.dart'; import 'package:http/http.dart' as http; import 'package:didit_sdk/sdk_flutter.dart'; class VerifyButton extends StatefulWidget { const VerifyButton({super.key, required this.userId}); final String userId; @override State createState() => _VerifyButtonState(); } class _VerifyButtonState extends State { bool _loading = false; Future _verify() async { setState(() => _loading = true); try { final resp = await http.post( Uri.parse('https://your-backend.example.com/api/verification/start'), headers: const {'Content-Type': 'application/json'}, body: jsonEncode({'userId': widget.userId}), ); final sessionToken = (jsonDecode(resp.body) as Map)['session_token'] as String; final result = await DiditSdk.startVerification(sessionToken); switch (result) { case VerificationCompleted(:final session): if (session.status == VerificationStatus.approved) { // Optimistic UI; rely on the webhook delivered to your backend as the source of truth. } case VerificationCancelled(): // User dismissed the flow break; case VerificationFailed(:final error): // Show retry — error.type / error.message break; } } finally { if (mounted) setState(() => _loading = false); } } @override Widget build(BuildContext context) { return ElevatedButton( onPressed: _loading ? null : _verify, child: Text(_loading ? 'Starting...' : 'Verify identity'), ); } } ```### 3. Бэкенд: получение итогового решения через webhook```ts theme={null} app.post("/api/webhooks/didit", express.raw({ type: "application/json" }), (req, res) => { // 1. Verify the X-Signature header (see Webhooks docs) // 2. Parse the body const event = JSON.parse(req.body.toString()); if (event.webhook_type === "status.updated") { // event.session_id, event.status ("Approved" | "Declined" | "In Review" | ...) // Look up the user by session_id and update their verification state. } res.sendStatus(200); }); ```Подробности проверки подписи HMAC см. в [руководстве по Webhooks](https://docs.didit.me/ru/integration/webhooks.md).***## Полный пример```dart theme={null} import 'package:flutter/material.dart'; import 'package:didit_sdk/sdk_flutter.dart'; void main() { runApp(const MyApp()); } class MyApp extends StatelessWidget { const MyApp({super.key}); @override Widget build(BuildContext context) { return MaterialApp( title: 'Didit SDK Example', theme: ThemeData( colorScheme: ColorScheme.fromSeed(seedColor: const Color(0xFF1A1A1A)), useMaterial3: true, ), home: const VerificationScreen(), ); } } class VerificationScreen extends StatefulWidget { const VerificationScreen({super.key}); @override State createState() => _VerificationScreenState(); } class _VerificationScreenState extends State { final _tokenController = TextEditingController(); bool _loading = false; @override void dispose() { _tokenController.dispose(); super.dispose(); } Future _startVerification() async { final token = _tokenController.text.trim(); if (token.isEmpty) { _showAlert('Error', 'Please enter a session token.'); return; } setState(() => _loading = true); try { final result = await DiditSdk.startVerification( token, config: const DiditConfig(loggingEnabled: true), ); switch (result) { case VerificationCompleted(:final session): _showAlert( 'Verification Complete', 'Status: ${session.status.name}\nSession: ${session.sessionId}', ); case VerificationCancelled(): _showAlert('Cancelled', 'The user cancelled the verification.'); case VerificationFailed(:final error): _showAlert('Failed', '${error.type.name}: ${error.message}'); } } catch (e) { _showAlert('Error', 'Unexpected error: $e'); } finally { setState(() => _loading = false); } } void _showAlert(String title, String message) { showDialog( context: context, builder: (ctx) => AlertDialog( title: Text(title), content: Text(message), actions: [ TextButton( onPressed: () => Navigator.pop(ctx), child: const Text('OK'), ), ], ), ); } @override Widget build(BuildContext context) { return Scaffold( body: SafeArea( child: Padding( padding: const EdgeInsets.all(24), child: Column( mainAxisAlignment: MainAxisAlignment.center, crossAxisAlignment: CrossAxisAlignment.stretch, children: [ TextField( controller: _tokenController, decoration: InputDecoration( hintText: 'Enter session token...', border: OutlineInputBorder( borderRadius: BorderRadius.circular(8), ), ), autocorrect: false, ), const SizedBox(height: 16), ElevatedButton( onPressed: _loading ? null : _startVerification, style: ElevatedButton.styleFrom( backgroundColor: const Color(0xFF1A1A1A), foregroundColor: Colors.white, padding: const EdgeInsets.symmetric(vertical: 16), shape: RoundedRectangleBorder( borderRadius: BorderRadius.circular(8), ), ), child: _loading ? const SizedBox( height: 20, width: 20, child: CircularProgressIndicator( strokeWidth: 2, color: Colors.white, ), ) : const Text( 'Start Verification', style: TextStyle(fontWeight: FontWeight.w600), ), ), ], ), ), ), ); } } ```*** This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.