Описание

Плагин предназначен для подключения терминалов Halyk PAX в кассовую программу SetRetail10 для осуществления приема оплаты по банковским картам и приема QR-платежей Halyk.

Файл плагина включен в дистрибутив, начиная с версии 10.4.22.0.

Убедитесь, что время простоя кассы до блокировки экрана составляет не менее 240 секунд.

Настройки

Сервер

1. На сервере SetCentrum перейдите в Интеграция → Внешние процессинги → кликните .

2. В поиске наберите baka → кликните Платежные системы → наберите baka → установите Bakai Pay → кликните .

3. Кликните по процессингу Bakai Pay.

4. На вкладке общие установите номера магазинов, затем параметры нахождения конфигурационного файла на кассе:

Путь до файла конфигурации (Linux) - /home/tc/storage/crystal-cash/banks/bakai/config.json
Путь до файла конфигурации (Windows) - c:/.../crystal-cash/banks/bakai/config.json

5. Установите параметры на вкладке BAKAI QR И ДРУГИЕ КАРТЫ БАНКОВ → кликните .

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

7. ПРОЦЕСС ТОРГОВЛИ → НАСТРОЙКИ → Типы оплат → установите флажок Bakai QR и другие карты банков → кликните .

Касса

1. На кассе создайте папку процессинга:

sudo mkdir /home/tc/storage/crystal-cash/banks/bakai

2. Скачайте файл конфигурации и скопируйте его в папку с процессингом:

Описание параметров config.json

Параметр	Значение	Описание

Параметр	Значение	Описание
ownCheque	false	При установке значения true происходит печать слип-чека на принтере банковского терминала.
showSumEnterForm	false	При установке значения true, после выбора типа оплаты, будет возможность указать сумму оплаты выбранного типа. Используется для частичной оплаты чека.
ip	"http://ХХ.ХХ.ХХ.ХХ:8080"	Указывается IP-адрес банковского терминала в локальной сети.
readTimeout	180000	Время ожидания ответа на запрос от терминала при успешном установлении связи с терминалом (в миллисекундах).
connectionTimeout	5000	Время ожидания установки соединения с терминалом (в миллисекундах).
transactionTime	181000	Общее время транзакции оплаты или возврата (в миллисекундах).
language	"MIX"	Язык печати слип-чека на POS-принтере. Значения: "KAZ" – казахский, "RUS" – русский, "MIX" – казахский и русский.
printSlip	true	При установлении значения false, слип-чек не будет печататься на POS-принтере.
manualConfirmation	false	При значении true, есть возможность ручного подтверждения неуспешной транзакции после ввода секретного пароля systemPassword. Окно может появиться при отсутствии связи с терминалом или в случаях, когда транзакция началась, но не было получено ответа об успешном завершении транзакции.
systemPassword	"123456789"	Секретный пароль для использования при ручном подтверждении (manualConfirmation).
fillOldFields	false	При значении true, в SetRetail будут записываться плагинные свойства успешной транзакции, которые использовались в предыдущих версиях до 1.2.х.
activeSumEnterFormPayment	true	Когда установлено `showSumEnterForm = true`, выводится клавиатура для ввода суммы. Если этот параметр установлен в true, вы можете редактировать сумму оплаты. Если false – значение не редактируется и всегда равно сумме оплаты.
activeSumEnterFormRefund	false	Когда установлено `showSumEnterForm = true`, выводится клавиатура для ввода суммы. Если этот параметр установлен в true, вы можете редактировать сумму возврата. Если false – значение не редактируется и всегда равно сумме в возврате.
scale	1.00	Перед передачей суммы на терминал происходит проверка кратности сумм. Если сумма кратна этому значению, оплата идет на терминал. Используется для терминалов с ограничениями на прием целочисленных сумм. Если параметр отсутствует, по умолчанию используется значение 1.00.

Пример файла конфигурации:

{
  "ownCheque": false,
  "showSumEnterForm": false,
  "ip": "http://ХХ.ХХ.ХХ.ХХ:8080",
  "readTimeout": 180000,
  "connectionTimeout": 5000,
  "transactionTime": 181000,
  "language": "MIX",
  "printSlip": true,
  "manualConfirmation": false,
  "systemPassword": "123456789",
  "fillOldFields": false,
  "activeSumEnterFormPayment": true,
  "activeSumEnterFormRefund": false,
  "scale": 1.00
}

Настройте типы оплаты “уши“ в файле конфигурации.

Откройте файл конфигурации на редактирование, командой:

sudo mkdir /home/tc/storage/crystal-cash/web/config/paymentTypeRanks.json

Вставьте или отредактируйте следующую конфигурацию, добавив нужный сервис:

 {
    "paymentTypesRanks": [
        {
            "paymentId": "kz.bakai.pos.payment",
            "fastAccessRank": 3,
            "rank": 3
        },
        {
            "paymentId": "CashPaymentEntity",
            "fastAccessRank": 1,
            "rank": 1
        },
        {
            "paymentId": "ExternalBankTerminalPaymentEntity",
            "rank": 4
        }
    ],
    "paymentTypesWithCounterpartyRanks": [
        {
            "paymentId": "kz.bakai.pos.payment",
            "fastAccessRank": 3,
            "rank": 3
        },
        {
            "paymentId": "CashPaymentEntity",
            "fastAccessRank": 1,
            "rank": 1
        },
        {
            "paymentId": "ExternalBankTerminalPaymentEntity",
            "rank": 4
        }
    ]
}

5. На кассе войдите в Настройки → Внешние системы.

6. Активируйте процессинг Halyk Pay.

7. При оплате выберите Halyk Pay Оплата.

Пример транзакции в операционном дне SetCentrum.

Список ошибок

Наименование ошибки	Описание
Ошибка оплаты. Неизвестный номер транзакции	В случае, если в ответе терминала будет Status: success Transactionid:null Данная транзакция считается неуспешной и следует повторить оплату
Терминал kaspi недоступен. Обратитесь к системному администратору	Нет связи с терминалом по сети. Проверьте настройки ip адреса и порта терминала. Убедитесь, что терминал включен и проходит команда ping с кассы.
Если покупатель нажал отмену на терминале, касса висит до 180 секунд	Это корректное поведение плагина, согласно документации Kaspi (п.4.4.). При нажатии отмены на терминале, терминал возвращает статус операции unknown на что плагин производит обновление статуса до получения конечного ответа fail или success.

SetRetail10 ◾️ Эквайринговый плагин Bakai bank PAX (Halyk PAX)

Описание

Настройки

Сервер

Касса

Список ошибок