/
SetRetail10 ▪️ Касса ◾️ Интеграция с процессингом Кредит Европа Банк (терминалы Ingenico)

Публичное пространство

SetRetail10 ▪️ Касса ◾️ Интеграция с процессингом Кредит Европа Банк (терминалы Ingenico)

https://crystals.atlassian.net/browse/SRTZ-4619

https://crystals.atlassian.net/browse/CR-14339

10.5.0.6 10.5.1.0

Описание

Реализована низкоуровневая интеграция программного обеспечения SetRetail10 с платежными терминалами Ingenico ICT2XXGEMC по протоколу Кредит Европа Банк. Решение поддерживает работу на кассах типов POS, Touch и SCO (v2, v3) под управлением операционных систем TinyCore и Ubuntu. Взаимодействие между кассой и терминалом осуществляется через интерфейсы RS232 (COM) или USB.

Ценность

Интеграция с Кредит Европа Банк расширяет возможности приёма безналичных платежей в SetRetail10 и предоставляет следующие преимущества:

  • дополнительный эквайринг «из коробки» без необходимости использования стороннего ПО;

  • поддержка оплаты банковской картой и оплаты в рассрочку;

  • работа на всех типах касс: POS, SetTouch и SCO v3;

  • поддержка операций возврата и отмены с передачей авторизационных данных исходной транзакции;

  • печать слипов как на встроенном принтере терминала, так и на кассовом фискальном регистраторе;

  • автоматическая сверка итогов при закрытии кассовой смены.

Примеры работы

Оплата банковской картой на POS или SetTouch

  1. Кассир добавляет товары в чек и переходит к расчету.

  2. Кассир выбирает тип оплаты Банковская карта, Кредит Европа Банк.

172.29.19.11_03_07_2026-15_23_25.png

  1. Касса отправляет запрос оплаты на терминал и отображает спиннер с сообщением «Следуйте указаниям на терминале».

  2. Терминал активируется для приёма оплаты.

  3. Покупатель прикладывает, вставляет или проводит банковскую карту.

  4. При необходимости покупатель вводит PIN-код на терминале.

  5. Касса получает успешный статус оплаты.

  6. Касса регистрирует чек.

Оплата банковской картой на SCO v3

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

  2. Покупатель переходит к выбору оплаты.

  3. Выбирает тип оплаты Банковская карта, Кредит Европа Банк.

  4. Касса отправляет запрос оплаты на терминал.

  5. Покупатель прикладывает карту к терминалу.

  6. При необходимости вводит PIN-код.

  7. Касса получает успешный статус оплаты.

  8. Касса регистрирует чек.

Оплата в рассрочку на POS или SetTouch

  1. Кассир добавляет товары в чек и переходит к расчету.

  2. Кассир выбирает тип оплаты Рассрочка по карте, Кредит Европа Банк.

172.29.19.11_03_07_2026-15_23_43.png

  1. Касса отправляет запрос оплаты в рассрочку на терминал и отображает спиннер с сообщением «Следуйте указаниям на терминале».

  2. Покупатель прикладывает карту.

  3. Касса получает успешный статус оплаты.

  4. Касса регистрирует чек.

Примеры сценариев возврата

Возврат на POS или SetTouch

  1. Кассир инициирует возврат по чеку.

  2. Выбирает возврат всего чека или отдельных позиций.

  3. Переходит к оплатам.

  4. Касса отображает сумму к возврату и тип возврата Банковская карта, Кредит Европа Банк.

  5. Кассир подтверждает сумму к возврату.

  6. Касса отправляет запрос возврата на терминал. В запросе передаётся код авторизации исходной транзакции.

  7. Покупатель прикладывает карту для возврата.

  8. Касса получает успешный ответ на возврат.

  9. Касса регистрирует чек возврата.

Возврат чека, оплаченного в рассрочку

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

Примеры отрицательных сценариев

Ошибка соединения / таймаут

  1. Касса инициирует обмен с терминалом.

  2. Нет ответа от терминала в течение заданного таймаута.

  3. Касса выводит сообщение: «Ошибка связи с терминалом».

  4. Транзакция завершается. Кассир закрывает сообщение и возвращается в список оплат.

  5. Кассир повторно выбирает оплату картой или другой способ оплаты.

Ошибка при оплате / возврате / отмене / рассрочке / EOD / Encashment

  1. Касса инициирует обмен с терминалом.

  2. Касса получает ответ с кодом ошибки.

  3. Касса транслирует сообщение об ошибке.

  4. Терминал печатает отказной слип через свой встроенный принтер (например, при нехватке средств, неверном PIN-коде и пр.). В чеке продажи на кассе будет напечатан только текст ошибки.

  5. Транзакция завершается. Кассир закрывает сообщение и возвращается в список оплат.

  6. Кассир выбирает повторно оплату картой или другой способ оплаты.

Ограничения

  1. Интеграция реализуется только для терминалов Ingenico ICT2XXGEMC.

  2. Поддерживаются ОС TinyCore и Ubuntu.

  3. Отмена транзакции возможна:

    • в течение текущей кассовой смены;

    • на том же POS-терминале, где была выполнена исходная транзакция.

  4. Возврат чека оплаты по рассрочке не предусмотрен. Чек возвращается как обычный безналичный возврат без запросов и авторизации банком.

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

  6. Сверка итогов (End-Of-Day) печатается встроенным принтером терминала.

  7. Формат слипов, которые терминал присылает на печать кассе, необходимо настраивать на стороне банка. Если слип передаётся в теле чека, данные могут обрезаться. Рекомендуется настроить передачу слипов отдельными блоками.

  8. На SCO v3 по кнопке «Сверка по банку» в меню Администратора печатается полный отчёт по банку (Encashment), а не сверка итогов (End-Of-Day), в отличие от POS и SetTouch.

