Платежи Joys Digital
Этот модуль входит в нашу Подписку.
Оформите подписку — и пользуйтесь всеми модулями без ограничений.
Модуль добавляет в CS-Cart платёжный способ Joys Digital. Покупатель оплачивает заказ на стороне платёжного сервиса, а магазин получает результат оплаты и обновляет заказ в админ-панели.
Решение подходит магазинам, которым нужен отдельный платёжный шлюз с настройкой POS-терминала, RSA-ключей, статусов заказа, проверки транзакции и возврата средств.
Для чего нужен
Модуль помогает подключить Joys Digital как платёжный процессор без правок ядра CS-Cart. Администратор настраивает способ оплаты один раз, после чего покупатели могут выбирать его при оформлении заказа.
Основные возможности
- Добавляет платёжный процессор Joys Digital в список способов оплаты CS-Cart.
- Позволяет указать ID POS-терминала и закрытый RSA-ключ.
- Показывает callback URL для передачи статуса платежа из Joys Digital.
- Показывает URL CSS-файла для оформления страницы оплаты.
- Позволяет выбрать статусы заказа для успешной оплаты, ошибки и возврата.
- Создаёт платёж и перенаправляет покупателя на страницу оплаты Joys Digital.
- Принимает уведомление о результате оплаты и обновляет заказ.
- Сохраняет внешний ID транзакции в платежной информации заказа.
- Добавляет в карточку заказа действия для обновления статуса транзакции и оформления возврата.
- Позволяет сгенерировать пару RSA-ключей прямо в настройках способа оплаты.
Как работает
Администратор создаёт способ оплаты Joys Digital и заполняет данные терминала. В настройках можно сгенерировать RSA-ключи: закрытый ключ сохраняется в CS-Cart, а публичный ключ нужно передать или указать в кабинете Joys Digital.
Во время оформления заказа модуль отправляет в Joys Digital сумму, номер заказа и состав корзины. Если платёжный сервис возвращает ссылку на оплату, покупатель переходит на страницу Joys Digital и завершает оплату там.
После оплаты Joys Digital отправляет уведомление в магазин. Модуль проверяет заказ, записывает данные транзакции и переводит заказ в настроенный статус. Если оплата не прошла, заказ получает статус ошибки.
В карточке заказа администратор может запросить актуальный статус транзакции или оформить возврат, если платёж уже был успешно обработан.
Остались вопросы по работе модуля?
- Русский
- 4.18.X
Инструкция к модулю Платежи Joys Digital
Что делает модуль
Модуль добавляет в CS-Cart способ оплаты Joys Digital. Он создаёт платёж для заказа, отправляет покупателя на страницу оплаты, принимает уведомление о результате и записывает данные транзакции в заказ.
Модуль работает с одностадийной оплатой. Настроек hold/capture и отдельного API token в модуле нет: для подключения используются ID POS-терминала и RSA-ключи.
Где находится модуль
- Карточка модуля: Модули → Управление модулями → Платежи Joys Digital.
- Настройка платежа: Администрирование → Способы оплаты, затем создание или редактирование способа оплаты с процессором Joys Digital.
- Действия с транзакцией: карточка заказа в админ-панели.
Что подготовить в Joys Digital
- Создайте или получите POS-терминал в кабинете Joys Digital.
- Уточните ID POS-терминала. Он понадобится в поле ID POS терминала.
- Добавьте в Joys Digital публичный RSA-ключ магазина. Его можно сгенерировать в настройках способа оплаты.
- Скопируйте callback URL из настроек способа оплаты и укажите его в Joys Digital как адрес для уведомлений о статусе платежа.
- Если в Joys Digital подключена фискализация или 54-ФЗ, настройте её в кабинете платёжного сервиса. Модуль передаёт состав заказа в запросе оплаты, но отдельной настройки фискализации в CS-Cart не добавляет.
Как настроить способ оплаты
- Откройте Администрирование → Способы оплаты.
- Создайте новый способ оплаты или откройте существующий.
- В поле процессора выберите Joys Digital.
- Введите ID POS терминала, полученный в Joys Digital.
- Нажмите Сгенерировать ключи, если у вас ещё нет пары RSA-ключей.
- Скопируйте публичный ключ из появившегося окна и добавьте его в кабинете Joys Digital.
- Проверьте, что закрытый ключ появился в поле Закрытый ключ. Его не нужно передавать покупателям или публиковать.
- Скопируйте Ссылку POST-запроса для передачи статуса платежа и укажите её в настройках уведомлений Joys Digital.
- Проверьте Ссылку на файл CSS для страницы оплаты. Её можно использовать в Joys Digital, если сервис позволяет подключить внешний стиль страницы оплаты.
- Выберите статусы заказа для успешной оплаты, ошибки и возврата.
- Сохраните способ оплаты и убедитесь, что он активен для нужной витрины и групп пользователей.
Как проверить работу
- Оформите тестовый заказ на витрине и выберите оплату Joys Digital.
- После подтверждения заказа магазин должен перенаправить покупателя на страницу оплаты Joys Digital.
- Завершите тестовую оплату на стороне Joys Digital.
- Вернитесь в админ-панель и откройте заказ.
- Проверьте, что заказ получил статус, выбранный для успешной оплаты.
- Проверьте платежную информацию заказа: в ней должен появиться ID транзакции Joys Digital.
- Если статус не обновился автоматически, нажмите действие обновления статуса платежа в карточке заказа.
Возвраты
Если заказ был успешно оплачен и в нём сохранён внешний ID транзакции, в карточке заказа появляется действие для оформления возврата. После успешного возврата модуль переводит заказ в статус, выбранный в настройке Статус заказа при возврате средств.
Перед проверкой возврата убедитесь, что возвраты разрешены и настроены в кабинете Joys Digital для вашего терминала.
Типовые проблемы
- Покупатель не попадает на страницу оплаты. Проверьте ID POS-терминала, закрытый ключ и доступность Joys Digital.
- Joys Digital сообщает об ошибке подписи. Сверьте закрытый ключ в CS-Cart и публичный ключ в кабинете Joys Digital.
- Статус заказа не обновляется. Проверьте callback URL в Joys Digital и доступность витрины извне.
- Возврат не выполняется. Проверьте, что у заказа есть ID транзакции Joys Digital и что возвраты разрешены для терминала.
- Нужна фискализация. Проверьте настройки чеков и 54-ФЗ на стороне Joys Digital.
История изменений
v1.3.0
13.05.2026
Изменения и доработки:
- Модуль обновлён по актуальным правилам оформления и проверки.
- Добавлены полноценные описание, инструкция и история изменений на русском и английском языках.
- Название модуля приведено к чистому виду, устаревшие файлы удалены.
v1.2.6
02.07.2021
Изменения и доработки:
- Добавлена проверка ссылки на оплату перед перенаправлением покупателя.
- Улучшена обработка ситуации, когда Joys Digital не возвращает ссылку на оплату.
- Исправлена генерация ключей при настройке нескольких способов оплаты.
- Добавлено уведомление, если магазин не может отправить запрос в Joys Digital.
v1.2.5
05.06.2021
Изменения и доработки:
- Исправлено формирование подписи для запроса актуального статуса транзакции.
- Платёжная информация заказа сохраняется до перенаправления покупателя на страницу оплаты.
- При ручном обновлении статуса транзакции добавлено уведомление об изменении статуса заказа.
- Уточнено условие показа действия обновления статуса платежа в карточке заказа.
- Восстановлено логирование ошибочных callback-уведомлений от Joys Digital.
v1.2.3
18.05.2021
Изменения и доработки:
- Доработана разметка окна с публичным RSA-ключом в настройках способа оплаты.
- Выполнена техническая очистка шаблонов карточки заказа и настроек процессора.
v1.2.2
22.04.2021
Исправления:
- Исправлен порядок параметров в подписанном URL для запроса статуса транзакции.
v1.2.1
22.04.2021
Новые возможности и улучшения:
- Добавлен запрос актуального статуса транзакции Joys Digital из карточки заказа.
- Добавлена обработка ответа Joys Digital при ручном обновлении статуса платежа.
- При неуспешном создании платежа сохраняется платёжная информация заказа.
- Уточнено хранение внутреннего идентификатора транзакции для последующих действий с платежом.
v1.1.6
06.04.2021
Исправления:
- Исправлено формирование ссылок на магазин и CSS-файл страницы оплаты с учётом текущего домена витрины.
- Действие возврата теперь показывается только для оплаченных заказов с сохранённым внешним ID транзакции.
v1.1.5
05.04.2021
Новые возможности и улучшения:
- Добавлена отправка запроса возврата средств в Joys Digital.
- Возврат использует настройки именно того способа оплаты, которым был оплачен заказ.
- Перенаправление покупателя на страницу оплаты переведено на HTTP Location.
- Если ссылка на оплату не получена, заказ переводится в статус ошибки.
- Исправлено отображение ссылки на CSS-файл и текст уведомления об оформленном возврате.
v1.1.0
24.03.2021
Новые возможности и улучшения:
- Добавлены настраиваемые статусы заказа для успешной оплаты, ошибки оплаты и возврата средств.
- Добавлена подготовка RSA-ключа перед подписью запросов.
- В платёжную информацию заказа сохраняется внешний ID транзакции Joys Digital.
- Добавлены первые действия возврата средств из карточки заказа.
- Добавлены языковые переменные для статусов, возврата и платёжной информации.
v1.0.5
21.03.2021
Новые возможности и улучшения:
- Расширены настройки способа оплаты: callback URL, ссылка на магазин, ссылка на CSS-файл, статусы заказа и закрытый RSA-ключ.
- Добавлена генерация пары RSA-ключей из настроек способа оплаты.
- Callback-уведомления Joys Digital теперь проходят проверку платежного скрипта заказа.
- Результат оплаты сохраняется через стандартные механизмы CS-Cart: завершение платежа, платёжная информация и статус заказа.
- Добавлены понятные сообщения об ошибках API Joys Digital по HTTP-кодам.
- Удалён временный файл с тестовыми логами платежей.
v1.0.2
02.03.2021
Изменения и доработки:
- Запрос создания платежа переведён на API Joys Digital с JSON-телом и подписью RSA.
- В запрос оплаты добавлена корзина заказа: название, цена и ID товара.
- Добавлена уникальная последовательность платежа на основе номера заказа.
- Callback-обработка ограничена уведомлениями платежного процессора Joys Digital.
- Удалены неиспользуемые контроллеры и скрытые поля настроек.
v1.0.1
07.08.2023
Служебное обновление:
- Добавлена стандартная интеграция с центром обновлений Make Shop.
- Добавлены служебные файлы проверки лицензии и конфигурации модуля.
- Обновлена иконка модуля в админ-панели.
- Добавлен краткий markdown-changelog старого формата.
v1.0.0
02.03.2021
Новые возможности и улучшения:
- Первый выпуск модуля.
- Добавлен платёжный процессор Joys Digital для CS-Cart.
- Добавлена настройка POS-терминала и RSA-ключа.
- Добавлено создание платежа, перенаправление покупателя на страницу оплаты и обработка уведомления о результате платежа.
Здесь можно поделиться своим мнением и оценить нашу работу.
Ваши отзывы помогают нам стать лучше и предлагать вам еще более качественный сервис.