Описание

Плагин интеграции предназначен для подключения терминалов Aisino с протоколом SmartPOS для осуществления приема оплаты по банковским картам.

Терминалы обслуживаются в АО «Народный банк Казахстана» и АО «Банк ЦентрКредит»

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

Настройки

Сервер

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

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

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

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

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

5. Установите параметры на вкладке AISINO ОПЛАТА → кликните .

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

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

Касса

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

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

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

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

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

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

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

{
    "ownCheque": false, // при установке значения true происходит печать слип-чека на принтере банковского терминала
    "showSumEnterForm": false, // при установке значения true, после выбора типа оплаты, будет возможность указать сумму оплаты выбранного типа. Используется для частичной оплаты чека
    "ip": "http://XX.XX.XX.XX:8080", // указывается ip адрес банковского терминала в локальной сети
    "readTimeout": 30000, // время ожидания ответа на запрос от терминала при успешном установлении связи с терминалом
    "connectionTimeout": 5000, // время ожидания установки соединения с терминалом
    "transactionTime": 181000, // общее время транзакции оплаты или возврата
    "language": "MIX", // язык печати слип-чека на POS-принтере: KAZ – казахский, RUS – русский, MIX – казахский и русский язык
    "printSlip": true, // при установлении значения false, слип-чек не будет печататься на POS-принтере
    "manualConfirmation": false, // при значении true, есть возможность ручного подтверждения неуспешной транзакции после ввода секретного пароля systemPassword
    "systemPassword": "123456789", // секретный пароль для ручного подтверждения неуспешной транзакции
    "activeSumEnterFormPayment": true, // когда установлено showSumEnterForm = true и параметр установлен в true, вы можете редактировать сумму оплаты
    "activeSumEnterFormRefund": false // когда установлено showSumEnterForm = true и параметр установлен в true, вы можете редактировать сумму возврата
}

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

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

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

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

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

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

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

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

SetRetail10 ◾️ Плагин терминала Aisino

Описание

Настройки

Сервер

Касса