Эмулятор платежной системы представляет собой модуль, позволяющий имитировать подключение к пин-паду и поведение платежной банковской системы на кассе.

Настройка заглушки процессинга осуществляется в конфигурационном файле linuxcash/cash/conf/ncash.ini в секции [DummyProcessing]. Секция для заглушки процессинга добавляется вручную.

НаименованиеТип данныхВозможные значенияОписаниеПримечания

authCode

строковый


Код авторизации

По умолчанию ""

cardNumber

строковый


Номер карты, которой была произведена оплата

По умолчанию ""

cardType

строковый

  • VISA
  • MasterCard
  • AmericanExpress

Тип карты, которой была произведена оплата

По умолчанию ""
messageстроковый


Сообщение от процессингаПо умолчанию "Одобрено в режиме offline"
operationIdстроковый
РРН транзакцииПо умолчанию ""
resultCodeчисловой
Код результата выполнения операцииПо умолчанию 1
terminalNumberчисловой
Номер терминала, на котором была произведена оплатаПо умолчанию 0
balanceвещественный
Баланс карты, которой была произведена оплатаПо умолчанию 0.0

discountCard

строковый
Номер дисконтной карты, привязанной к карте, которой была произведена оплатаПо умолчанию ""
statusчисловой
  • 0
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
Результат работы заглушки

По умолчанию 0.

  • 0 – успешно,
  • 1 – неудачно,
  • 2 – отменено пользователем,
  • 3 – превышен остаток (на счёте не хватает денег),
  • 4 – необходимо обработать промежуточный ответ,
  • 5 – отобразить запрос на повторную операцию,
  • 6 – отобразить сообщение для кассира,
  • 7 – отобразить сообщение "Нет соединения" при показе QR-кода для оплаты,
  • 8 – отобразить диалог о необходимости вынуть карту,
  • 9 – ошибка при оплате по QR-коду,
  • 10 – оплата невозможна

paymentMethod

числовой
  • 0

  • 1

  • 2

Тип оплаты

По умолчанию 1.

  • 0 – не определено,

  • 1 – по карте,

  • 2 – по QR-коду

timeoutчисловой
Таймаут транзакцииПо умолчанию 0.
1000 = 1 секунда

processingOption

строковый
  • 0x02
  • 0x04
  • 0x08
  • 0x20
  • 0x40
  • 0x80
  • 0x100
  • 0x200
  • 0x800
  • 0x1000
  • 0x2000
  • 0x4000
  • 0x4001
  • 0x4010
  • 0x4400
  • 0x8000
  • 0x10000
  • 0x20000
Опции процессинга

По умолчанию 0x0.

  • 0x02 – процессинг поддерживает выдачу сдачи,
  • 0x04 – процессинг поддерживает сверку итогов по merchantId,
  • 0x08 – процессинг поддерживает печать отчета по merchantId,
  • 0x20 – процессинг поддерживает только полный возврат по чеку продажи,
  • 0x40 – при оплате необходимо ввести PIN код,
  • 0x80 – для ввода карт необходимо ввести токен карты,
  • 0x100 – при оплате необходимо передавать данные чека,
  • 0x200 – необходимо сообщить покупателю код подтверждения,
  • 0x800 – процессинг поддерживает возврат средств через очередь,
  • 0x1000 – процессинг поддерживает отмену сканирования QR-кода,
  • 0x2000 – процессинг поддерживает оплату по QR-коду на PinPad,
  • 0x4000 – процессингу не нужен терминал,
  • 0x4001 – необходимо ввести карту,
  • 0x4010 – при оплате необходимо ввести токен карты,
  • 0x4400 – необходимо показать QR-код для оплаты,
  • 0x8000 – процессинг поддерживает возможность препрывания оплаты,
  • 0x10000 – для оплаты необходимо получить хэшированный номер карты,
  • 0x20000 – процессинг поддерживает частичную оплату

merchants

числовой

