Инструкция к модулю Платежи Joys Digital

Что делает модуль

Модуль добавляет в CS-Cart способ оплаты Joys Digital. Он создает платеж для заказа, отправляет покупателя на страницу оплаты, принимает уведомление о результате и записывает данные транзакции в заказ.

Модуль работает с одностадийной оплатой. Настроек hold/capture, двухшаговой оплаты и отдельного API token в интерфейсе нет: для подключения используются ID POS-терминала и RSA-ключи. Тестовый режим отдельной настройкой не включается — параметры и доступы задаются на стороне Joys Digital.

Где находится модуль

• Карточка модуля: Модули → Управление модулями → Платежи Joys Digital.
• Настройка платежного способа: Администрирование → Способы оплаты, затем способ оплаты с процессором Joys Digital.
• Действия с транзакцией: карточка заказа в админ-панели.

Что подготовить в Joys Digital

1. Получите или создайте POS-терминал в кабинете Joys Digital.
2. Скопируйте ID POS-терминала — он указывается в поле ID POS терминала.
3. Подготовьте RSA-ключи. Пару ключей можно сгенерировать в настройках способа оплаты CS-Cart.
4. Добавьте публичный RSA-ключ магазина в кабинете Joys Digital. Закрытый ключ остается в CS-Cart.
5. Скопируйте callback URL из настроек способа оплаты и укажите его в Joys Digital как адрес POST-уведомлений о статусе платежа.
6. Если в Joys Digital используется фискализация или 54-ФЗ, настройте ее в кабинете платежного сервиса. Модуль передает состав заказа в запросе оплаты, но не добавляет отдельные настройки чеков, DigitalKassa или 54-ФЗ в CS-Cart.

Как настроить способ оплаты

1. Откройте Администрирование → Способы оплаты.
2. Создайте новый способ оплаты или откройте существующий.
3. В поле процессора выберите Joys Digital.
4. В поле ID POS терминала укажите идентификатор терминала из Joys Digital.
5. Если ключей еще нет, нажмите Сгенерировать ключи.
6. Скопируйте показанный публичный ключ и добавьте его в кабинете Joys Digital.
7. Проверьте поле Закрытый ключ. Закрытый ключ нужен для подписи запросов и не должен передаваться покупателям или публиковаться.
8. Скопируйте Ссылку POST-запроса для передачи статуса платежа и укажите ее в настройках уведомлений Joys Digital.
9. При необходимости используйте Ссылку на файл CSS для страницы оплаты, если Joys Digital позволяет подключить внешний стиль страницы оплаты.
10. Проверьте Ссылку на страницу магазина для возврата со страницы статуса платежа.
11. Выберите статусы заказа для успешной оплаты, ошибки оплаты и возврата средств.
12. Сохраните способ оплаты и убедитесь, что он доступен нужным витринам, группам пользователей и способам доставки.

Как проходит оплата

1. Покупатель выбирает Joys Digital при оформлении заказа.
2. Модуль формирует запрос с POS-терминалом, уникальным номером платежа, суммой заказа и составом корзины.
3. Запрос подписывается закрытым RSA-ключом и отправляется в Joys Digital.
4. Если Joys Digital возвращает ссылку на оплату, покупатель перенаправляется на платежную страницу сервиса.
5. После оплаты Joys Digital отправляет POST-уведомление на callback URL магазина.
6. Если в уведомлении передан признак Paid = true, заказ получает статус успешной оплаты. В остальных случаях применяется статус ошибки.
7. В платежную информацию заказа записываются внутренний номер платежа Joys Digital и внешний ID транзакции.

Возвраты и обновление статуса

Если заказ успешно оплачен, в нем сохранен внешний ID транзакции и текущий статус совпадает со статусом успешной оплаты, в карточке заказа появляется действие Оформить возврат средств. Возврат отправляется в Joys Digital на сумму заказа. При успешном ответе с признаками Paid = true и Processed = true заказ переводится в статус, выбранный для возврата средств.

Если у заказа есть номер платежа, но текущий статус еще не соответствует статусу успешной оплаты, в карточке заказа появляется действие Обновить статус платежа. Модуль запрашивает актуальное состояние транзакции в Joys Digital и меняет статус заказа по результату ответа.

Как проверить работу

1. Создайте тестовый заказ на витрине и выберите оплату Joys Digital.
2. Проверьте, что после подтверждения заказа покупатель перенаправляется на страницу оплаты Joys Digital.
3. Завершите оплату на стороне Joys Digital.
4. Откройте заказ в админ-панели и проверьте статус заказа.
5. Проверьте платежную информацию заказа: должны появиться номер платежа и ID транзакции Joys Digital.
6. Если автоматическое уведомление не пришло, используйте действие обновления статуса платежа в карточке заказа.
7. Для проверки возврата убедитесь, что возвраты разрешены в Joys Digital, затем выполните действие возврата из карточки заказа.

Типовые проблемы

• Покупатель не попадает на страницу оплаты. Проверьте ID POS-терминала, закрытый RSA-ключ и доступность Joys Digital.
• Joys Digital сообщает об ошибке подписи. Сверьте закрытый ключ в CS-Cart и публичный ключ в кабинете Joys Digital.
• Статус заказа не обновляется. Проверьте callback URL в Joys Digital и доступность витрины извне.
• Возврат не выполняется. Проверьте, что у заказа есть ID транзакции Joys Digital и что возвраты разрешены для терминала.
• Нужны чеки или 54-ФЗ. Настройте фискализацию на стороне Joys Digital: отдельного блока настроек чеков в модуле нет.