Интеграция с кассовой программой Кристалл
Бесплатный модуль
Модуль позволяет оплачивать покупки при помощи Яндекс Пэй и Сплит в кассовой программе Кристалл. Модуль предоставляется партнером CSI бесплатно.
Возможности модуля
Полный возврат |
|
Частичный возврат |
|
Частичный возврат по одной позиции |
|
Получение ссылки на оплату |
|
Получение прямого QR |
|
Получение обратного QR |
|
Настройка приложения
Настройка на сервере
-
На сервере SetRetail/SetCentrum перейдите в раздел Интеграция → Внешние процессинги → нажмите +.
-
В строке поиска введите
яндекс
→ нажмите Платежные системы → в правую секцию поиска введитеяндекс
→ установите опцию Яндекс Пэй и Сплит → нажмите Сохранить. -
Перейдите в процессинг Яндекс Пэй и Сплит → Общие и укажите настройки.
Параметр
Описание
Адрес подключения
Укажите URL API Яндекс Пэй:
- для тестового подключения —
https://sandbox.pay.yandex.ru/api/merchant/v1
; - для рабочего подключения —
https://pay.yandex.ru/api/merchant/v1
.
API-ключ
Укажите значение из личного кабинета Яндекс Пэй:
- для тестового подключения — Merchant ID магазина;
- для рабочего подключения — API-ключ.
Доступна оплата Яндекс Пэй
Выберите один или оба способа оплаты.
Доступна оплата в Сплит
Время жизни заказа (в секундах)
Укажите время, за которое покупатель должен успеть подтвердить оплату. При превышении указанного времени процесс оплаты потребуется запустить заново.
Доступный диапазон значений: от
180
до604 800
секунд.ID товара
Идентификатор / артикул товара, который передается в запросе на оплату вместо всех позиций чека. Стоимость товара будет равна сумме чека.
Максимальное количество символов — 2 048.
Наименование товара
Универсальное наименование товара, которое передается в запросе на оплату.
Максимальное количество символов — 2 048.
Таймаут соединения (сек)
Время соединения с сервисом при попытке оплаты. По умолчанию —
3
секунды.Таймаут ожидания ответа (сек)
Время ожидания ответа от сервиса после инициализации оплаты. По умолчанию —
10
секунд.Количество попыток для запроса
Количество попыток отправки запросов на создание платежа. По умолчанию —
5
.При необходимости на вкладке Яндекс Пэй и Сплит укажите дополнительные настройки.
- для тестового подключения —
-
Нажмите кнопку Сохранить.
-
Перейдите в Кассовый модуль → Шаблоны касс → нажмите на нужный шаблон.
-
Перейдите на вкладку Процесс торговли → Настройки.
-
В секции Типы оплат включите опцию Портал поддержки продуктов Яндекс Пэй и Сплит и нажмите кнопку Сохранить.
-
Для настройки кнопки быстрой оплаты на кассе SetTouch подключитесь к базе данных на сервере SetRetail/SetCentrum с помощью PgAdmin или SetConsole.
Вставьте соответствующий тип оплаты для кассы SetTouch в соответствии с логикой ранжирования типов оплат. Скачать пример скрипта.
-
После выполнения скрипта перезагрузите кассовый модуль.
Настройка на кассе
Клавиатурная касса
-
В конфигураторе войдите во Внешние процессинги.
Скриншот
-
Проверьте, что процессинг Яндекс Пэй и Сплит в статусе используется.
Скриншот
SetTouch
-
Откройте файл
/home/tc/storage/crystal-cash/config/modules/payments-config.xml
.Скриншот
-
Проверьте, что в списке есть тип оплаты
yandex.pay.payment.plugin
.Скриншот
-
В настройках кассы войдите во Внешние системы.
Скриншот
-
Проверьте, что сервис Яндекс Пэй и Сплит активирован.
Скриншот
CSI K
-
Перейдите в Меню → Конфигуратор.
Скриншот
-
Выберите Внешние процессинги.
Скриншот
-
Проверьте, что процессинг Яндекс Пэй и Сплит в статусе не используется.
Скриншот
Тестирование оплаты
Важно
После тестирования замените тестовые адрес подключения и API-ключ на рабочие.
-
Добавьте товары в чек и перейдите к расчету.
Скриншот
-
Выберите способ оплаты Яндекс Пэй и Сплит.
Скриншот
-
Отсканируйте QR-код с экрана покупателя.
После подтверждения оплаты покупателем в приложении касса зарегистрирует чек.
Подробную инструкцию смотрите в пользовательской документации партнера.
Бухгалтерская отчетность
После подключения модуля Кристалл в бухгалтерскую отчетность автоматически передаются данные из системных полей кассы:
- код торговой точки
branchId
(<номер магазина>_<номер кассы>
); - код пользователя
managerId
(табельный номер кассира).
Подробнее про бухгалтерскую отчетность читайте в разделе Отчетность к закрывающим документам (бухгалтерская отчетность).