> ## 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.

# KYC SDK для React Native: мобильная верификация

> KYC SDK от Didit для React Native и Expo: TypeScript, iOS, Android, NFC-паспорта. От $0.33 за KYC-проверку, $10 бесплатно в месяц, без контрактов.



Промпт для интеграции React Native SDK
        Скопировать промпт в буфер обмена



      
      

\<pre>

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

\## Requirements
\- React Native 0.76+ (New Architecture / TurboModules)
\- Node.js 20+, TypeScript 5+
\- iOS 13.0+ (NFC requires iOS 15+)
\- Android API 24+ (Android 7.0), Kotlin 1.9+, Java 17+
\- New Architecture (TurboModules) only - package is published as @didit-protocol/sdk-react-native v4.x (latest 4.13.2)

\## Installation

\### Expo (recommended)
npx expo install @didit-protocol/sdk-react-native

Add to app.json (NFC is enabled by default):
\{
"expo": {
"plugins": ["@didit-protocol/sdk-react-native"]
}
}

To opt out of NFC dependencies:
\{
"expo": {
"plugins": [["@didit-protocol/sdk-react-native", { "iosNfcEnabled": false, "androidNfcEnabled": false }]]
}
}

The config plugin automatically adds the Didit Maven repo (Android), the DiditSDK podspec (iOS),
and BouncyCastle packaging rules for Android. This SDK requires a development build — it does not work in Expo Go.
The plugin does not edit Info.plist: add the iOS permission keys and, for NFC, the ISO7816 select identifiers
(including D392F000260100000001 for the Japan My Number Card) under expo.ios.infoPlist in app.json.

\### React Native CLI
npm install @didit-protocol/sdk-react-native

iOS — add this block to ios/Podfile inside the app target (NFC-aware; pins to iOS 15 when NFC is on):
didit_sdk_ios_nfc_enabled = ENV.fetch('DIDIT_SDK_IOS_NFC_ENABLED', 'true').downcase != 'false'
didit_sdk_ios_pod = didit_sdk_ios_nfc_enabled ? 'DiditSDK' : 'DiditSDK/Core'
pod didit_sdk_ios_pod, :podspec => 'https://raw.githubusercontent.com/didit-protocol/sdk-ios/4.13.2/DiditSDK.podspec'
The tag in that URL must equal diditNativeSdkVersions.ios in the package (4.13.2); do not use 'main', because the package requires that exact version and every pod install fails when the URL resolves to a different one.
Then: cd ios && bundle exec pod install

Android — add to settings.gradle (dependencyResolutionManagement.repositories):
maven { url "https://raw.githubusercontent.com/didit-protocol/sdk-android/main/repository" }
To disable NFC, add diditSdkAndroidNfcEnabled=false to android/gradle.properties.

\## 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 React Native app (never expose DIDIT_API_KEY to the device).

\## Integration
import { startVerification, VerificationStatus } from '@didit-protocol/sdk-react-native';

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

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

// Handle result
switch (result.type) {
case 'completed':
if (result.session.status === VerificationStatus.Approved) { /* grant access */ }
break;
case 'cancelled':
// User dismissed the verification flow
break;
case 'failed':
// SDK error — show result.error.message
break;
}

\## 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

\## 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
\- React Native SDK: https://docs.didit.me/integration/native-sdks/react-native-sdk
\- GitHub: https://github.com/didit-protocol/sdk-react-native
\- npm: https://www.npmjs.com/package/@didit-protocol/sdk-react-native
\- Webhooks: https://docs.didit.me/integration/webhooks
\- API Reference: https://docs.didit.me/api-reference/overview`

\</pre>



      
      

Вставьте в

