Вход через Яндекс ID One Tap

Модуль работает на CS-Cart и Multi-Vendor начиная с версии 4.3.1 и поддерживает редакции CS-Cart, CS-Cart Ultimate, Multi-Vendor, Multi-Vendor Plus и Multi-Vendor Ultimate.

На витрине модуль встраивается через стандартные хуки темы Responsive и тем, построенных на её основе. Кнопка Яндекса выводится хуком index:login_buttons шаблона views/auth/login_form.tpl, который используют всплывающее окно входа, страница входа, блок Мой аккаунт и формы входа при оформлении заказа; блок на странице регистрации и в профиле покупателя — хуком profiles:account_update шаблона views/profiles/update.tpl. Если ваша тема переопределяет эти шаблоны без хуков, кнопка и блок привязки не появятся, пока хуки не будут возвращены.

Кнопку и виджет рисует SDK Яндекса (passport-sdk), который подключается с yastatic.net и работает через iframe. Ему нужны витрина по HTTPS и доступ браузера покупателя к серверам Яндекса. Если SDK не загрузился (например, заблокирован расширением браузера), места под кнопки через 15 секунд скрываются, а обычная форма входа продолжает работать. Персональная кнопка с именем и портретом и виджет Мгновенный вход опираются на сторонние cookie: в Safari, Firefox в строгом режиме и при блокировщиках рекламы виджет не появится, а кнопка работает, но без имени и портрета.

На Multi-Vendor через Яндекс ID входят только покупатели: учётные записи продавцов и администраторов модуль не затрагивает. В редакциях с несколькими витринами настройки задаются отдельно для каждой витрины.

Рядом с модулем Вход через Google One Tap от CS-Commerce кнопки Яндекса и Google выстраиваются в один столбик под общим разделителем.

В случае конфликта модуля с вашей темой или другим решением обращайтесь в наш центр поддержки.

После оформления и оплаты, ваш заказ будет автоматически переведен в статус Оплачен в течение считанных минут. Статус заказа Оплачен означает активацию лицензии и вам на e-mail отправляется письмо с подтверждением о получении оплаты и письмо со ссылкой на скачивание модуля. Так же модуль всегда можно скачать в нашем разделе Управление лицензиями. Для установки модуля на ваш сайт, пожалуйста, выполните следующие шаги:

1. Скачайте последнюю версию модуля на нашем сайте в разделе "Управление лицензиями" или по ссылке, отправленной по e-mail.
2. Пройдите в раздел Модули → Управление модулями и в меню шестерёнки выберите Ручная установка.
3. Выберите ранее скачанный файл и завершите установку модуля.

На этом установка модуля завершена. Для перехода на страницу настроек модуля выберите установленный модуль в разделе Модули → Модули CS-Commerce

Страница настроек модуля находится в разделе Модули → Модули CS-Commerce → Вход через Яндекс ID One Tap. Попасть на неё можно и через Модули → Управление модулями: при открытии настроек модуля из общего списка система сама перенаправит вас на эту страницу.

Все настройки собраны на одной вкладке Основные настройки в пять групп: Яндекс OAuth, Кнопка входа, Виджет «Мгновенный вход», Учётные записи покупателей и Диагностика; каждая разобрана в разделе Основные настройки модуля. Справа расположены блоки с информацией об установленной версии модуля и сроке подписки на обновления, ссылка на документацию и форма оценки модуля.

Пока поле Client ID пустое, модуль на витрине ничего не показывает: ни кнопку, ни виджет, ни блок привязки в профиле. Как получить Client ID — в разделе Настройка приложения в Яндекс OAuth.

Настройки по витринам

В редакциях CS-Cart Ultimate и Multi-Vendor Ultimate с несколькими витринами настройки хранятся отдельно для каждой витрины. Витрина выбирается переключателем в шапке страницы. Пока витрина не выбрана, поля недоступны для изменения, а рядом с каждым появляется стандартный для Ultimate значок замка — в открытом состоянии значение записывается сразу во все витрины.

В Multi-Vendor с одной витриной настройки общие для всего маркетплейса; отдельных значений для продавцов нет.

Права доступа

Модуль добавляет собственную группу привилегий — Управление модулем "Вход через Яндекс ID One Tap". В ней две привилегии: просмотр страницы настроек и её изменение. По умолчанию они не выданы ни одной группе пользователей, поэтому администратор с ограниченными правами страницу настроек не увидит, пока привилегии не будут выданы его группе.

Привилегии влияют только на доступ к странице настроек. Вход через Яндекс ID на витрине от прав администраторов не зависит.

