Подключение к Цифровому ID

Подключение к платформе MAX для партнёров и её сервисам — чат-ботам, мини-приложениям, каналам — доступно для юрлиц, ИП и самозанятых, которые являются резидентами РФ. Подключение сервисов Цифрового ID и опции подписания документов «Госключом» доступны только для юрлиц и ИП (резидентов РФ)

Цифровой ID в МАХ предоставляет организациям следующие возможности:

Чтобы вы могли проверить совершеннолетие, льготные статусы, электронные карты, а также получить верифицированные данные ЕСИА, у ваших клиентов также должен быть создан Цифровой ID в мессенджере MAX

Кроме сервисов Цифрового ID, вы также можете подключить опцию подписания документов «Госключом»
Вы сможете направлять своим клиентам документы над подпись, а те — подписывать УНЭП или УКЭП с помощью «Госключа». Для подключения вам понадобятся подтверждающие документы, а клиентам — установленное приложение «Госключ». Подробнее о «Госключе» и его возможностях читайте на портале Госуслуг

Чтобы подключить нужные возможности, перейдите на платформе в раздел Сервисы Цифрового ID → Подключить, выберите нужные опции и следуйте инструкциям на экране. Если вы ранее уже получали токен Цифрового ID, вы можете добавить к нему новые опции. При этом токен останется прежним: если вы уже настраивали интеграцию через API Цифрового ID MAX, то обновлять его или вносить другие изменения для уже подключённых функций не нужно. Настройка интеграции потребуется только для новых опций — подробнее в описании API Цифрового ID MAX на платформе

Для подключения передачи данных из Цифрового ID и подписания документов Госключом понадобятся подтверждающие документы

В мини-приложении «MAX для бизнеса» работа с сервисами Цифрового ID недоступна

Проверка совершеннолетия и льготного статуса

Если у вашего магазина или торговой точки подключён Цифровой ID с опцией «Проверка возраста и льготного статуса», клиенты смогут подтвердить совершеннолетие, а также статусы студента, многодетного, пенсионера и человека с инвалидностью без бумажных документов: с помощью QR-кода (Android и iOS) или NFC (только Android) в мессенджере MAX

Цифровой ID для продавцов

Подключение сервисов Цифрового ID и опции подписания документов «Госключом» на платформе MAX для партнёров доступно только для юрлиц и ИП (резидентов РФ). Для самозанятых сервисы Цифрового ID и подписание «Госключом» недоступны

Чтобы покупатели могли воспользоваться Цифровым ID в вашем магазине или торговой точке, вам необходимо подключить его через API Цифрового ID МАХ

Для этого предварительно нужно зарегистрироваться на платформе MAX для партнёров, создать и верифицировать профиль организации или ИП. А затем — получить токен доступа к API Цифрового ID MAX и с его помощью настроить обмен данными между MAX и кассами ваших магазинов или торговых точек

Также перед подключением проверьте, что у вас есть профиль в мессенджере MAX, зарегистрированный на номер телефона, с которым вы входите на платформу

При подключении Цифрового ID на платформе выберите опцию Проверка возраста и льготного статуса

Цифровой ID для покупателей

Цифровой ID в мессенджере МАХ — это аналог паспорта и других бумажных документов, с помощью которого пользователи мессенджера могут подтвердить своё совершеннолетие, а также льготные статусы: студент, многодетный, человек с инвалидностью, пенсионер

Пользователь создаёт Цифровой ID на основе своих данных из Госуслуг. После создания у пользователей появляется QR-код, который можно предъявить с мобильного устройства на кассе вместо паспорта и других бумажных документов для подтверждения совершеннолетия и льготных статусов. Вместо QR-кода покупатели могут также использовать NFC — доступно только для устройств на Android

Покупатели могут предъявить Цифровой ID с помощью QR-кода или NFC кассиру или через кассу самообслуживания. Идентификатор динамический и периодически обновляется

Подробнее о создании Цифрового ID для покупателей — в помощи мессенджера MAX

Как подключить сервисы Цифрового ID и получить токен

Если у вас уже есть токен Цифрового ID и вы хотите добавить к нему новые функции, смотрите раздел Как добавить функции к токену Цифрового ID

Если вы впервые подключаете сервисы Цифрового ID на платформе:

  1. Перейдите в профиль вашей организации или ИП на платформе
  2. В разделе Цифровой ID выберите Подключить
Подключение Цифрового ID
  1. Укажите нужные опции: можно выбрать одну или несколько, а остальные добавить позже. Дальнейший сценарий зависит от выбранных опций:
Выбраны опции «Подписание документов Госключом» или «Получение данных»
  1. Нажмите Продолжить
  2. Загрузите документы в соответствии с рекомендациями на экране и нажмите Получить токен. Документы будут отправлены на модерацию. Дождитесь окончания проверки — обычно занимает до одного рабочего дня
  3. Если модерация пройдена успешно, скопируйте токен в разделе Цифровой ID → Управлять
  4. Нажмите Инструкция для подключения — вы перейдёте к описанию API Цифрового ID MAX и сможете настроить дальнейшее взаимодействие

Если модерация не пройдена, проверьте соответствие документов требованиям и попробуйте ещё раз

