Модуль Payme предназначен для выполнения оплаты платежными картами с использованием клиентского приложения PaymeGO, которое генерирует QR-код для оплаты. QR-код рассчитан только на 1 платёж, повторно совершить платеж по QR-коду невозможно. Время действия QR-кода – 30 секунд.

Типы поддерживаемых операций:

  • оплата,
  • отмена оплаты для чека продажи,
  • полный возврат по чеку продажи.

Для оплаты чека продажи необходимо отсканировать QR-код.

Кассовая программа анализирует результат выполнения запроса к процессинговой системе PaymeGo и при необходимости печатает на чековой ленте содержимое печатного образа.

Банковская квитанция получается от процессинговой системы и печатается 2 раза.

Частичный возврат по чеку продажи запрещен.

При возврате по чеку продажи, содержащему маркированные или акцизные товары (алкогольную или табачную продукцию, обувные товары или лекарственные препараты), необходимо:

Конфигурирование модуля

Для использования модуля необходимо установить пакет artix-payme командой:

aptitude install artix-payme

Запрос к процессинговой системе PaymeGo выполняется при выборе специального типа оплаты. Для добавления типа оплаты необходимо выполнить конфигурирование модуля. Номер типа оплаты задается в процессе конфигурирования.

Конфигурирование модуля
dpkg-reconfigure artix-payme

Настройки процессинга задаются в файле /linuxcash/cash/conf/paymego.conf в секции [Main].

НаименованиеТип данныхВозможные значенияОписаниеПримечания
timeoutцелочисленный
Время ожидания ответа от сервера (в секундах)По умолчанию 10 секунд
urlстроковый
Адрес сервераПо умолчанию "http://localhost"
posIdстроковый
Код кассыПо умолчанию "id"
posKeyстроковый
Ключ кассыПо умолчанию "key"
payDurationцелочисленный
Продолжительность опроса состояния выполнения оплаты (в миллисекундах)По умолчанию 300000 миллисекунд
frequencyцелочисленный
Частота опроса состояния оплаты (в миллисекундах)По умолчанию 10000 миллисекунд
paymentProviderцелочисленный
Код провайдера услуг по оплате по QR-кодуПо умолчанию 141
ignoredErrorsстроковый
  • -32300,
  • -32700,
  • -32600,
  • -32400,
  • -32601,
  • -32602,
  • -32504,
  • -31301,
  • -31300,
  • -31302,
  • -31303,
  • -31002,
  • -31001,
  • -31400,
  • -31101,
  • -31102,
  • -31103,
  • -31110,
  • -31700,
  • -31613,
  • -31630,
  • -31602,
  • -31601,
  • -31620,
  • -31100,
  • -31624,
  • -31623,
  • -31900,
  • -31640,
  • -31901,
  • -31200,
  • -31800

Список кодов ошибок, при получении которых сообщения на отмену не помещаются в очередь

По умолчанию список пуст
Пример настройки
[Main]
; Настройки процессинга PaymeGo

; Время ожидания ответа от сервера (в секундах)
; По умолчанию 10 секунд
;timeout = 10

; Адрес сервера
; По умолчанию "http://localhost"
;url = "http://localhost"

; Код кассы
; По умолчанию "id"
;posId = "id"

; Ключ кассы
; По умолчанию "key"
;posKey = "key"

; Продолжительность опроса состояния выполнения оплаты (в миллисекундах)
; По умолчанию 300000
;payDuration = 300000

; Частота опроса состояния оплаты (в миллисекундах)
; По умолчанию 10000
;frequency = 10000

; Код провайдера услуг по оплате по QR-коду
; По умолчанию 141
;paymentProvider = 141

; Список кодов ошибок, при которых сообщения на отмену не складываются в очередь
; Доступные коды: -32300, -32700, -32600, -32400, -32601, -32602, -32504, -31301,
; -31300, -31302, -31303, -31002, -31001, -31400, -31101, -31102, -31103, -31110,
; -31700, -31613, -31630, -31602, -31601, -31620, -31100, -31624, -31623, -31900, -31640, -31901, -31200, -31800
; По умолчанию список пуст
;ignoredErrors =.

Если во время оплаты чека от сервера приходит ответ со статусом, не равным 4 (успешная оплата), то запрос статуса документа будет отправляться на сервер в течение времени, указанного в параметре payDuration, с частотой, указанной в параметре frequency. Если по истечении времени, указанного в параметре payDuration, оплата не прошла, то на экран будет выведена ошибка "Результат оплаты неизвестен: таймаут ожидания ответа от сервера", при этом в очередь Artix-Queue будет помещено сообщение отмены транзакции.

Если по истечении времени, указанного в параметре payDuration, возврат не прошел, то сообщение об отмене оплаты будет помещено в очередь Artix-Queue, при этом слипы распечатаны не будут.

Шаблон слипа для печати

При оплате чека будет осуществлена печать слипа payme.xml, который находится в /linuxcash/cash/reports. В качестве данных для слипа используется ответ от сервера процессинговой системы.

Логирование

Журнал запросов к процессинговой системе PaymeGo ведется в основном логе /linuxcash/logs/current/terminal.log.

  • No labels