Яндекс OAuth

В начале группы — памятка Как получить Client ID с готовым адресом вспомогательной страницы модуля для поля Redirect URI и списком доступов, которые нужно отметить в приложении; сам процесс описан в разделе Настройка приложения в Яндекс OAuth.

Client ID — идентификатор OAuth-приложения с oauth.yandex.ru. Обязательное поле: пока оно пустое, вход через Яндекс ID на витрине не показывается.

Разрешённые домены e-mail — список доменов через запятую, например company.ru, partner.org. Если поле заполнено, войти через Яндекс ID смогут только аккаунты с e-mail в этих доменах; остальные увидят сообщение Аккаунты с таким доменом e-mail не могут входить в этот магазин. Пустое поле принимает любые аккаунты Яндекса.

Кнопка входа

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

Тип кнопки — Основная (заливка, с надписью) (по умолчанию), Дополнительная (с обводкой, с надписью), Иконка на красном фоне или Иконка на сером фоне. Кнопки-иконки квадратные и подходят для компактных форм.

Тема кнопки — Светлая (по умолчанию) или Тёмная, под фон формы входа.

Размер кнопки — базовая высота кнопки Яндекса от XS до XXL; по умолчанию M, около 40 px. По ширине кнопка растягивается на всю форму.

Скругление углов, px — по умолчанию 4; 0 — прямые углы.

Язык логотипа — буква на логотипе: Русский (Я) (по умолчанию) или Английский (Y).

Виджет «Мгновенный вход»

Показывать гостям виджет «Мгновенный вход» — по умолчанию выключено. На странице появляется небольшая панель Яндекса с предложением войти через аккаунт, в который посетитель уже вошёл в браузере. Авторизованным покупателям она не показывается.

Под настройкой выводится памятка Почему виджет или персональная кнопка могут не появляться; те же причины разобраны в разделе Виджет «Мгновенный вход».

Учётные записи покупателей

Создавать учётную запись новым покупателям — по умолчанию включено. Если учётной записи с e-mail аккаунта Яндекса нет, профиль покупателя создаётся автоматически с именем из аккаунта. Если выключить, такие посетители увидят сообщение Учётной записи с таким e-mail ещё нет. Пожалуйста, сначала зарегистрируйтесь.

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

Входить в существующие учётные записи по e-mail — по умолчанию включено. Если учётная запись покупателя с таким же e-mail уже существует, покупатель входит в неё, а Яндекс ID привязывается к профилю. Если выключить, такому покупателю предлагается сначала войти по паролю и привязать Яндекс ID в настройках профиля.

Запоминать вход — по умолчанию включено. Работает как галочка Запомнить меня в обычной форме входа: сессия покупателя сохраняется в cookie и переживает закрытие браузера.

После входа — куда попадает покупатель после входа через Яндекс ID: Остаться на текущей странице (по умолчанию), Открыть страницу личного кабинета или Открыть указанный адрес. Для последнего варианта появляется поле Адрес после входа: диспетчер магазина (например, orders.search) или полный адрес страницы магазина.

Диагностика

Записывать отклонённые попытки входа в журнал — по умолчанию выключено. Причины неудачных входов через Яндекс ID (Яндекс не передал e-mail, запрещённый домен, отключённая учётная запись, попытка войти под администратором и другие) записываются в Администрирование → Журналы вместе с e-mail аккаунта. Коды причин — в разделе Безопасность и журнал.

Модулю нужно OAuth-приложение Яндекса: по его идентификатору (Client ID) Яндекс выдаёт покупателю токен, а магазин проверяет, что токен выдан именно вашему приложению. Секрет приложения не используется: токен проверяется прямым запросом магазина к Яндексу.

1. Войдите в Яндекс OAuth и нажмите Создать приложение → Для авторизации пользователей. Укажите название сервиса, иконку и контактную почту.
2. Платформа — Веб-сервисы. В поле Redirect URI укажите вспомогательную страницу модуля; её точный адрес выводится в памятке на странице настроек модуля и имеет вид https://ваш-магазин/index.php?dispatch=csc_yandex_oauth.token. Это страница без содержимого: она лишь принимает токен от Яндекса и передаёт его в окно магазина.
3. Доступ к данным: отметьте Логин, имя и фамилия, пол, Портрет пользователя и Адрес электронной почты. Номер телефона — по желанию: если доступ выдан и покупатель его подтвердил, телефон попадёт в профиль.
4. Скопируйте Client ID со страницы приложения в одноимённое поле настроек модуля и сохраните настройки.

