Модуль Кошелёк Pay предназначен для выполнения оплаты с помощью процессинга Кошелёк Pay для покупателей с картой Артикс Бонус
Типы поддерживаемых операций:
- оплата,
- отмена оплаты для чека продажи,
- возврат по чеку продажи.
Для оплаты чека продажи необходимо в открытый документ добавить карту Артикс Бонус с верификацией cardsmobile и в качестве оплаты выбрать "Через Кошелёк Pay".
Включение плагина fdcontroller позволяет отправлять фискальные данные чека.
Конфигурирование модуля
Для использования модуля необходимо установить пакет artix-koshelekpay.
aptitude install artix-koshelekpay
Запрос к процессинговой системе Кошелёк Pay выполняется при выборе специального типа оплаты. Для добавления типа оплаты необходимо выполнить конфигурирование модуля. Номер типа оплаты задается в процессе конфигурирования.
dpkg-reconfigure artix-koshelekpay
Настройки процессинга задаются в файле /linuxcash/cash/paysystems/koshelekpay/config.conf в секции [KoshelekPay.Main].
| Наименование | Тип данных | Описание | Примечания |
|---|---|---|---|
| url | строковый | Адрес сервера | По умолчанию http://localhost |
| timeout | целочисленный | Время ожидания ответа от сервера | По умолчанию 10 секунд |
| statusCheckPeriod | целочисленный | Период проверки статуса транзакции | По умолчанию 500 миллисекунд |
| login | строковый | Логин для авторизации в системе "Кошелёк Pay" | |
| password | строковый | Пароль для авторизации в системе "Кошелёк Pay" | |
| terminalKey | строковый | Идентификатор терминала, присвоенный банком | Используется только для Тинькофф Банка |
| storeId | строковый | Идентификатор ТСП, выданный Cardsmobile при его подключении | |
| terminalId | строковый | Идентификатор кассы |
[KoshelekPay.Main] ; Настройки процессинга "Кошелёк Pay" ; Адрес сервера ; По умолчанию http://localhost ;url = http://localhost ; Время ожидания ответа от сервера (в секундах) ; По умолчанию 10 секунд ;timeout = 10 ; Период проверки статуса транзакции (в миллисекундах) ; По умолчанию 500 ;statusCheckPeriod = 500 ; Логин для авторизации в системе "Кошелёк Pay" ; По умолчанию "" ;login = "" ; Пароль для авторизации в системе "Кошелёк Pay" ; По умолчанию "" ;password = "" ; Идентификатор терминала, присвоенный банком, нужен только если используется Тинькофф Банк ; По умолчанию "" ;terminalKey = "" ; Идентификатор ТСП, выданный Cardsmobile при его подключении ; По умолчанию "" ;storeId = "" ; Идентификатор кассы ; По умолчанию "" ;terminalId = ""
Настройки библиотеки PasscodeVerifier задаются в файле /linuxcash/cash/paysystems/koshelekpay/config.conf в секции [KoshelekPay.PasscodeVerifier].
| Наименование | Тип данных | Возможные значения | Описание | Примечания |
|---|---|---|---|---|
| barcodeMask | строковый | Штрих-код, отправляемый в библиотеку PasscodeVerifier для верификации | По умолчанию ".*(?<barcode>CM27[0-9]{11}.{6} [0-9]{3})" | |
| algorythm | строковый |
| Используемый алгоритм шифрования | По умолчанию "HMACSHA256" |
| passLength | целочисленный | Число символов одноразового пароля | По умолчанию Максимальное значение | |
| prefix | строковый | Префикс штрих-кода | По умолчанию "CM" | |
| key | строковый | Секретный ключ (HEX-строка), необходимый для формирования парольной части TOTP | ||
| interval | целочисленный | Временной интервал, в пределах которого одноразовый пароль считается действительным | По умолчанию 60 секунд | |
| cardSessionLength | целочисленный | Количество символов части "cardSession" штрих-кода карты | По умолчанию 6 | |
| delimeter | строковый | Разделитель между составляющими штрих-кода | По умолчанию " ". Не должен быть пустым |
[KoshelekPay.PasscodeVerifier]
; Настройки библиотеки "PasscodeVerifier"
; Штрихкод, отправляемый в библиотеку PasscodeVerifier для верификации
; По умолчанию ".*(?<barcode>CM27[0-9]{11}.{6} [0-9]{3})"
;barcodeMask = ".*(?<barcode>CM27[0-9]{11}.{6} [0-9]{3})"
; Используемый алгоритм шифрования. Возможные значения:
; HMACSHA256
; HMACSHA1
; По умолчанию "HMACSHA256"
;algorythm = "HMACSHA256"
; Число символов одноразового пароля
; Максимальное значение: 10
; По умолчанию 3
;passLength = 3
; Префикс штрих-кода
; По умолчанию "CM"
;prefix = "CM"
; Секретный ключ (HEX-строка), необходимый для формирования парольной части TOTP
; По умолчанию ""
;key = ""
; Временной интервал (в секундах), в пределах которого одноразовый пароль считается действительным
; По умолчанию 60
;interval = 60
; Количество символов части "cardSession" штрих-кода карты
; По умолчанию 6
;cardSessionLength = 6
; Разделитель между составляющими штрих-кода
; Не должен быть пустым
; По умолчанию " "
;delimeter = " "
Настройки соотнесения налогов кассы и налогов системы Кошелёк Pay задаются в файле /linuxcash/cash/paysystems/koshelekpay/config.conf в секции [KoshelekPay.Taxes].
[KoshelekPay.Taxes] ; Соотнесение налогов кассы с вариантами налогов кошелька ; Пример: VAT10 = 1, 2, 5 ; Где 1, 2, 5 - коды налогов, настроенных на кассе ; НДС по ставке 0% ;VAT0 = ; НДС по ставке 10% ;VAT10 = ; НДС по ставке 20% ;VAT20 = ; НДС по расчетной ставке 10/110 ;VAT110 = ; НДС по расчетной ставке 20/120 ;VAT120 =
Настройка способов оплаты осуществляется в файле /linuxcash/cash/paysystems/koshelekpay/config.conf. Для каждого способа оплаты необходимо настроить секцию [KoshelekPay.PaymentMethod.N].
| Наименование | Тип данных | Описание | Примечания |
|---|---|---|---|
| type | строковый | Механизм оплаты | По умолчанию "SBP" |
| merchantId | строковый | Идентификатор зарегистрированного партнёра в СБП | |
| account | целочисленный | Счет юридического лица в банке-получателе |
;[KoshelekPay.PaymentMethod.N] ; Механизм оплаты ; По умолчанию "SBP" ;type = "SBP" ; Идентификатор зарегистрированного партнёра в СБП ; По умолчанию "" ;merchantId = "" ; Счет юридического лица в банке-получателе ; По умолчанию "" ;account = ""
При переходе в подытог осуществляется запрос к системе Кошелёк Pay на проверку доступности способа оплаты.
Шаблон слипа для печати
При оплате чека будет напечатан слип, шаблон которого находится в /linuxcash/cash/reports/koshelekpay.xml.
Логирование
Журнал запросов к процессинговой системе Кошелёк Pay ведется в основном логе /linuxcash/logs/current/terminal.log.