Описание

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

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

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

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

Настройки

Сервер

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

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

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

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

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

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

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

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

Касса

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

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

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

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

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

Параметр	Значение	Описание
ownCheque	false	При установке значения true происходит печать слип-чека на принтере банковского терминала.
showSumEnterForm	false	При установке значения true, после выбора типа оплаты, будет возможность указать сумму оплаты выбранного типа. Используется для частичной оплаты чека.
ip	"http://ХХ.ХХ.ХХ.ХХ:8080"	Указывается IP-адрес банковского терминала в локальной сети, используется, когда продажа идет от одного юридического лица.
clientPropertiesByTaxCode	{"100940003111":{"ip":"http://192.168.0.209:8080","terminalId":"71055399"},"100940003222":{"ip":"http://192.168.0.209:8080","terminalId":"61041025"}}	Параметр указывается вместо "ip", когда используются несколько юридических лиц на кассе. Содержит объекты с ИИН/БИН организации, её IP-адресом терминала и terminalId для поддержки Мультимерчанта.
readTimeout	180000	Время ожидания ответа на запрос от терминала при успешном установлении связи с терминалом (в миллисекундах).
connectionTimeout	5000	Время ожидания установки соединения с терминалом (в миллисекундах).
transactionTime	181000	Общее время транзакции оплаты или возврата (в миллисекундах).
language	"MIX"	Язык печати слип-чека на POS-принтере. Значения: "KAZ" – казахский, "RUS" – русский, "MIX" – казахский и русский.
printSlip	true	При установлении значения false, слип-чек не будет печататься на POS-принтере.
cancelMethod	"refund"	Параметр определяет метод аннулирования принятой оплаты. Значения: "refund" – аннулирование с подтверждением от покупателя; "reversal" – аннулирование без подтверждения покупателя.
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.
delay	5000	Указывается задержка между окончанием первого запроса в терминале и началом следующего запроса, в варианте мультимерчант (в миллисекундах).

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

{
"ownCheque":false, // при установке значения true происходит печать слип-чека на принтере банковского терминала
"showSumEnterForm": false, // при установке значения true, после выбора типа оплаты,будет возможность указать сумму оплаты выбранного типа. Используется для частичной
оплаты чека
"ip":”http://ХХ.ХХ.ХХ.ХХ:8080",	// указывается ip адрес банковского терминала в локальной сети, используется, когда продажа идет от одного юридического лица
"clientPropertiesByTaxCode": {	// параметр указывается вместо “ip”, когда используются несколько юридических лиц на кассе
"100940003111": {	// указывается ИИН/БИН для организации от которой будет приниматься оплата
"ip": "http://192.168.0.209:8080",	// указывается ip терминала для организации от которой будет приниматься оплата
"terminalId": "71055399"	// указывается terminalid для организации от которой будет приниматься оплата. Параметр следует использовать, если у вас терминал поддерживает Мультимерчант

},
"100940003222": {	// указывается ИИН/БИН для организации от которой будет приниматься оплата
"ip": "http://192.168.0.209:8080",	// указывается ip терминала для организации от которой будет приниматься оплата
"terminalId": "61041025"	// указывается terminalid для организации от которой будет приниматься оплата. Параметр следует использовать, если у вас терминал поддерживает Мультимерчант
}
},

"readTimeout": 180000,	// время ожидания ответа на запрос от терминала при успешном установлении связи с терминалом
"connectionTimeout": 5000,	// время ожидания установки соединения с терминалом
"transactionTime": 181000,	// общее время транзакции оплаты или возврата
"language": "MIX",	// язык печати слип-чека на POS-принтере
// KAZ – слип печатается на казахском языке
// RUS – слип печатается на русском языке
// MIX – слип печатается на казахском и русском языке
"printSlip": true,	// при установлении значения false, слип-чек не будет печататься на POS-принтере
"cancelMethod": "refund",	// параметр определяет метод аннулирования принятой оплаты, могут быть значения: "refund" – аннулирование с подтверждением от покупателя и "reversal" – аннулирование без подтверждения покупателя
"manualConfirmation": false,	// при значении true, есть возможность ручного подтверждения неуспешной транзакции после ввода секретного пароля systemPassword. Окно может появится при отсутсивии связи с терминалом или в случаях, когда транзакция началась, но не было получено ответа об успешном завершении транзакции
"systemPassword": "123456789",
"fillOldFields": false,	// при значении true, в SetRetail будут записываться плагинные свойства успешной транзакции, которые использовались в предыдущих версиях до 1.2.х
"activeSumEnterFormPayment":true,	// Когда установлено showSumEnterForm – true, выводится клавиатура для ввода суммы, если параметр установлен в true, вы можете редактировать сумму оплаты. Если false – значение не редактируется и всегда равно сумме оплаты
"activeSumEnterFormRefund":false	// Когда установлено showSumEnterForm – true, выводится клавиатура для ввода суммы, если параметр установлен в true, вы можете редактировать сумму возврата. Если false – значение не редактируется и всегда равно сумме в возврате
"scale": 1.00	// Перед передачей суммы на терминал, происходит проверка кратности сумм и если сумма кратна, оплата идет на терминал. На некоторых терминала установлены ограничения в приеме оплаты целочисленной суммы. По-умолчанию, если параметр отсутсвует, установлено значение 1.00
"delay": 5000	// указывается задержка между окончанием первого запроса в терминале и началом следующего запроса, в варианте мультимерчант.
}

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

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

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

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

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

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

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

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

8. Транзакция слипа чека отобразиться в операционном дне сервера SetCentrum.

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

Описание

Настройки

Сервер

Касса