- Store Builder
- Store Builder Ultimate
- Multi-Vendor
- Multi-Vendor Plus
- Multi-Vendor Ultimate
- Вендорам
- Владельцам
- Покупателям
- English
- Русский
- 4.21.X
- 4.20.X
- 4.19.X
- 4.18.X
- 4.17.X
Инструкция к модулю Оплата Яндекс Пэй и Сплит
Что делает модуль
Модуль добавляет платёжный процессор MS: Yandex Pay, создаёт заказы через Yandex Pay API, перенаправляет покупателя на оплату и проверяет результат после его возврата. На витрине модуль может показывать виджеты и бейджи Яндекс Пэй и Сплит.
Где находится модуль
- Настройки модуля: Модули → Скачанные модули → Оплата Яндекс Пэй и Сплит.
- Настройки платёжного метода: раздел способов оплаты CS-Cart, процессор MS: Yandex Pay.
Подготовка данных Яндекса
Получите в кабинете Yandex Pay идентификатор продавца Merchant ID и API-ключ. Отдельного поля Client ID в модуле нет.
- В рабочем режиме для авторизации используется API-ключ.
- В тестовом режиме модуль обращается к sandbox API и использует Merchant ID как ключ в заголовке авторизации.
Настройка модуля
Общие настройки
- Укажите Идентификатор продавца (Merchant ID) для витринных виджетов.
- Сопоставьте результаты Успешно и Неуспешно со статусами заказа CS-Cart. Если значение не выбрано, используются статусы Open и Failed.
- В магазине с несколькими витринами выберите нужную витрину перед сохранением настроек.
Виджет
- Выберите расширенный, компактный вид или отключите виджет в карточке товара.
- Выберите отображаемые методы: карта, Сплит или карта и Сплит.
- При необходимости укажите параметры Yandex Pay Web SDK в поле конфигурации.
- Выберите положение виджета на checkout: не показывать, под итогом заказа или над товарами.
- Выберите вид блока: свёрнутый, развёрнутый или простой.
Бейджи
- Включите бейджи в каталоге и при необходимости второй бейдж.
- Выберите положение: под ценой или под всем блоком товара.
- Укажите конфигурацию основного и дополнительного бейджа. Значения
merchant-id,amountиsku-idмодуль задаёт автоматически и удаляет из сохранённой конфигурации.
Создание способа оплаты
- Создайте новый способ оплаты и выберите процессор MS: Yandex Pay.
- Включите тестовый режим для проверки в sandbox или оставьте его выключенным для рабочего API.
- Укажите Merchant ID и API-ключ.
- Выберите доступные методы: Яндекс Пэй и Яндекс Сплит, только Яндекс Пэй или только Яндекс Сплит.
- При необходимости включите виджет внутри способа оплаты на странице оформления заказа.
- Сохраните способ оплаты и проверьте его доступность для нужной витрины и способов доставки.
Как проходит оплата
- Модуль отправляет в Яндекс сумму, валюту, товары, доставку, покупаемые подарочные сертификаты и доступные методы оплаты.
- В качестве контакта для фискализации передаётся корректный e-mail, а при его отсутствии — нормализованный телефон. Если контакта нет, поле не отправляется.
- Покупатель переходит по ссылке
paymentUrlна платёжную страницу. - После возврата модуль запрашивает заказ у Яндекса и сверяет номер заказа, Merchant ID, валюту и сумму.
- Статус успешной оплаты назначается только для состояния
CAPTURED; состоянияFAILEDиVOIDEDсчитаются неуспешными. При промежуточном или неподтверждённом результате статус не меняется.
Ограничения текущей версии
- Отдельной настройки server-to-server webhook URL нет: используются возвратные URL CS-Cart.
- Нет отдельного интерфейса для hold/capture и возвратов.
- Модуль передаёт контакт для фискализации, но не содержит собственных настроек DigitalKassa, ставок НДС и формирования чеков.
Как проверить работу
- Включите тестовый режим и заполните параметры способа оплаты.
- Откройте карточку товара и каталог: проверьте виджет, положение бейджей и вывод второго бейджа.
- Добавьте товар в корзину и проверьте положение и вид блока на checkout.
- Выберите способ оплаты и убедитесь, что доступны настроенные варианты: Пэй, Сплит или оба.
- Оформите тестовый заказ и проверьте переход на платёжную страницу Яндекса.
- После возврата проверьте платёжный статус и итоговый статус заказа в панели администратора.
- Для проверки контакта оформите заказ с e-mail, затем без e-mail, но с телефоном.
История изменений
v1.6.7 от 28.09.2026
[*] Обновлены код, шаблоны и интеграционные файлы модуля.
[*] Обновлены описание, инструкция и changelog модуля.
v1.6.6 от 2026-09-14
[!] Исправлено:.
[*] Служебные файлы тестирования исключены из пакета обновления и больше не вызывают ошибку о попытке обновить основные файлы CS-Cart.
v1.6.5 от 2026-09-11
[!] Исправлено:.
[*] Покупаемые подарочные сертификаты передаются отдельными позициями, в том числе в заказах без обычных товаров.
[!] Исправлена сверка товаров, сертификатов и доставки при скидке на заказ.
[*] Позиции с дробной копейкой после распределения скидки разделяются на строки с сохранением количества и итоговой суммы.
[*] Устранён повторный вывод бейджей в сетке товаров Nova с учётом выбранного размещения и второго бейджа.
[*] Разные варианты одного товара передаются с уникальными идентификаторами позиций.
[*] Перед изменением статуса модуль проверяет оплату через Yandex Pay API и сверяет заказ, продавца, валюту и сумму.
[!] Исправлены выбор настроек компании и витрины, сохранение выключенных переключателей и обработка конфигурации бейджей и виджетов.
[!] Исправлены положение и повторная инициализация виджета после пересчёта корзины и раскрытия скрытого блока.
[*] Модуль актуализирован по шаблону: исправлены встроенная история изменений и резервное отображение версии, дополнены переводы.
[*] В релиз включены русские и английские описание и инструкция с сохранением истории изменений.
v1.6.1 от 2026-06-19
[!] Исправлено:.
[*] Исправлено поведение виджета после AJAX-изменения количества товара.
[*] Виджет под итоговой стоимостью больше не перемещается после пересчёта корзины.
[!] Исправлена повторная инициализация виджета в сворачиваемом скрытом блоке.
[*] Повторная инициализация при раскрытии блока выполняется только для пустого контейнера.
[*] Уточнена схема обновления статуса через возвратные URL CS-Cart без отдельного server-to-server webhook.
v1.6.0 от 2026-04-30
[+] Добавлено:.
[*] Передача контакта покупателя для фискализации при создании платежа.
[*] Если в заказе нет e-mail, для фискализации используется телефон покупателя.
[*] Актуализировано встроенное описание модуля.
[!] Исправлено:.
[*] Уточнена логика выбора контактных данных покупателя из заказа.
v1.5.1 от 2026-03-17
[*] Настройки модуля надёжнее определяются на витрине при работе с несколькими storefront.
[!] Исправлено:.
[!] Исправлено сохранение сопоставления статусов оплаты.
[*] При обработке результата оплаты настройки выбираются по компании заказа.
v1.5.0 от 2026-03-04
[+] Добавлено:.
[*] Настройка отображения виджета на странице оформления заказа.
[*] Свёрнутый, развёрнутый и простой виды блока в checkout.
[*] Сворачиваемый блок виджета с заголовком и анимацией.
[*] Отображение бейджей на страницах, в блоге и акциях.
[*] Модуль обновлён по актуальному шаблону.
[*] Вывод виджета на checkout вынесен в отдельный блок.
[*] Документация перенесена в HTML-файлы раздела info.
v1.4.0 от 2026-01-19
[+] Добавлено:.
[*] Отображение лейбла в блоках интеллектуального подбора AB.
[!] Исправлено:.
[!] Исправлено поведение блоков способа оплаты на странице оформления заказа.
v1.3.1 от 2025-12-12
[!] Исправлено:.
[!] Исправлено создание заказа из панели администратора.
v1.3.0 от 2025-12-09
[+] Добавлено:.
[*] Настройка внешнего вида виджетов и бейджей.
[*] Выбор позиции бейджа.
[*] Поддержка темы CS-Cart Nova.
[*] Модуль приведён к стандартам проекта.
[*] Обновлён внешний вид виджета с возможностью использовать прежний вариант.
[*] Оптимизирован вывод виджета на странице оформления заказа.
[!] Исправлено:.
[!] Исправлены настройки в тёмной теме и выравнивание бейджа.
v1.2.2 от 2025-11-10
[*] Обновлены стили виджета.
[*] Платёжная сессия переведена в рабочий режим.
[!] Исправлено:.
[*] Устранено дублирование виджета, когда во вкладках товара выводятся товары.
v1.2.1 от 2025-11-03
[+] Добавлено:.
[+] Возможность скрывать виджет на странице оформления заказа.
[*] Изменены положение, размеры и нижний отступ виджета.
[-] Удалена лишняя кнопка оформления заказа на странице корзины.
[!] Исправлено:.
[!] Исправлено дублирование виджета во всплывающем окне.
[!] Исправлен вывод виджета при смене способа оплаты.
[!] Исправлен вывод виджета Сплита при выборе оплаты картой через Яндекс.
v1.2.0 от 2025-10-30
[+] Добавлено:.
[*] Выбор виджета в карточке товара.
[*] Отображение виджета на странице оформления заказа.
v1.1.1 от 2025-07-30
[*] Модуль приведён к стандартам проекта.
v1.1.0 от 2023-11-06
[+] Добавлено:.
[*] Вывод виджета Яндекс Сплит.
v1.0.2 от 2023-10-28
[!] Исправлено:.
[!] Исправлено определение API-ключа для рабочего режима.
v1.0.1 от 2023-10-28
[+] Добавлено:.
[*] Английские переводы.
[!] Исправлено:.
[!] Исправлено определение API URL.
v1.0.0 от 2023-10-16
[+] Добавлено:.
[*] Первый релиз модуля.
Обозначения:
[+] Добавлено
[-] Удалено
[*] Изменено
[!] Исправлена ошибка
Здесь можно поделиться своим мнением и оценить нашу работу.
Ваши отзывы помогают нам стать лучше и предлагать вам еще более качественный сервис.