Если вам нужно подключить несколько опций, вы можете сначала подключить те, для которых не нужно прикреплять документы: «Проверка возраста и льготного статуса», «Электронные карты», — получить для них токен и начать настраивать интеграцию. А затем — добавить к токену опции «Подписание документов Госключом» или «Получение данных»
Подключение Цифрового ID
Загрузка документов для подписания Госключом
Отправка документов на модерацию
Функции успешно добавлены
Выбраны любые опции, кроме «Подписание документов Госключом» и «Получение данных»
  1. Нажмите Получить токен. Дождитесь генерации токена и скопируйте его
  2. Нажмите Инструкция для подключения — вы перейдёте к описанию API Цифрового ID MAX и сможете настроить дальнейшее взаимодействие
Подключение Цифрового ID
Подключение Цифрового ID

Модерация документов

Чтобы подключить опции «Подписание документов Госключом» и «Получение данных», нужно прикрепить документы, подтверждающие требования к средствам криптографической защиты информации, а также обработке и защите персональных данных

Документы проходят модерацию — обычно занимает до одного рабочего дня. Если модерация пройдена успешно, опция будет подключена и вы получите токен. Если модерация не пройдена, проверьте соответствие требованиям и попробуйте ещё раз

Если вам нужно подключить несколько опций, вы можете сначала подключить те, для которых не нужно прикреплять документы: «Проверка возраста и льготного статуса», «Электронные карты», — получить для них токен и начать настраивать интеграцию. А затем — добавить к токену опции «Подписание документов Госключом» или «Получение данных»

Какие документы нужны

Обработка данных

Средства криптографической защиты информации (СКЗИ)

Защита персональных данных

Откреплённая электронная подпись

Формат электронной подписи, при котором файл подписи с криптографическими данными, подтверждающими подлинность и неизменность документа, формируется отдельно от подписываемого документа. Для каждого документа должна быть сформирована своя откреплённая подпись
Формат: SIG, до 15 МБ

Требования к документам

Убедитесь, что ваша организация соответствует следующим требованиям:

Если все требования выполнены, но документы не проходят модерацию, напишите в службу поддержки

Как добавить функции к токену Цифрового ID

Если у вас уже есть токен Цифрового ID и добавлены не все возможности, вы можете в любой момент добавить недостающие

При добавлении новых функций к Цифровому ID токен останется прежним: если у вас уже настроена интеграция через API Цифрового ID MAX, то обновлять его или вносить другие изменения для уже подключённых функций не нужно. Настройка интеграции потребуется только для новых опций — подробнее в описании API Цифрового ID MAX на платформе

Чтобы добавить функции к вашему токену Цифрового ID:

  1. В профиле вашей организации или ИП на платформе перейдите в раздел Цифровой ID → Управлять
  2. Нажмите Добавить функции и укажите нужные: можно выбрать одну или несколько, а остальные добавить позже. Дальнейший сценарий зависит от выбранных опций:
Подключение Цифрового ID
Подключение Цифрового ID
Выбраны опции «Подписание документов Госключом» или «Получение данных»
  1. Нажмите Продолжить
  2. Загрузите документы в соответствии с рекомендациями на экране и нажмите Получить токен. Документы будут отправлены на модерацию. Дождитесь окончания проверки — обычно занимает до одного рабочего дня
  3. Если модерация пройдена успешно, скопируйте токен в разделе Цифровой ID → Управлять
  4. Нажмите Инструкция для подключения — вы перейдёте к описанию API Цифрового ID MAX и сможете настроить дальнейшее взаимодействие

Если модерация не пройдена, проверьте соответствие документов требованиям и попробуйте ещё раз

Если вам нужно подключить несколько опций, вы можете сначала подключить те, для которых не нужно прикреплять документы: «Проверка возраста и льготного статуса», «Электронные карты», — получить для них токен и начать настраивать интеграцию. А затем — добавить к токену опции «Подписание документов Госключом» или «Получение данных»
Подключение Цифрового ID
Подключение Цифрового ID
Подключение Цифрового ID
Подключение Цифрового ID
Выбраны любые опции, кроме «Подписание документов Госключом» и «Получение данных»
  1. Нажмите Получить токен. Дождитесь генерации токена и скопируйте его
  2. Нажмите Инструкция для подключения — вы перейдёте к описанию API Цифрового ID MAX и сможете настроить дальнейшее взаимодействие
Подключение Цифрового ID
Подключение Цифрового ID

Как обновить токен

  • Срок жизни токена Цифрового ID — один год
  • Обратите внимание: после обновления токена потребуется повторная настройка интеграции с сервисами Цифрового ID
    Если у вас подключена опция проверки совершеннолетия и льготных статусов, все магазины и торговые точки, подключённые к Цифровому ID, будут отключены — вам потребуется настроить взаимодействие по API заново, с новым токеном
  • Если вы хотите обновить токен до окончания его срока жизни, рекомендуем это делать только в исключительных случаях, например, если вы подозреваете, что токен попал в руки мошенников
  1. Перейдите в профиль организации или ИП на платформе MAX для партнёров
  2. В разделе Цифровой ID нажмите Управлять
  3. В правом верхнем углу нажмите на три точки → Обновить токен
  4. Отправьте заявку на почту с экрана
  5. Дождитесь уведомления о смене токена, затем на платформе в разделе Цифровой ID нажмите Настроить и скопируйте новый токен
  6. Перейдите к описанию интеграции по API Цифрового ID MAX, нажав Инструкция для подключения, и повторно настройте взаимодействие ваших сервисов с Цифровым ID
Подключение Цифрового ID
Подключение Цифрового ID

Вернуться к выбору сервисов для интеграции


ℹ️ Если у вас возникли вопросы, посмотрите раздел с ответами