Без доступа к адресу электронной почты вход невозможен: покупатель увидит сообщение Яндекс не передал адрес e-mail. Без доступа к имени и фамилии учётная запись создаётся с логином Яндекса вместо имени.

Витрина должна работать по HTTPS: мгновенная авторизация Яндекса открывает только защищённые страницы, и адрес Redirect URI модуль строит с https.

Где появляется кнопка

При включённой настройке Показывать кнопку в формах входа кнопка Яндекс ID выводится под обычной формой входа за разделителем или: во всплывающем окне входа в шапке, на странице входа, в блоке Мой аккаунт и в формах входа при оформлении заказа. На странице регистрации кнопка стоит под формой со строкой или зарегистрируйтесь в один клик. Кнопку рисует SDK Яндекса: посетителю, который уже вошёл в Яндекс в браузере, она показывает его имя и портрет, остальным предлагает войти.

Клик по кнопке открывает окно Яндекса с коротким подтверждением. Яндекс возвращает в браузер токен через вспомогательную страницу модуля, модуль отправляет его в магазин, и после проверки покупатель входит в магазин. Куда он попадает после входа, задаёт настройка После входа: по умолчанию остаётся на той же странице.

Виджет «Мгновенный вход»

При включённой настройке Показывать гостям виджет «Мгновенный вход» гостю в углу страницы показывается панель Яндекса: если он вошёл в Яндекс в браузере, в ней его аккаунт, иначе предложение войти. Один клик — и вход выполнен, без формы входа. Вошедшим в магазин покупателям панель не показывается. В отличие от Google One Tap, у Яндекса нет кулдауна: закрытый виджет просто появится снова при следующей загрузке страницы.

В каких браузерах виджет и персональная кнопка могут не появляться — в разделе Виджет «Мгновенный вход».

Что происходит с учётной записью

• Яндекс ID уже привязан к покупателю — выполняется вход в эту учётную запись.
• E-mail известен магазину, но Яндекс ID ещё не привязан — при включённой настройке Входить в существующие учётные записи по e-mail покупатель входит в существующую учётную запись, и Яндекс ID привязывается к ней. Пустые имя и фамилия и пустой телефон в профиле заполняются из Яндекс ID; заполненные поля не меняются. При выключенной настройке покупатель видит сообщение с просьбой войти по паролю и привязать Яндекс ID в настройках профиля.
• E-mail магазину неизвестен — при включённой настройке Создавать учётную запись новым покупателям создаётся учётная запись покупателя: e-mail и логин — адрес аккаунта Яндекса, имя и фамилия — из Яндекс ID (они же записываются в имя получателя в адресе; если доступ к имени не выдан, вместо имени подставляется логин Яндекса), телефон — если Яндекс его передал, язык — текущий язык витрины, пароль — случайный. По желанию уходит стандартное письмо о регистрации. Покупатель видит сообщение Добро пожаловать! Учётная запись создана, вы вошли в магазин. При выключенной настройке — сообщение с просьбой сначала зарегистрироваться.

Заказы, оформленные гостем в той же сессии до входа, привязываются к учётной записи. Через Яндекс ID могут входить только покупатели: если e-mail принадлежит учётной записи администратора или продавца, вход отклоняется с сообщением Вход через Яндекс ID доступен только покупателям. Отключённая учётная запись покупателя также не пропускается.

Пароль покупателю, созданному через Яндекс ID, не сообщается, но обычный вход по e-mail и паролю остаётся доступен: пароль задаётся через штатную ссылку Забыли пароль?.

Привязка аккаунта в профиле

В личном кабинете на странице профиля появляется блок Яндекс ID. Если аккаунт привязан, в блоке показаны портрет и e-mail аккаунта Яндекса и кнопка Отвязать; после отвязки вход через этот аккаунт снова пройдёт через сопоставление по e-mail.

Если аккаунт не привязан, в блоке стоит кнопка Яндекса с подсказкой Привяжите Яндекс ID, чтобы входить в магазин без пароля: вошедший покупатель нажимает её и подтверждает аккаунт, который будет привязан к профилю.

Один Яндекс ID может быть привязан только к одному покупателю: попытка привязать аккаунт, уже связанный с другим профилем, отклоняется с сообщением Этот Яндекс ID уже привязан к другому покупателю. При удалении учётной записи покупателя привязка удаляется вместе с ней.

Виджет и персональную кнопку с именем и портретом рисует SDK Яндекса в браузере покупателя; модуль лишь подключает SDK и запрашивает виджет для гостей. В отличие от Google One Tap, у Яндекса нет кулдауна после закрытия подсказки, и Chrome её не блокирует: закрытый виджет откроется снова при следующей загрузке страницы. Зато он работает через iframe и сторонние cookie, поэтому не показывается, если браузер:

