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

# Share Session API: многоразовый KYC между партнёрами

> Многоразовый KYC и KYB от Didit: делитесь верифицированными сессиями с доверенными партнёрами по токенам с ограниченным сроком. Без повторной проверки.

Share Session API позволяет **безопасно передавать многоразовый KYC и KYB**: проверенные данные сессии передаются между доверенными партнёрскими организациями. Работает для сессий проверки пользователей (KYC) и верификации бизнеса (KYB). Токен общего доступа кодирует `session_kind`, поэтому принимающее приложение при импорте создаёт сессию того же типа.

## Эндпоинты

> [card] [Поделиться сессией](https://docs.didit.me/ru/sessions-api/share-session/share.md)
>
> `POST /v3/session/{sessionId}/share/`: создаёт токен общего доступа с ограниченным сроком действия для проверенной сессии.

> [card] [Импорт общей сессии](https://docs.didit.me/ru/sessions-api/share-session/import.md)
>
> `POST /v3/session/import-shared/`: импортирует сессию, которой поделился партнёр, по токену общего доступа.

## Как это работает

**1. Партнёр A делится сессией**

После того как пользователь завершит верификацию на платформе партнёра A, партнёр A вызывает **Поделиться сессией**, передавая ID сессии и ID приложения целевого партнёра. Didit возвращает `share_token` с ограниченным сроком действия.

**2. Токен общего доступа передаётся партнёру B**

Партнёр A передаёт `share_token` партнёру B по собственному защищённому каналу (вызов API, webhook и т. д.).

**3. Партнёр B импортирует сессию**

Партнёр B вызывает **Импорт общей сессии**, передавая `share_token`. Didit создаёт копию проверенной сессии в аккаунте партнёра B со всеми данными верификации.

## Требования

| Требование | Подробности |
| - | - |
| **Статус сессии** | Передавать можно только завершённые сессии (`"Approved"`, `"Declined"`, `"In Review"`) |
| **ID приложения партнёра** | ID приложения целевого партнёра (находится в настройках Business Console) |
| **TTL токена** | Настраивается от 60 до 86,400 секунд (24 часа). По умолчанию: 3,600 секунд (1 час) |
| **Аутентификация** | Оба партнёра должны проходить аутентификацию, используя собственные API-ключи |

## Варианты использования

* **Банки → финтех**: пользователь, верифицированный банком, может получить доступ к финтех-партнёру без повторной верификации
* **Маркетплейс → платёжный провайдер**: продавцы, верифицированные на маркетплейсе, могут сразу подключиться к платёжному провайдеру
* **Страхование → здравоохранение**: обмен данными верификации между доверенными партнёрами из разных отраслей
* **Компании группы**: обмен данными верификации между несколькими приложениями одной организации

> [!NOTE]
>
> Подробнее о функции многоразового KYC читайте в [руководстве по передаче KYC через API](https://docs.didit.me/ru/core-technology/reusable-kyc/share-kyc-via-api.md).


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