Поставка и установка

Модуль представляет собой плагин.
Версия кассового обеспечения должна быть не ниже 10.2.91.0

Для того чтобы получить плагин, обратитесь к вашему аккаунт-менеджеру Кристалл Сервис, или оставьте Заявку на плагин Joys Digital на сайте - https://www.crystals.ru/support

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

Настройка на сервере

  1. Положите JoysPaymentPlugin-1.0.2.jar в /var/lib/jboss/plugins

  2. В визуализации сервера перейдите в Настройки - Внешние системы - Добавить оператора - Платежные системы, выберите Платежную систему Joys

3. При необходимости измените параметры по умолчанию.

Значение URL Процессинга должно быть https://api.v3.joys.digital

Минимальная сумма платежа - укажите минимальную сумму платежа, которую возможно будет оплатить через Платежный сервис Joys Digital.
Максимальная сумма платежа - укажите максимальную сумму платежа, которую возможно будет оплатить через Платежный сервис Joys Digilal. Например, максимально возможная сумма чека в вашем магазине.
Если значения Минимальная сумма платежа и Максимальная сумма платежа не будут заполнены, то минимальным пределом будет считаться 0,01 рубль, максимальный предел - не задан.
В случае же, когда сумма платежа на кассе будет выходить за указанные допустимые пределы, в интерфейсе кассира сумма платежа будет автоматически скорректирована в сторону допустимой.

Алиас хранилища ключей / Alias, Пароль хранилища ключей / storepass,

Путь к хранилищу ключей / keystore - заданные значения используются для генерации ключей.

4. В меню Кассовый модуль - Шаблоны кассы в шаблоне кассы включите тип оплаты "Оплата Joys Digital"

Настройка на кассе

  1. Положите JoysPaymentPlugin-1.0.2.jar в crystal-cash/plugins

  2. Подключитесь по SSH и сгенерируйте ключи с помощью команды (параметры alias, storepass и keystore должны совпадать с соответствующими значениями, указанными при настройке на сервере)

/usr/local/jre/bin/keytool -genkeypair -alias joyskey -storepass 654321 -keyalg RSA - keystore /home/tc/storage/crystal-cash/certs/joyskeystore.p12 -keysize 2048 -dname "cn=none, ou=none, o=Crystals, c=RU" -storetype pkcs12

3. При первой оплате выполняется активация - будет запрошен номер терминала и код активации.

Номер терминала и код активации предоставляются при регистрации юридического лица в платежном сервисе Joys Digital.

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

В случае неверно указанного номера терминала или кода активации к нему касса отражает соответствующее уведомление. При успешной активации касса отражает следующее уведомление

Логирование операций

Касса осуществляет логирование операций, осуществляемых ею с платежным сервисом Joys Digital.
Лог расположен на кассе, в директории crystal-cash/logs, файл plugins.log
Логи кассы "подрезаются" автоматически для оптимизации занимаемого места на кассовой станции.

Прием платежа на кассе

Для того чтобы принять платеж через Joys Digital на кассе, необходимо в типе оплат выбрать "Оплата Joys Digital"

Сканером на кассе отсканировать QR кошелька, который покупатель предъявляет на экране мобильного телефона в приложении Joys Wallet.

В том случае, если платеж проведен, касса печатает кассовый чек, на котором оплата Joys Digital согласно ФЗ-54 отражена как безналичный платеж, а также отражена информация о том, что с кошелька покупателя успешно списана сумма в эквиваленте рубль. Какой бы кошелек ни предъявил покупатель: BTC, ETH, JOYS и т.д, касса через Joys Digital получает только рубль.

Комбинированный платеж

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

Покупатель может предъявить к оплате последовательно разные кошельки Joys Wallet. В таком случае касса рассматривает каждый кошелек как независимый тип оплаты. В чеке все платежи, проведенные через Joys Digital, отражаются как платежи, проведенные безналичными.

Отмена платежа на кассе

Отмена или аннулирование платежа на кассе возможно только на той же кассе, на которой был проведен платеж. Например, покупатель проводит комбинированную оплату, и ему необходимо отменить часть уже совершенного платежа. Или когда покупатель по каким-то субъективно-объективным причинам отказался от уже совершенной оплаченной покупки.

В таком случае на кассе осуществляется аннулирование или отмена платежа.

Во всех остальных случаях возврат средств осуществляется через возврат платежа.

Касса печатает чек аннулирования.

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

Возврат платежа

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

Возврат может быть проведен как до закрытия кассовой смены, так и после.

Возврат может быть полным или частичным. Для осуществления возврата кассир находит документ продажи по номеру чеку, предъявленному покупателем.

Далее кассир определяет, каким будет возврат: будет возвращена вся сумма или будет проведен возврат отдельных товарных позиций.

Тип оплаты ни коим образом не связан с товарной позицией. При любом типе возврата средства возвращаются в соответствии с типами оплат платежа.

Стандартные ошибки и как с ними работать

Предъявлен не кошелек или кошелек невалиден

Пользователь для оплаты предъявляет QR кож своего кошелька. Кассир сканирует QR код сканером, имеющимся на кассе, и реагирует на сообщения кассы.

Если предъявленный QR код не был "узнан" платежным сервисом Joys Digital, то кассир увидит следующее уведомление

В таком случае рекомендуем кассиру попросить покупателя показать QR код снова. Покупателю же следует помимо прочего проверить наличие среди кошельков Joys Wallet рублевого кошелька.

Недостаточно средств для проведения платежа

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

Вы можете повторить попытку или отказаться от проведения операции, или аннулировать операцию.

Если запрос к процессингу выполняется продолжительное время, дождитесь окончания процесса, далее в зависимости от сообщения или повторите попытку, или измените тип оплаты.

Если операции в ПС Joys завершаются ошибкой, обратитесь к сервисному инженеру, операцию, которую вы пытались выполнить на кассе следует отменить. В случае ошибки на проведении возврата, аннулируйте чек возврата.

Блокировка операций по терминалу

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

Если терминал на кассе заблокирован, то проведение платежей невозможно. Сообщение в интерфейсе кассира приведено ниже.

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

Контакты службы сопровождения Joys Digital

Если у вас возникли вопросы по работе с платежным сервисом Joys Digital на кассах Кристалл Сервис, то вы можете обратиться в службу сопровождения Joys Digital по e-mail support@joys.digital или написать нам в чат на сайте https://joys.digital/ru/

Полезные ссылки

Платеж Joys Digital в отчетности

Вы нашли ответ?