Кроссплатформенный React Native SDK, который оборачивает нативные SDK для iOS и Android и предоставляет единый TypeScript API для верификации личности.> [card] [Репозиторий на GitHub](https://github.com/didit-protocol/sdk-react-native)
>
> Смотрите исходный код и примеры на GitHub> [card] [npm-пакет](https://www.npmjs.com/package/@didit-protocol/sdk-react-native)
>
> @didit-protocol/sdk-react-native> [!NOTE]
>
> ### **Нативный SDK**: Это рекомендуемый подход для приложений React Native и Expo. SDK оборачивает нативные SDK для iOS и Android, обеспечивая лучший пользовательский опыт, оптимизированную работу с камерой и полную поддержку NFC.***## Требования| Требование | Минимальная версия |
| - | - |
| React Native | 0.76+ (New Architecture / TurboModules) |
| Node.js | 20+ |
| TypeScript | 5+ |### Требования к платформам| Платформа | Минимальная версия | Примечания |
| - | - | - |
| iOS | 13.0+ | Для чтения NFC-паспортов требуется iOS 15.0+ |
| Android | API 24+ (7.0) | Kotlin 1.9+, Java 17+ |> [!NOTE]
>
> **Для биометрического согласия нужна нативная версия 4.10.0 или новее.** Для людей, на которых распространяется законодательство штатов Иллинойс, Техас или Колорадо, Didit может запросить явное [биометрическое согласие](https://docs.didit.me/ru/getting-started/biometric-consent.md) перед первым захватом лица. Релиз React Native SDK, который закрепляет нативные версии SDK для iOS и Android 4.10.0 или новее, показывает этот шаг. Более ранние версии не могут его показать: их сессии работают как прежде, а решение сообщает, что согласие не собрано (`biometric_consent.reason: "BIOMETRIC_CONSENT_UNSUPPORTED_SDK"`). Обновитесь, если вы верифицируете людей в этих штатах.***## Установка### Expo (Рекомендуется)```bash theme={null}
npx expo install @didit-protocol/sdk-react-native
```Затем добавьте конфигурационный плагин в `app.json` (или `app.config.js`). NFC включён по умолчанию:```json theme={null}
{
  "expo": {
    "plugins": ["@didit-protocol/sdk-react-native"]
  }
}
```Плагин автоматически настраивает обе платформы:- **Android:** добавляет Maven-репозиторий Didit в Gradle, задаёт свойство Gradle `diditSdkAndroidNfcEnabled` и применяет правила для зависимостей и упаковки BouncyCastle
- **iOS:** добавляет podspec DiditSDK в Podfile (с привязкой к iOS 15, если NFC включён)Плагин не редактирует `Info.plist`. Добавьте [ключи разрешений iOS](#ios) и, для NFC, идентификаторы выбора ISO7816 в `ios.infoPlist` того же файла. `D392F000260100000001` позволяет SDK считывать японскую карту My Number через [JPKI](https://docs.didit.me/ru/core-technology/nfc-verification/overview.md#карта-my-number-в-японии-jpki):```json theme={null}
{
  "expo": {
    "ios": {
      "infoPlist": {
        "NFCReaderUsageDescription": "NFC is used to read passport chip data for identity verification.",
        "com.apple.developer.nfc.readersession.iso7816.select-identifiers": [
          "D23300000045737445494420763335",
          "A0000002471001",
          "A0000002472001",
          "00000000000000",
          "D392F000260100000001"
        ]
      }
    }
  }
}
```#### Отключение NFC-зависимостейЧтобы собрать приложение без поддержки NFC (меньший размер бинарного файла, возможность NFC не требуется), передайте параметры плагина:```json theme={null}
{
  "expo": {
    "plugins": [
      [
        "@didit-protocol/sdk-react-native",
        { "iosNfcEnabled": false, "androidNfcEnabled": false }
      ]
    ]
  }
}
```Если NFC отключён, возможность NFC в iOS, права доступа для NFC и настройка профиля подготовки для NFC не требуются.> [!WARNING]
>
> Этот SDK использует нативные модули (камера, NFC), которые **недоступны в Expo Go**. Используйте [сборку для разработки](https://docs.expo.dev/develop/development-builds/introduction/) или выполните `npx expo prebuild`, чтобы сгенерировать нативные проекты.### React Native CLI```bash theme={null}
npm install @didit-protocol/sdk-react-native
# or
yarn add @didit-protocol/sdk-react-native
```#### Настройка iOSДобавьте pod DiditSDK в `Podfile` (он не опубликован в CocoaPods trunk). В блоке ниже учитывается переменная окружения `DIDIT_SDK_IOS_NFC_ENABLED`, с помощью которой можно переключить подспецификацию без NFC (`DiditSDK/Core`) на этапе установки:```ruby theme={null}
# In your ios/Podfile — at the top, before the target block:
didit_sdk_ios_nfc_enabled = ENV.fetch('DIDIT_SDK_IOS_NFC_ENABLED', 'true').downcase != 'false'

def max_ios_version(*versions)
  versions.map(&:to_s).max_by { |version| Gem::Version.new(version) }
end

platform :ios, didit_sdk_ios_nfc_enabled ? max_ios_version(min_ios_version_supported, '15.0') : min_ios_version_supported

# Inside your app target:
didit_sdk_ios_pod = didit_sdk_ios_nfc_enabled ? 'DiditSDK' : 'DiditSDK/Core'
pod didit_sdk_ios_pod, :podspec => 'https://raw.githubusercontent.com/didit-protocol/sdk-ios/4.13.2/DiditSDK.podspec'
```> [!WARNING]
>
> Тег в URL podspec должен совпадать с `diditNativeSdkVersions.ios` в установленной версии пакета.
> React Native `4.13.2` фиксирует нативные версии iOS `4.13.2` и Android `4.13.2`. Не указывайте в podspec
> ветку `main`: пакет зависит именно от этой версии нативного SDK для iOS, поэтому, как только `main` уйдёт вперёд, CocoaPods увидит два несовместимых требования к
> `DiditSDK`, и каждый `pod install` завершится ошибкой. Expo-плагин формирует этот URL автоматически; вручную его нужно прописывать только при использовании чистого React Native CLI.Затем установите зависимости:```bash theme={null}
cd ios
bundle exec pod install
```Чтобы пересобрать приложение без NFC-зависимостей, очистите CocoaPods и повторно запустите установку с заданной переменной окружения:```bash theme={null}
cd ios
rm -rf Pods Podfile.lock
DIDIT_SDK_IOS_NFC_ENABLED=false bundle exec pod install
```#### Настройка AndroidДобавьте Maven-репозиторий Didit в `settings.gradle` уровня проекта:```groovy theme={null}
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven { url "https://raw.githubusercontent.com/didit-protocol/sdk-android/main/repository" }
    }
}
```Добавьте следующее в `android/app/build.gradle` вашего приложения (внутрь блока `android { ... }`), чтобы устранить конфликты дублирующихся классов BouncyCastle и дубликат OSGI `MANIFEST.MF`, которые могут возникнуть из-за транзитивных зависимостей DiditSDK:```groovy theme={null}
android {
    configurations.configureEach {
        exclude group: 'org.bouncycastle', module: 'bcprov-jdk15to18'
        exclude group: 'org.bouncycastle', module: 'bcutil-jdk15to18'
        exclude group: 'org.bouncycastle', module: 'bcpkix-jdk15to18'
        exclude group: 'org.bouncycastle', module: 'bcprov-jdk15on'
    }
    packaging {
        resources {
            pickFirsts += ['org/bouncycastle/**']
            excludes += 'META-INF/versions/9/OSGI-INF/MANIFEST.MF'
        }
    }
}
```Чтобы собрать приложение без NFC-зависимостей Android (будет использоваться артефакт `me.didit:didit-sdk-core` вместо `me.didit:didit-sdk`), добавьте это в `android/gradle.properties`:```properties theme={null}
diditSdkAndroidNfcEnabled=false
```Удалите это свойство или задайте ему значение `true`, чтобы использовать полный Android SDK с NFC.***## Разрешения### iOSДобавьте следующие ключи в `Info.plist` вашего приложения. Если отсутствуют обязательные ключи конфиденциальности iOS, iOS завершит приложение сразу при обращении SDK к защищённому ресурсу.| Разрешение | Ключ Info.plist | Описание | Обязательно |
| - | - | - | - |
| Камера | `NSCameraUsageDescription` | Сканирование документов и верификация лица | Да |
| Микрофон | `NSMicrophoneUsageDescription` | Запись видео для проверки живости | Да |
| Медиатека | `NSPhotoLibraryUsageDescription` | Загрузка изображений документов | Да |
| Геолокация | `NSLocationWhenInUseUsageDescription` | Геолокация для предотвращения мошенничества | Да |
| NFC | `NFCReaderUsageDescription` | Считывание NFC-чипов в паспортах и ID-картах | Если используется NFC |```xml theme={null}
<key>NSCameraUsageDescription</key>
<string>Camera access is required to scan your identity documents for verification.</string>
<key>NSMicrophoneUsageDescription</key>
<string>Microphone access is required to record video for liveness verification.</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>Photo library access is required to upload document images.</string>
<key>NFCReaderUsageDescription</key>
<string>NFC is used to read passport chip data for identity verification.</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>Location access is used to detect your country for identity verification.</string>
```#### Настройка NFCЧтобы включить считывание NFC-чипов в паспортах и ID-картах:1) **Добавьте возможность чтения NFC-меток** в Xcode:
   * Выберите ваш target > **Signing & Capabilities** > **+ Capability** > **Near Field Communication Tag Reading**

2) **Добавьте идентификаторы ISO7816** в `Info.plist`:```xml theme={null}
<key>com.apple.developer.nfc.readersession.iso7816.select-identifiers</key>
<array>
    <string>D23300000045737445494420763335</string>
    <string>A0000002471001</string>
    <string>A0000002472001</string>
    <string>00000000000000</string>
    <string>D392F000260100000001</string>
</array>
````D392F000260100000001` позволяет SDK считывать японскую карту My Number через [JPKI](https://docs.didit.me/ru/core-technology/nfc-verification/overview.md#карта-my-number-в-японии-jpki): без него iOS не передаёт карту в SDK. Чтение карты My Number пока не включено в продакшне, а этот идентификатор не влияет на другие документы, поэтому его можно добавить уже сейчас.3) **Добавьте файл entitlements** с включённым чтением NFC-меток:```xml theme={null}
<key>com.apple.developer.nfc.readersession.formats</key>
<array>
    <string>TAG</string>
</array>
```Убедитесь, что профиль подготовки приложения включает возможность NFC Tag Reading. Эта настройка NFC не нужна, если NFC отключён.### AndroidСледующие разрешения объявлены в `AndroidManifest.xml` SDK и автоматически объединяются с манифестом приложения:| Разрешение | Описание | Обязательно |
| - | - | - |
| `INTERNET` | Доступ к сети для обмена данными с API | Да |
| `ACCESS_NETWORK_STATE` | Определение доступности сети | Да |
| `CAMERA` | Сканирование документов и верификация лица | Да |
| `NFC` | Считывание NFC-чипов в паспортах и ID-картах | Если используется NFC |Аппаратные возможности камеры и NFC объявлены как необязательные (`android:required="false"`), поэтому ваше приложение можно установить на устройства без этих функций.***## Быстрый старт```tsx theme={null}
import { startVerification, VerificationStatus } from '@didit-protocol/sdk-react-native';

// Start verification with a session token from your backend
const result = await startVerification('your-session-token');

switch (result.type) {
  case 'completed':
    if (result.session.status === VerificationStatus.Approved) {
      console.log('Identity verified!');
    }
    break;
  case 'cancelled':
    console.log('User cancelled');
    break;
  case 'failed':
    console.log('Error:', result.error.message);
    break;
}
```***## Способы интеграцииSDK поддерживает два способа интеграции:### Способ 1: token сессии (рекомендуется для продакшна)Создайте сессию на бэкенде с помощью [Create Verification Session API](https://docs.didit.me/ru/sessions-api/create-session.md), затем передайте token в SDK:```tsx theme={null}
import { startVerification } from '@didit-protocol/sdk-react-native';

// Your backend creates a session and returns the token
const sessionToken = await yourBackend.createVerificationSession(userId);

// Pass the token to the SDK
const result = await startVerification(sessionToken);
```Этот подход даёт вам полный контроль над:- Привязкой сессий к вашим пользователям (`vendor_data`)
- Настройкой пользовательских метаданных
- Настройкой обратных вызовов для каждой сессии### Способ 2: ID сценария (более простая интеграция)Для более простых интеграций SDK может создавать сессии напрямую по ID вашего сценария:```tsx theme={null}
import { startVerificationWithWorkflow } from '@didit-protocol/sdk-react-native';

const result = await startVerificationWithWorkflow('your-workflow-id', {
  vendorData: 'user-123',
  contactDetails: { email: 'user@example.com' },
  config: { loggingEnabled: true },
});
```***## КонфигурацияНастройте поведение SDK, передав объект `DiditConfig`:```tsx theme={null}
const result = await startVerification('your-session-token', {
  languageCode: 'es',           // Force Spanish language
  showLanguageSelector: true,   // Let the user change language
  fontFamily: 'Avenir',         // Custom font (must be registered natively)
  loggingEnabled: true,         // Enable debug logging
  showCloseButton: true,        // Show close (X) button on step screens
  showExitConfirmation: true,   // Confirm before exit
  closeOnComplete: false,       // Auto-dismiss UI on completion
});
```Для `startVerificationWithWorkflow` передайте конфигурацию внутри `options.config`:```tsx theme={null}
const result = await startVerificationWithWorkflow('your-workflow-id', {
  vendorData: 'user-123',
  config: {
    languageCode: 'es',
    showLanguageSelector: true,
    loggingEnabled: true,
    showCloseButton: true,
    showExitConfirmation: true,
  },
});
```### Параметры конфигурации| Свойство | Тип | По умолчанию | Описание |
| - | - | - | - |
| `languageCode` | `string` | Локаль устройства | Код языка ISO 639-1 (например, `"en"`, `"fr"`, `"ar"`) |
| `showLanguageSelector` | `boolean` | `false` | Показывать селектор языка в веб-стиле на приветственном экране |
| `fontFamily` | `string` | Системный шрифт | Название пользовательского семейства шрифтов (должно быть зарегистрировано в нативном коде) |
| `loggingEnabled` | `boolean` | `false` | Включить отладочное логирование SDK |
| `showCloseButton` | `boolean` | `true` | Показывать кнопку закрытия (X) на экранах шагов верификации |
| `showExitConfirmation` | `boolean` | `true` | Показывать диалог подтверждения, когда пользователь пытается выйти |
| `closeOnComplete` | `boolean` | `false` | Автоматически закрывать интерфейс верификации по завершении |
| `defaultDocumentCamera` | `CameraLens?` | Значение по умолчанию в нативном коде (`CameraLens.Back`) | Объектив, который используется при открытии экрана съёмки документа |
| `defaultLivenessCamera` | `CameraLens?` | Значение по умолчанию в нативном коде (`CameraLens.Front`) | Объектив, который используется при открытии экрана съёмки лица (проверка живости) |
| `showDocumentCameraSwitchButton` | `boolean` | `true` | Показывать переключатель камеры во время съёмки на экране съёмки документа |
| `showLivenessCameraSwitchButton` | `boolean` | `true` | Показывать переключатель камеры во время съёмки на экране съёмки лица |### Параметры камерыПараметры камеры совпадают с [параметрами камеры Web SDK](https://docs.didit.me/ru/integration/web-sdks/javascript-sdk.md#параметры-камеры).
Каждый объектив задаётся как `CameraLens.Front` или `CameraLens.Back`.
Если на устройстве нет запрошенного объектива, SDK использует первую доступную камеру.
Переключатель камеры также скрыт на устройствах с одной камерой.
Установите параметр переключателя в `false`, чтобы зафиксировать пользователя на объективе по умолчанию для этого шага.```tsx theme={null}
import { startVerification, CameraLens } from '@didit-protocol/sdk-react-native';

await startVerification('your-session-token', {
  defaultLivenessCamera: CameraLens.Back,
  showLivenessCameraSwitchButton: false,
});
```> [!NOTE]
>
> **Темы и цвета**: цвета, фоны и настройки вступительного экрана задаются в ваших настройках [White label](https://business.didit.me) в Didit Console, а не в конфигурации SDK. Так обеспечивается единый брендинг на всех платформах.***## Поддержка языковSDK поддерживает **54 языка**. Если язык не указан, SDK использует язык устройства, с английским в качестве запасного варианта.```tsx theme={null}
// Use device locale (default)
await startVerification(token);

// Force specific language
await startVerification(token, { languageCode: 'fr' });

// Let the user change language on the welcome screen
await startVerification(token, { showLanguageSelector: true });
```**[Все поддерживаемые языки →](https://docs.didit.me/ru/integration/supported-languages.md)*****## Дополнительные параметрыЭти параметры доступны только с `startVerificationWithWorkflow`, когда SDK создаёт сессию от вашего имени.### Контактные данные (предзаполнение и уведомления)Укажите контактные данные, чтобы предзаполнить формы верификации и включить уведомления по электронной почте:```tsx theme={null}
const result = await startVerificationWithWorkflow('your-workflow-id', {
  contactDetails: {
    email: 'user@example.com',
    sendNotificationEmails: true,  // Send status update emails
    emailLang: 'en',               // Email language (ISO 639-1)
    phone: '+14155552671',         // E.164 format
  },
});
```### Ожидаемые данные (перекрёстная проверка)Укажите ожидаемые данные пользователя для автоматической перекрёстной проверки с данными, извлечёнными из документа:```tsx theme={null}
const result = await startVerificationWithWorkflow('your-workflow-id', {
  expectedDetails: {
    firstName: 'John',
    lastName: 'Doe',
    dateOfBirth: '1990-05-15',     // YYYY-MM-DD format
    gender: 'M',
    nationality: 'USA',            // ISO 3166-1 alpha-3
    country: 'USA',
    address: '1 Market St, San Francisco, CA',
    identificationNumber: 'A1234567',
    ipAddress: '203.0.113.42',
    portraitImage: 'https://...',  // URL or base64 reference image
  },
});
```Все поля `ExpectedDetails` необязательны. Полный тип см. в [`src/types.ts`](https://github.com/didit-protocol/sdk-react-native/blob/main/src/types.ts).### Пользовательские метаданныеСохраняйте пользовательские метаданные в формате JSON вместе с сессией (они не отображаются пользователю):```tsx theme={null}
const result = await startVerificationWithWorkflow('your-workflow-id', {
  vendorData: 'user-123',
  metadata: '{"internalId": "abc123", "source": "mobile-app"}',
});
```***## Обработка результатовИ `startVerification`, и `startVerificationWithWorkflow` возвращают `Promise<VerificationResult>`. Результат представляет собой дискриминированное объединение: чтобы определить исход, используйте поле `type`.### Варианты результата| Вариант | Описание |
| - | - |
| `completed` | Процесс верификации завершён (результат смотрите в `session.status`) |
| `cancelled` | Пользователь отменил процесс верификации |
| `failed` | Во время верификации произошла ошибка |### Свойства SessionData| Свойство | Тип | Описание |
| - | - | - |
| `sessionId` | `string` | Уникальный идентификатор сессии |
| `status` | `VerificationStatus` | `Approved`, `Pending` или `Declined` |### Типы ошибок| Ошибка | Описание |
| - | - |
| `sessionExpired` | Срок действия сессии истёк |
| `networkError` | Проблема с сетевым подключением |
| `cameraAccessDenied` | Разрешение на доступ к камере не предоставлено |
| `notInitialized` | SDK не инициализирован (только Android) |
| `apiError` | Запрос к API завершился ошибкой |
| `unknown` | Другая ошибка с сообщением |### Потеря соединенияЕсли устройство теряет соединение во время верификации, SDK перекрывает процесс экраном «Нет подключения к интернету» вместо того, чтобы оставить шаг в состоянии загрузки.
SDK продолжает проверять соединение в фоновом режиме и закрывает экран автоматически, как только Didit снова становится доступен. Пользователь продолжает с того шага, на котором остановился.
На экране есть кнопки **Try Again** и, когда `showCloseButton` имеет значение `true` (по умолчанию), **Exit Verification**.
Выход завершает верификацию результатом `failed` с ошибкой `networkError`, поэтому ваше приложение узнает, что пользователь ушёл из-за подключения.### Полный пример обработки результата```tsx theme={null}
import {
  startVerification,
  VerificationStatus,
  type VerificationResult,
} from '@didit-protocol/sdk-react-native';

async function verify(token: string) {
  const result: VerificationResult = await startVerification(token);

  switch (result.type) {
    case 'completed':
      switch (result.session.status) {
        case VerificationStatus.Approved:
          console.log('Approved! Session:', result.session.sessionId);
          // User is verified — grant access
          break;
        case VerificationStatus.Pending:
          console.log('Under review. Session:', result.session.sessionId);
          // Show "verification in progress" UI
          break;
        case VerificationStatus.Declined:
          console.log('Declined. Session:', result.session.sessionId);
          // Handle declined verification
          break;
      }
      break;

    case 'cancelled':
      console.log('User cancelled the verification.');
      // Maybe show retry option
      break;

    case 'failed':
      console.log(`Error [${result.error.type}]: ${result.error.message}`);
      // Handle error — show retry or contact support
      break;
  }
}
```***## Сквозной пример (бэкенд-сессия → React Native SDK → webhook)Это готовая к продакшну интеграция: бэкенд создаёт сессию, RN-приложение получает `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. React Native: обмен токеном и запуск SDK```tsx theme={null}
import { useCallback, useState } from 'react';
import { Button, View } from 'react-native';
import {
  startVerification,
  VerificationStatus,
  type VerificationResult,
} from '@didit-protocol/sdk-react-native';

export function VerifyButton({ userId }: { userId: string }) {
  const [loading, setLoading] = useState(false);

  const onPress = useCallback(async () => {
    setLoading(true);
    try {
      const r = await fetch('https://your-backend.example.com/api/verification/start', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ userId }),
      });
      const { session_token } = await r.json();

      const result: VerificationResult = await startVerification(session_token);

      switch (result.type) {
        case 'completed':
          if (result.session.status === VerificationStatus.Approved) {
            // Optimistic UI; rely on the webhook delivered to your backend as the source of truth.
          }
          break;
        case 'cancelled':
          // User dismissed the flow
          break;
        case 'failed':
          // Show retry — result.error.type / result.error.message
          break;
      }
    } finally {
      setLoading(false);
    }
  }, [userId]);

  return (
    <View>
      <Button title={loading ? 'Starting...' : 'Verify identity'} onPress={onPress} disabled={loading} />
    </View>
  );
}
```### 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-подписи см. в [руководстве по webhook](https://docs.didit.me/ru/integration/webhooks.md).***## Полный пример```tsx theme={null}
import { useState, useCallback } from 'react';
import {
  Text,
  View,
  TextInput,
  TouchableOpacity,
  Alert,
  ActivityIndicator,
  SafeAreaView,
} from 'react-native';
import {
  startVerification,
  VerificationStatus,
  type VerificationResult,
} from '@didit-protocol/sdk-react-native';

export default function App() {
  const [token, setToken] = useState('');
  const [loading, setLoading] = useState(false);

  const handleVerify = useCallback(async () => {
    if (!token.trim()) {
      Alert.alert('Error', 'Please enter a session token.');
      return;
    }

    setLoading(true);
    try {
      const result = await startVerification(token.trim(), {
        loggingEnabled: true,
      });

      switch (result.type) {
        case 'completed':
          Alert.alert(
            'Verification Complete',
            `Status: ${result.session.status}\nSession: ${result.session.sessionId}`
          );
          break;
        case 'cancelled':
          Alert.alert('Cancelled', 'The user cancelled the verification.');
          break;
        case 'failed':
          Alert.alert('Failed', `${result.error.type}: ${result.error.message}`);
          break;
      }
    } catch (error) {
      Alert.alert('Error', `Unexpected error: ${error}`);
    } finally {
      setLoading(false);
    }
  }, [token]);

  return (
    <SafeAreaView style={{ flex: 1, padding: 24, justifyContent: 'center' }}>
      <TextInput
        placeholder="Enter session token..."
        value={token}
        onChangeText={setToken}
        autoCapitalize="none"
        style={{
          borderWidth: 1,
          borderColor: '#ccc',
          borderRadius: 8,
          padding: 12,
          marginBottom: 16,
        }}
      />
      <TouchableOpacity
        onPress={handleVerify}
        disabled={loading}
        style={{
          backgroundColor: '#1a1a1a',
          borderRadius: 8,
          padding: 16,
          alignItems: 'center',
          opacity: loading ? 0.6 : 1,
        }}
      >
        {loading ? (
          <ActivityIndicator color="#fff" />
        ) : (
          <Text style={{ color: '#fff', fontWeight: '600' }}>
            Start Verification
          </Text>
        )}
      </TouchableOpacity>
    </SafeAreaView>
  );
}
```***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.