Список отделов процессинга

По умолчанию ""
merchantErrorMessageстроковый
Сообщение, отправляемое если отдел не найденПо умолчанию "Передан некорректный merchantId"
slipCountчисловой
Количество слипов процессингаПо умолчанию 0
scanTokenTitleстроковый
Заголовок диалога сканирования токена картыПо умолчанию: "Ввод токена"
scanTokenMessageстроковый
Сообщение диалога сканирования токена картыПо умолчанию: "Отсканируйте токен карты"
scanTokenErrorMessageстроковый
Сообщение диалога сканирования токена карты при ошибкеПо умолчанию: "Ошибка считывания токена карты,\nповторите сканирование"
scanTokenRegexpстроковый
Регулярное выражение для проверки введённых данных в диалоге сканирования токена картыПо умолчанию: .*
scanTokenImagePathстроковый
Путь к картинке для диалога сканирования токена картыПо умолчанию ""
randomNumberлогический
  • true
  • false

Генерация случайного номера карты при каждой оплате

По умолчанию false
hashedCardNumberстроковый


Хэшированный номер карты

По умолчанию ""
hashGeneratorValutчисловой


Значение, возвращаемое при запросе кода валюты для генерации хэшированного номера карты

По умолчанию -1
qrCodeDurationчисловой


Продолжительность отображения диалога с QR-кодом (в миллисекундах)

По умолчанию 3000.

Значение настройки qrCodeDuration должно быть меньше значения настройки timeout


[DummyProcessing]
; Настройки процессинга заглушки
; При выполнении операций будут возвращаться указанные ниже значения

;Код авторизации
authCode="" 

;Номер карты, которой была произведена оплата
cardNumber="" 

;Тип карты, которой была произведена оплата (VISA, MasterCard, AmericanExpress)
cardType="" 

;Сообщение от процессинга
message="Одобрено в режиме offline" 

;РРН транзакции
operationId="" 

;Код возврата от процессинга
resultCode=1

;Номер терминала, на котором была произведена оплата
terminalNumber=0

;Баланс карты, которой была произведена оплата
balance=0.0

;Номер дисконтной карты, привязанной к карте, которой была произведена оплата
discountCard="" 

;Статус транзакции. Этот статус будет возвращаться на все запросы к процессингу
status=0

;Тип оплаты
paymentMethod=1

;Таймаут транзакции
timeout=0

;Опции процессинга
processingOption=0x0

;Список отделов процессинга
merchants="" 

;Сообщение, отправляемое если отдел не найден
merchantErrorMessage="Передан некорректный merchantId" 

;Количество слипов процессинга
slipCount=0

;Заголовок диалога сканирования токена карты
scanTokenTitle="Ввод токена"

;Сообщение диалога сканирования токена карты
scanTokenMessage="Отсканируйте токен карты"

;Сообщение диалога сканирования токена карты при ошибке
scanTokenErrorMessage="Ошибка считывания токена карты,\nповторите сканирование"

;Регулярное выражение для проверки введённых данных в диалоге сканирования токена карты
scanTokenRegexp=".*"

;Путь к картинке для диалога сканирования токена карты
scanTokenImagePath=""

;Генерация случайного номера карты при каждой оплате
randomNumber=false

;Хэшированный номер карты
hashedCardNumber=""

;Значение, возвращаемое при запросе кода валюты для генерации хэшированного номера карты
hashGeneratorValut=-1

;Продолжительность отображения диалога с QR-кодом (в миллисекундах)
qrCodeDuration = 3000


Для работы эмулятора платежной системы необходимо задать валюту в утилите администрирования Yuki, указав в свойствах валюты тип оплаты в программе "Электронные" и название плагина процессинга "Автономный терминал (Заглушка)". Подробнее о настройке валюты можно прочитать в разделе "Валюты".

При оплате чека заглушкой можно настроить печать слипа, который находится в /linuxcash/cash/reports/dummyprocessing.xml.