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

# Web SDK верификации личности: JavaScript и iframe

> Didit Web SDK для KYC, KYB и AML: JavaScript, iframe, редирект или WebView. От $0.33 за полную KYC-проверку, $10 бесплатно в месяц.

> [!NOTE]
>
> Эти руководства описывают верификацию личности. Для входа конечных пользователей используйте [руководства по платформе аутентификации](https://docs.didit.me/ru/authentication/overview.md); новые пакеты аутентификации зависят от релиза.

Интегрируйте верификацию Didit в свое веб-приложение. Мы предлагаем семь методов интеграции, которые подойдут вашей архитектуре и требованиям к пользовательскому опыту. Выберите тот, который соответствует вашему стеку.

> [!NOTE]
>
> **Выберите метод интеграции**: от быстрых iframe без кода до полного программного контроля с помощью нашего JavaScript SDK, а также готовых плагинов для WordPress, Shopify и Salesforce.

***

## Методы интеграции

| Метод | Время настройки | Бэкенд? | Лучше всего подходит для |
| - | - | - | - |
| [JavaScript SDK](https://docs.didit.me/ru/integration/web-sdks/javascript-sdk.md) | 3 минуты | Опционально | Полный контроль — React/Vue/Angular/Next.js/Nuxt/Svelte/обычный JS |
| [InContext (Iframe)](https://docs.didit.me/ru/integration/web-sdks/incontext-iframe.md) | менее 1 минуты | Опционально | Встроенный сценарий без перенаправления |
| [Redirect](https://docs.didit.me/ru/integration/web-sdks/web-redirect.md) | 5 минут | Да | Максимальная совместимость, сценарии с переключением между устройствами |
| [WebView (iOS/Android)](https://docs.didit.me/ru/integration/web-sdks/webview-in-ios-android.md) | 15 минут | Да | Запасной вариант для мобильных приложений, когда нативный SDK недоступен |
| [WordPress + WooCommerce](https://docs.didit.me/ru/integration/web-sdks/wordpress-woocommerce.md) | 5 минут | Без кода | Сайты на WordPress, магазины WooCommerce |
| [Shopify](https://docs.didit.me/ru/integration/web-sdks/shopify.md) | 5 минут | Без кода | Магазины Shopify: проверка при оформлении заказа или аккаунта |
| [Salesforce](https://docs.didit.me/ru/integration/web-sdks/salesforce.md) | 10 минут | Без кода | CRM Salesforce: верификация записей Contact и Lead |

> [!NOTE]
>
> **Рекомендация**: для продакшн-веб-приложений используйте **JavaScript SDK** для лучшего UX и полного программного контроля. Используйте **InContext iframe** для самой быстрой настройки, **Redirect**, когда нужна верификация с переключением между устройствами, а также специализированные интеграции **WordPress / Shopify / Salesforce**, если вы работаете на этих платформах.

***

## JavaScript SDK

JavaScript SDK Didit предоставляет программный способ интеграции верификации с полным контролем над пользовательским опытом.

**Ключевые возможности:**

* Управление сессиями и обратные вызовы событий
* Поддержка React, Vue, Angular, NextJS, Nuxt, Svelte и обычный JS
* Полная поддержка TypeScript
* Режимы модального окна и встраивания

**Быстрый старт:**

```javascript theme={null}
import { DiditSdk } from '@didit-protocol/sdk-web';

DiditSdk.shared.onComplete = (result) => {
  switch (result.type) {
    case 'completed':
      console.log('Verification completed!');
      console.log('Session ID:', result.session?.sessionId);
      console.log('Status:', result.session?.status);
      break;
    case 'cancelled':
      console.log('User cancelled verification');
      break;
    case 'failed':
      console.error('Verification failed:', result.error?.message);
      break;
  }
};

// Start verification with the `url` returned by POST /v3/session/ (or your UniLink)
DiditSdk.shared.startVerification({
  url: 'https://verify.didit.me/session/3FaJ9wLqX2Mz'
});
```

→ [**Полная документация по JavaScript SDK**](https://docs.didit.me/ru/integration/web-sdks/javascript-sdk.md)

***

## InContext (Iframe)

Встраивайте процесс верификации непосредственно в ваше приложение с помощью iframe. Бесшовный процесс без перенаправления пользователей с вашего сайта.

**Ключевые возможности:**

* UniLink (без бэкенда): настройка менее 1 минуты
* API-сессия (с бэкендом): полная кастомизация
* Режимы модального окна и встраивания
* Примеры компонентов React

**Быстрый старт:**

```html theme={null}
<iframe 
  src="https://verify.didit.me/u/YOUR_WORKFLOW_ID_BASE64"
  style="width: 100%; height: 700px; border: none;" 
  allow="camera; microphone; geolocation; clipboard-write; fullscreen; autoplay; encrypted-media; digital-credentials-get"
></iframe>
```

→ [**Полная документация по InContext**](https://docs.didit.me/ru/integration/web-sdks/incontext-iframe.md)

***

## Redirect

Перенаправьте пользователей на размещённую на стороне Didit страницу верификации. После завершения пользователи возвращаются на ваш URL обратного вызова.

**Ключевые возможности:**

* Максимальная совместимость с браузерами
* Поддержка верификации с переключением между устройствами
* Простая интеграция
* Работает, когда доступ камеры в iframe вызывает проблемы

**Быстрый старт:**

```javascript theme={null}
// After creating a session via your backend
window.location.href = verificationUrl;
```

→ [**Полная документация по Redirect**](https://docs.didit.me/ru/integration/web-sdks/web-redirect.md)

***

## Сравнение

| Характеристика | JavaScript SDK | InContext (Iframe) | Redirect |
| - | - | - | - |
| Время настройки | 3 мин | \< 1 мин | 5 мин |
| Требуется бэкенд | Опционально | Опционально | Да |
| Остаётся на вашем домене | Да | Да | Нет |
| Поддержка переключения между устройствами | Да | Да | Да |
| Полный программный контроль | Да | Ограниченный | Только обратный вызов |
| Обратные вызовы событий | В реальном времени | `postMessage` | Только обратный вызов |
| White label | Да | Да | Да |
| Совместимость с браузерами | Все | Все | Все |

> [!NOTE]
>
> Все три метода передают окончательные подписанные результаты через [webhook](https://docs.didit.me/ru/integration/webhooks.md). Сравнение выше описывает UX в браузере, а не то, как вы получаете решение о верификации.

***

## Конфигурация

### Обязательные разрешения для iframe

Для интеграций InContext iframe всегда включайте следующие разрешения:

```html theme={null}
allow="camera; microphone; geolocation; clipboard-write; fullscreen; autoplay; encrypted-media; digital-credentials-get"
```

***

## Примеры репозиториев

> [card] [Примеры SDK для веба](https://github.com/didit-protocol/sdk-web-examples)
>
> Примеры для React, Vue, Angular, Next.js, Nuxt, Svelte и обычный JS

> [card] [Пример iframe](https://github.com/didit-protocol/iframe-example)
>
> Примеры iframe для UniLink и API-сессии

> [card] [Полное демо на Next.js](https://github.com/didit-protocol/didit-full-demo)
>
> Сквозная интеграция с Next.js

> [card] [NPM-пакет](https://www.npmjs.com/package/@didit-protocol/sdk-web)
>
> `@didit-protocol/sdk-web` в npm

## Связанные материалы

* [Webhook](https://docs.didit.me/ru/integration/webhooks.md) — получение подписанных результатов верификации на вашем бэкенде
* [API создания сессии](https://docs.didit.me/ru/sessions-api/create-session.md) — эндпоинт, лежащий в основе каждого веб-SDK
* [Нативные SDK](https://docs.didit.me/ru/integration/native-sdks/overview.md) — iOS, Android, React Native, Flutter


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