• блокирует сторонние cookie — Safari и Firefox в строгом режиме делают это по умолчанию, как и многие блокировщики рекламы. Виджета нет, кнопка работает, но без имени и портрета посетителя;
• запрещает iframe или в нём отключён JavaScript;
• полностью отключил cookie — SDK Яндекса возвращает ошибку, и ничего не рисуется.

Также предлагать нечего, если у посетителя нет сессии Яндекса в этом браузере, а вошедшим в магазин покупателям виджет не показывается вовсе. Страница должна открываться по HTTPS.

Если SDK Яндекса не загрузился (например, заблокирован расширением браузера), через 15 секунд модуль скрывает места под кнопки, и покупатель видит обычную форму входа без пустых промежутков. Ошибки SDK выводятся в консоль браузера строкой, начинающейся с Yandex ID:.

Та же памятка выводится на странице настроек модуля под группой Виджет «Мгновенный вход».

Проверка токена

SDK Яндекса получает в браузере покупателя OAuth-токен и через вспомогательную страницу модуля (Redirect URI) передаёт его в окно магазина; обмена кодами и секретом приложения нет. Модуль отправляет токен на сервер магазина и проверяет его сам:

• прямым запросом к Яндексу (https://login.yandex.ru/info) по токену получается профиль покупателя; недействительный токен Яндекс отклоняет;
• принадлежность приложению — идентификатор приложения в ответе Яндекса совпадает с Client ID из настроек;
• в профиле есть адрес e-mail (основной или первый из переданных); без него вход отклоняется;
• домен e-mail входит в список Разрешённые домены e-mail, если он задан.

Запросы витрины к модулю принимаются только методом POST и защищены штатной проверкой CSRF-токена CS-Cart. Адрес возврата после входа проверяется на принадлежность домену магазина: перенаправить покупателя на чужой сайт через параметр ссылки нельзя. Вспомогательная страница токена закрыта от индексации и передаёт токен только окну с адресом вашей витрины.

Кто может войти

Через Яндекс ID входят только учётные записи покупателей. Если e-mail аккаунта Яндекса принадлежит администратору или продавцу, вход отклоняется. Отключённые учётные записи не пропускаются. Один Яндекс ID связан не более чем с одной учётной записью покупателя.

Что хранит модуль

Привязки хранятся в таблице csc_yandex_oauth_users: идентификатор и логин Яндекс ID, e-mail, имя и адрес портрета, дата привязки, дата последнего входа и число входов. Токены Яндекса в магазине не сохраняются. Пароль покупателю, созданному через Яндекс ID, генерируется случайный и хранится штатным образом. При удалении покупателя запись о привязке удаляется; при удалении модуля таблица удаляется вместе со всеми привязками.

Журнал

При включённой настройке Записывать отклонённые попытки входа в журнал каждый неудачный вход записывается в Администрирование → Журналы строкой csc_yandex_oauth: Sign-in rejected с кодом причины и e-mail аккаунта. Коды и соответствующие им сообщения покупателю:

• no_email — Яндекс не передал адрес e-mail, поэтому войти через этот аккаунт нельзя (в приложении не выдан доступ к адресу электронной почты или покупатель его не подтвердил);
• domain_not_allowed — Аккаунты с таким доменом e-mail не могут входить в этот магазин;
• account_not_found — Учётной записи с таким e-mail ещё нет. Пожалуйста, сначала зарегистрируйтесь (создание учётных записей выключено);
• account_exists_not_linked — Учётная запись с таким e-mail уже существует. Войдите по паролю и привяжите Яндекс ID в настройках профиля (вход в существующие учётные записи выключен);
• account_disabled — Эта учётная запись отключена;
• not_customer — Вход через Яндекс ID доступен только покупателям;
• yandex_account_taken — Этот Яндекс ID уже привязан к другому покупателю;
• cant_create_profile — Не удалось создать учётную запись. Пожалуйста, зарегистрируйтесь через форму;
• yandex_unavailable — Яндекс временно недоступен. Попробуйте ещё раз через минуту (Яндекс не ответил на запрос профиля);
• malformed_token, token_invalid, bad_audience, login_failed — Не удалось войти через Яндекс ID. Попробуйте ещё раз или войдите по e-mail и паролю.

Для разработчиков

Перед созданием учётной записи модуль вызывает хук csc_yandex_oauth_create_user с данными профиля Яндекса и массивом данных покупателя, который передаётся в fn_update_user(): в нём можно дополнить или изменить поля профиля. На витрине при неудачном входе срабатывает событие ce.csyo.login_failed с кодом ошибки, а функция Tygh.csyoRenderButtons() отрисовывает кнопки в динамически добавленной разметке.

Для того, чтобы иметь доступ к обновлениям модуля, у вас должен быть активный период подписки на обновления. При истекшем периоде подписки, вам будут доступны только обновления, выпущенные до даты истечения вашей подписки. Продлить подписку на обновления можно в разделе "Управление лицензиями" на нашем сайте. 

Модуль поддерживает поставку обновлений через Центр обновлений CS-Cart. О выходе новых версий модуля вас оповестит встроенный Центр уведомлений Cart (колокольчик). Обновление модуля с помощью Центра обновлений позволит без потерь настроек данных модуля произвести переход на более новую версию модуля.

Непосредственно перед обновлением, крайне рекомендуется делать полный бэкап сайта (базы данных и файлов) вашего магазина средствами сервера или хостинга.

Обновление модуля через Центр обновлений:

1. В верхнем меню пройдите в раздел Администрирование → Центр обновлений;
2. В меню шестеренки нажмите "Проверить доступные обновления"
3. Cреди списка доступных обновлений найдите нужное и нажмите кнопку Обновить;
4. Следуйте всем инструкциям, которые будут показаны при процедуре обновления;
5. Рекомендуется произвести очистку кэша CS-Cart после завершения устанвоки обновлений удалением папки var/cache на вашем сервере или добавлением в адресную строку параметра ctpl (прмиер: https://domain.com/admin.php?ctpl).

Переустановка модуля удалением:

Переустановка модуля означает удаление настроек и данных модуля. Переустановка позволит получить чистую установку модуля. Для переустановки модуля с сохранением настроек и данных, пожалуйста, обратитесь в наш Центр поддержки для оказания такой услуги. 

Для полной переустановки модуля без сохранения данных выполните следующие шаги:

1. Пройдите в раздел Модули → Управление модулями и найдите старый установленный модуль.
2. Нажмите в меню шестеренки модуля кнопку удалить.
3. Скачайте последнюю версию модуля на нашем сайте в разделе "Управление лицензиями".
4. Пройдите в раздел Модули → Управление модулями и в меню шестеренки выберите Ручная установка.
5. Выберите ранее скачанный файл и завершите установку модуля.

Техническая поддержка модуля уже включена в его стоимость. Прежде чем обращаться в центр поддержки, пожалуйста, убедитесь что вы используете последнюю выпущенную версию модуля. Старые версии  модуля не обслуживаются технической поддержкой.

Для того, чтобы воспользоваться нашей технической поддержкой, выполните следующие шаги:

1. На нашем сайте центра поддержки https://helpdesk.cs-commerce.com/ авторизуйтесь под своей учетной записью;
2. Нажмите на кнопку "Новая заявка";
3. Заполните все необходимые поля и создайте заявку (Вы получите на e-mail письмо с подтверждением);
4. Ожидайте ответ специалиста (на ваш e-mail придет уведомление об ответе на вашу заявку) в соответствии с регламентами работы службы техподдержки.

Если Вы не получили ответ в течении сроков, обозначенных в регламентах, напишите нам на e-mail [email protected] сообщение с темой заявки и мы постараемся решить вас вопрос в ближайшее время.

Техническая поддержка по диалогу в чате на сайте, прямым телефонным обращениям или e-mail письмам не осуществляется. Вся помощь проходит через центр поддержки. Внимательно изучайте документацию к модулю и условия технической поддержки перед созданием обращения.

Рекомендуем ознакомиться с общими ограничениями:

1. Фрагменты кода  или некоторые файлы модуля могут иметь закрытую (закодированную) часть. Закодированная часть не создает проблемы в доработке модуля;
2. Модуль будет работать только на тех доменах, которые указаны в лицензии пользователя. При попытке использования решения на установках CS-Cart, домены которых не включены в лицензию, модуль будет автоматически выключен;
3. Установка локально не допускается системой лицензирования. Чтобы модуль работал на дополнительном домене (псевдониме) укажите этот псевдоним на странице управления лицензиями. На один домен допускается указать до трех псевдонимов для нужд тестирования и разработки.
4. Главный домен лицензии вы можете менять самостоятельно на странице управления лицензиями. 

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

Версия 1.0 от 28 сентября 2026 года

• Первый релиз модуля: вход и регистрация через Яндекс ID в один клик, виджет «Мгновенный вход», привязка Яндекс ID в личном кабинете, настройки кнопки и правил создания учётных записей.