Настройка

На сервере

  1. Перейдите в Кассовый модуль → Банки → кликните image2020-5-8_22-32-37.png.

image-20260702-134755.png

  1. Введите название банка (например, Кредит Европа Банк) в поле [Название], из поля [Процессинг] выберите Кредит Европа Банк → кликните ДОБАВИТЬ.

image-20260703-072312.png

Настройка типов оплат в шаблоне кассы

  1. Перейдите в Кассовый модуль → Шаблоны касс → кликните требуемый шаблон.

image-20251112-093510.png

  1. Перейдите на вкладку ПРОЦЕСС ТОРГОВЛИ → НАСТРОЙКИ → в секции Типы оплат установите флажки на необходимых типах оплат → нажмите Сохранить.

    • Оплата банковской картой - для приема оплаты банковской картой;

    • Оплата в рассрочку по карте - для приема оплаты в рассрочку (если требуется). На кассе данный тип оплаты отобразится как Рассрочка по карте, Кредит Европа Банк.

image-20260703-121508.png

  1. Перезагрузите кассовый модуль для применения настроек.

На кассе

До версии SetRetail 10.5.0.6 управление параметрами подключения производится в конфигурационном файле /home/tc/storage/crystal-cash/config/plugins/bank-crediteurope-config.xml.

  • port - порт подключения;

  • baudRate - скорость обмена данными.

Клавиатурная касса

  1. Подключите терминал к кассе.

  2. На кассе перейдите в Конфигуратор → Банки.

image-20260703-085223.png

  1. Выберите Кредит Европа Банк → нажмите Задействовать.

image-20260703-085246.png

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

image-20260703-085409.png

SetTouch

  1. В боковом меню выберите Настройки.

image-20260703-095843.png

  1. Нажмите Банки.

image-20260703-095945.png

  1. Выберите Кредит Европа Банк.

image-20260703-102459.png

  1. Включите использование процессинга → вернитесь на предыдущий экран.

image-20260703-102539.png

  1. Перезагрузите кассовый модуль.

image-20260703-102713.png

 

 

SetSCO v3

  1. В режиме консультанта нажмите Меню консультанта.

image-20250827-072322.png

  1. Перейдите на вкладку Сервис → Конфигуратор → нажмите Настройки SCO.

image-20260703-092711.png

  1. Выберите Оборудование POS → установите флажок image2021-3-24_11-29-30.png Кредит Европа Банк → нажмите Сохранить.

image-20260703-092823.png

  1. Перезагрузите кассовый модуль.

image-20250827-072740.png

 

Печать банковских слипов

https://crystals.atlassian.net/browse/SRTZ-4776

10.5.1.0

В версии 10.5.1.0 добавлена возможность управлять печатью банковских слипов с помощью настройки printSlipsOnEcr:

  • true - печать слипов на фискальном регистраторе;

  • false - печать слипов на терминале.

  1. Откройте на редактирование конфигурационный файл /home/tc/storage/crystal-cash/config/plugins/bank-crediteurope-config.xml.

image-20260702-141226.png

  1. Для печати слипов на терминале задайте значение <property key="printSlipsOnEcr" value="false"/>.

image-20260702-153904.png

  1. Сохраните изменения в файле → перезагрузите кассовый модуль.

Настройка привилегий кассовых пользователей

Для доступа к печати полного отчёта по банку на POS кассиру необходимо предоставить привилегию:

  1. На сервере перейдите в Кассовый модуль → Роли и привилегии → выберите требуемую роль кассира.

  2. Для роли кассового пользователя установите привилегию Меню банковских операций → кликните Добавить к роли → кликните Сохранить.

image-20260706-140454.png

Решение вопроса с печатью слипов на ККТ

Если терминал Кредит Европа Банк виден кассой, обмен с терминалом выполняется и оплата проходит, но банковский слип не печатается на ККТ, проверьте настройки терминала и режим его работы.

Признаки проблемы

  • Касса видит терминал, обмен с терминалом идет, оплата проходит.

  • Слип после успешной оплаты не печатается на ККТ.

  • В логах могут появляться ошибки вида Received NAK from terminal и «Ошибка связи с терминалом».

WARN [CreditEuropeTransport] Communication on load slip and EOT failed ru.crystals.pos.bank.exception.BankCommunicationException: Received NAK from terminal ERROR [BankImpl] Sale failed ru.crystals.pos.bank.exception.BankCommunicationException: Ошибка связи с терминалом

Что проверить и настроить?

  1. На терминале включите печать квитанций на кассе: F → Меню оператора → Печать квитанций → пароль 33333333 → На кассе.

  2. Убедитесь, что терминал не находится в обучающем режиме. Терминалы Кредит Европа Банк могут автоматически переключаться в этот режим. В таком состоянии продажа может не проходить уже с другой ошибкой.

  3. Если обучающий режим включен, попросите клиента обратиться к менеджеру банка для снятия этого режима. Инженеры банка при передаче терминалов могут не предупреждать о его включении.

  4. После изменения настроек перезагрузите терминал: одновременно нажмите желтую кнопку и . либо выполните перезагрузку по питанию.

  5. Повторите оплату и проверьте, что слипы печатаются на ККТ.

Рабочая конфигурация

  • Порт: ttyUSB0.

  • Скорость обмена: 115200.

  • Настройка терминала Печать квитанций: На кассе.

  • Обучающий режим: отключен.

При такой схеме успешные слипы печатаются на ККТ, а сверка итогов печатается на терминале.

 

Статьи по теме