Модуль "Подели" предназначен для выполнения оплаты с помощью клиентского приложения "Подели", которое генерирует QR-код для оплаты.
Типы поддерживаемых операций:
- оплата,
- отмена оплаты для чека продажи,
- возврат по чеку продажи.
Для оплаты необходимо отсканировать QR-код.
При оплате через процессинг "Подели" не рекомендуется использовать в чеке модификатор "Количество" и объединение позиций.
Конфигурирование модуля
Для использования модуля необходимо установить пакет artix-podeli
командой:
aptitude install artix-podeli
Запрос к процессинговой системе "Подели" выполняется при выборе специального типа оплаты. Для добавления типа оплаты необходимо выполнить конфигурирование модуля. Номер типа оплаты задается в процессе конфигурирования.
dpkg-reconfigure artix-podeli
Настройки процессинга задаются в конфигурационном файле /linuxcash/cash/paysystems/podeli/podeli.ini
.
Наименование | Тип данных | Описание | Примечания |
---|---|---|---|
url | строковый | Адрес сервера | По умолчанию http://localhost |
timeout | целочисленный | Время ожидания ответа от сервера (в секундах) | По умолчанию 60 секунд |
infoRequestInterval | целочисленный | Интервал запроса статуса заказа (в секундах) | По умолчанию 10 секунд |
login | строковый | Имя пользователя для доступа к серверу | По умолчанию "" |
password | строковый | Пароль для доступа к серверу | По умолчанию "" |
certificatePath | строковый | Путь до сертификата для доступа к серверу | По умолчанию "" |
certificatePassword | строковый | Пароль для сертификата | По умолчанию "" |
[Podeli] ; Настройки процессинга ПОДЕЛИ ; Адрес сервера ; По умолчанию http://localhost ;url = http://localhost ; Время ожидания ответа от сервера (в секундах) ; По умолчанию 60 секунд ;timeout = 60 ; Интервал запроса статуса заказа (в секундах) ; По умолчанию 10 секунд ;infoRequestInterval = 10 ; Имя пользователя для доступа к серверу ; По умолчанию "" ;login = "" ; Пароль для доступа к серверу ; По умолчанию "" ;password = "" ; Путь до сертификата для доступа к серверу ; По умолчанию "" ;certificatePath = "" ; Пароль для сертификата ; По умолчанию "" ;certificatePassword = ""
Передача дополнительных полей
В кассовом ПО до версии 4.6.244 (включительно) для передачи поля comment1
в запросах к серверу процессинга "Подели" необходимо задать параметр comment1Mask
в конфигурационном файле /linuxcash/cash/paysystems/podeli/podeli.ini
в секции [Podeli]
.
Наименование | Тип данных | Описание | Примечания |
---|---|---|---|
comment1Mask | строковый | Маска для формирования поля comment1 | По умолчанию "%(document.shopCode[04d])%(document.cashCode[02d])%(document.shift[04d])%(document.num[07d])%(document.dateTimeBeg[hhmmss]) " |
; Маска для формирования поля comment1 ; По умолчанию "%(document.shopCode[04d])%(document.cashCode[02d])%(document.shift[04d])%(document.num[07d])%(document.dateTimeBeg[hhmmss])" ;comment1Mask = "%(document.shopCode[04d])%(document.cashCode[02d])%(document.shift[04d])%(document.num[07d])%(document.dateTimeBeg[hhmmss])"
В кассовом ПО начиная с версии 4.6.245 для передачи дополнительных полей необходимо задать параметры в конфигурационном файле /linuxcash/cash/paysystems/podeli/podeli.ini
:
Для операции оплаты – в секции
[Podeli.RequestFieldsMapping.create_offline]
.Наименование Тип данных Описание Примечания order.address строковый Маска для формирования поля address По умолчанию "%(document.shopCode[04d])"
order.mall строковый Маска для формирования поля mall По умолчанию ""
comment1 строковый Маска для формирования поля comment1 По умолчанию " %(document.shopCode[04d])%(document.cashCode[02d])%(document.shift[04d])%(document.num[07d])%(document.dateTimeBeg[hhmmss])
"Пример настройки[Podeli.RequestFieldsMapping.create_offline] ;order.address = "%(document.shopCode[04d])" ;order.mall = "" ;comment1 = "%(document.shopCode[04d])%(document.cashCode[02d])%(document.shift[04d])%(document.num[07d])%(document.dateTimeBeg[hhmmss])"
Для операции возврата и отмены оплаты – в секции
[Podeli.RequestFieldsMapping.refund]
.Наименование Тип данных Описание Примечания order.refund.comment1 строковый Маска для формирования поля comment1 при возврате и отмене оплаты По умолчанию " %(document.shopCode[04d])%(document.cashCode[02d])%(document.shift[04d])%(document.num[07d])%(document.dateTimeBeg[hhmmss])
"Пример настройки[Podeli.RequestFieldsMapping.refund] ;order.refund.comment1 = "%(document.shopCode[04d])%(document.cashCode[02d])%(document.shift[04d])%(document.num[07d])%(document.dateTimeBeg[hhmmss])"
Для полей, передаваемых в запросе на сервер процессинга по умолчанию, задать соотнесение невозможно. Значение перезаписано не будет, в основном логе /linuxcash/logs/current/terminal.log
будет выведено сообщение: "Попытка замены уже существующего поля '<название поля>'".
Логирование
Журнал запросов к процессинговой системе "Подели" ведется в основном логе /linuxcash/logs/current/terminal.log
.