Описание

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

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

Настройки

Сервер

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

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

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

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

Путь до файла конфигурации (Linux) - /home/tc/storage/crystal-cash/banks/kaspi/config.json
Путь до файла конфигурации (Windows) - c://.../home/tc/storage/crystal-cash/banks/kaspi/config.json
Таймаут актуализации в секундах - время отклика от процессинга.
Число попыток актуализации - количество попыток запросов к процессингу.

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

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

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

Касса

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

sudo mkdir /home/tc/storage/crystal-cash/kaspi/kaspi2

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

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

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

Параметр	Значение	Описание
ownCheque	false	При установке значения true происходит печать слип-чека на принтере банковского терминала.
showSumEnterForm	false	При установке значения true, после выбора типа оплаты, будет возможность указать сумму оплаты выбранного типа. Используется для частичной оплаты чека.
ip	"http://ХХ.ХХ.ХХ.ХХ:8080"	Указывается IP-адрес банковского терминала в локальной сети, используется, когда продажа идет от одного юридического лица.
ipsByTaxCode	{"100940003111":"http://78.40.108.132:8080", "100940003777":"http://192.168.0.215:8080"}	Параметр указывается вместо "ip", когда используются несколько юридических лиц на кассе. Содержит пары "ИИН/БИН" : "IP-адрес терминала" для каждого юридического лица.
readTimeout	30000	Время ожидания ответа на запрос от терминала при успешном установлении связи с терминалом (в миллисекундах).
connectionTimeout	5000	Время ожидания установки соединения с терминалом (в миллисекундах).
transactionTime	181000	Общее время транзакции оплаты или возврата (в миллисекундах).
language	"MIX"	Язык печати слип-чека на POS-принтере. Значения: "KAZ" – казахский, "RUS" – русский, "MIX" – казахский и русский.
printSlip	true	При установлении значения false, слип-чек не будет печататься на POS-принтере.
cancelMethod	"refund"	Параметр определяет метод аннулирования принятой оплаты. Значения: "refund" – аннулирование с подтверждением от покупателя; "remains" – аннулирование без подтверждения покупателя.
cancelBySubStatus	false	По умолчанию false. Если параметр в значении true, то при нажатии на терминале «крестика» для отмены оплаты, терминал возвращает status = unknown и substatus = ProcessCanceled. При получении processCanceled выводится сообщение «Прошла оплата на терминале» и варианты выбора ДА-НЕТ.
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 – значение не редактируется и всегда равно сумме в возврате.

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

{
  "ownCheque": false,
  "showSumEnterForm": false,
  "ip": "http://ХХ.ХХ.ХХ.ХХ:8080",
  "ipsByTaxCode": {
    "100940003111": "http://78.40.108.132:8080",
    "100940003777": "http://192.168.0.215:8080"
  },
  "readTimeout": 30000,
  "connectionTimeout": 5000,
  "transactionTime": 181000,
  "language": "MIX",
  "printSlip": true,
  "cancelMethod": "refund",
  "cancelBySubStatus": false,
  "manualConfirmation": false,
  "systemPassword": "123456789",
  "fillOldFields": false,
  "activeSumEnterFormPayment": true,
  "activeSumEnterFormRefund": false
}

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

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

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

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

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

8. Пример чека в операционном дне на сервере SetCentrum.

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

Описание

Настройки

Сервер

Касса