Способы оплаты

В режиме оплаты чека отображаются кнопки оплаты. Количество этих кнопок и способы оплаты можно настроить. Эти же способы оплаты дублируются в режиме приветствия покупателя и в окне возврата чека.

По умолчанию кнопки располагаются в одну строку (в теме slim – в одну колонку), относительное расположение также можно изменить настройками.

По умолчанию используются оплаты с типами: cash, bankCard, bonus, giftCard.

Нельзя изменить параметры только одного из способов оплаты по умолчанию. Необходимо указывать сразу все необходимые способы.

Наименование

Возможные значения

Описание

Файл /opt/sst-sco/conf/check.ini, секция [Check.payments.<строка>.<столбец>], настройка типов оплаты

type

  • cash
  • bankCard
  • bonus
  • giftCard
  • qr
  • qrScan
  • deferredCheck
Тип оплаты, обязателен к заполнению.
  • cash – наличными. Если включена, то при нажатии кнопки отображается окно подсказки. Если оплата наличными по каким-либо причинам недоступна, кнопка автоматически скрывается,
  • bankCard – банковской картой по терминалу,
  • bonus – бонусами. Кнопка активна, если возможно выполнить списание бонусов с карты,
  • giftCard – подарочным сертификатом,
  • qr – QR-кодом, отображенным на экране телефона,
  • qrScan – сканированием QR-кода с экрана кассы,
  • deferredCheck – оплата через отложенные чеки.

Для использования оплаты через отложенные чеки необходимо включить плагин deferredCheck в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/deferredcheck.ini в секции [plugins].

code

целое положительное число,
по умолчанию 0 (не используется)

Дополнительный код оплаты. Используется для привязки к типам оплаты в интеграциях. Для Artix – это код валюты.
Для типа cash игнорируется

nameid текста i18n или текстid текста i18n или текст, который отображается в режиме оплаты
welcomeNameid текста i18n или текстid текста i18n или текст, который отображается в приветствии
returnNameid текста i18n или текстid текста i18n или текст, который отображается в режиме возврата
icon
  • абсолютный путь до файла
  • название иконки из параметра темы оформления

Иконка, название из темы оформления или путь до файла

idleTimeoutцелое положительное число,
по умолчанию 0 (не задано)
Таймаут бездействия, в секундах. Позволяет переопределить значение из настройки Sco:idlenessWaitTimeout в момент оплаты. Не используется для оплаты наличными
callAttendant
  • true
  • false (по умолчанию)

Требуется консультант. 

Если настройка включена, то при выборе определенного типа оплаты сработает вызов консультанта для подтверждения оплаты

Файл /opt/sst-sco/conf/check.ini, секция [Check.payments], настройка типов оплаты
vertical
  • true
  • false (по умолчанию)

Разместить кнопки вертикально. Если все типы оплаты размещены в одну строку, то есть в секции не указывается столбец, тогда этой настройкой можно отобразить все оплаты в виде одного столбца.
Если в любой из секций указать столбец, то эта настройка игнорируется.
Эта настройка используется в теме оформления slim

spacingчисловое значение
по умолчанию -1 (не задано)
Расстояние между кнопками в пикселях

Строка и столбец - это числовые значения, которые задают относительный порядок кнопок. Столбец опционален, и если столбец не указан, значит в строке одна кнопка.
В теме оформления slim установлена настройка [Check.payments].

Параметры namewelcomeName, returnName и icon имеют значения по умолчанию для разных типов оплаты:

typenamewelcomeNamereturnNameicon
cashpaymentCashwelcomeCashreturnCashicon.cash
bankCardpaymentBankCardwelcomeBankCardreturnBankCardicon.creditCard
bonuspaymentBonuswelcomeBonusreturnBonusicon.bonusCard
giftCardpaymentGiftCardwelcomeGiftCardreturnGiftCardicon.giftCard
qrpaymentQrwelcomeQrreturnQricon.paymentQr
qrScanpaymentQrScanwelcomeQrScanreturnQrScanicon.paymentQrScan

deferredCheck

paymentDeferredCheckwelcomeDeferredCheckreturnDeferredCheckicon.paymentDeferredCheck

Пример настройки четырех типов оплаты в одну строку (столбец с темой slim)

[Check.payments.1]
type = bankCard
code = 3

[Check.payments.2]
type = bonus

[Check.payments.3]
type = giftCard

[Check.payments.4]
type = qrScan
code = 7
name = Система\nбыстрых\nплатежей
welcomeName = Система быстрых платежей
returnName = Система быстр.\nплатежей

В теме оформления добавляется иконка СБП в подкаталог icons с названием paymentqrscan.png.


Пример настройки вызова консультанта для определенного типа оплаты

[Check.payments.4]
type = deferredCheck
code = 4
callAttendant = true

Пример добавления четырех типов оплаты в две строки

[Check.payments.1.1]
type = bankCard
code = 3

[Check.payments.1.2]
type = bonus

[Check.payments.2.1]
type = qr
code = 5
name = PaymeGO
welcomeName = PaymeGO
returnName = PaymeGO
icon = icon.paymeGo

[Check.payments.2.2]
type = qr
code = 6
name = CLICK PASS
welcomeName = CLICK PASS
returnName = CLICK PASS
icon = icon.clickPass

Если используется два способа оплаты с одинаковым типом, то для иконок потребуется задать полный путь до изображения или добавить новые параметры в тему:

Файл theme.json в теме оформления
{
    "default" : {
        "icon": {
            "paymeGo": "./icons/paymeGo.png",
            "clickPass": "./icons/clickPass.png"
        }
    }
}

В теме оформления в подкаталог icons добавляются иконки paymeGo.png и clickPass.png.

На экране с разрешением 1024x768 по умолчанию две строки способов оплат не влезают. Это можно исправить, добавив в стили темы оформления следующее:

Файл style.qss в теме оформления
#PaymentForm .ActionButton[command="CHECK_ADDPAYMENT"] {
    padding: 10px 15px;
    height: -1;
    width: 220px;
    qproperty-toolButtonStyle: "ToolButtonTextBesideIcon";
    qproperty-textAlignment: "AlignLeft|AlignVCenter";
    qproperty-iconSpacing: 10;
    qproperty-iconSize: 50px;
}

Пример увеличения размера иконок на кнопках

Файл style.qss в теме оформления
#PaymentForm .ActionButton[command="CHECK_ADDPAYMENT"] {
    qproperty-iconSize: 100px;
}

Пример отображения только иконок на кнопках

Файл style.qss в теме оформления
#PaymentForm .ActionButton[command="CHECK_ADDPAYMENT"] {
    qproperty-iconSize: 100px;
    qproperty-toolButtonStyle: "ToolButtonIconOnly";
    padding: 0;
}

Автоматическая оплата чека

Есть возможность автоматически выбирать способ оплаты, если доступна только одна. При этом будет учитываться активность оплат. Например, настроены оплаты по терминалу и бонусами, но списание баллов недоступно (кнопка не активна), тогда будет автоматически выбрана оплата по терминалу. Если списание баллов доступно, тогда покупатель сам выбирает один из способов оплаты.

Наименование

Возможные значения

Описание

Файл /opt/sst-sco/conf/check.ini, секция [Check], настройки модуля чека

autoSinglePayment

  • true
  • false (по умолчанию)
Автоматическая оплата, если доступен только один способ. Если при переходе в оплату доступен только один тип оплаты, то сразу выполняется оплата этим типом

Отображение покупателю кнопки "Отмена" в диалоге оплаты по QR-коду

Настройка showPaymentQrCancel позволяет отображать кнопку "Отмена" в диалоге оплаты по QR-коду.

Наименование

Возможные значения

Описание

Файл /opt/sst-sco/conf/check.ini, секция [Check], настройки модуля чека

showPaymentQrCancel

  • true (по умолчанию)
  • false

Отображение кнопки отмены оплаты QR-кодом покупателю.

Если настройка выключена, то кнопка "Отмена" не отображается покупателю. Для отмены оплаты необходима авторизация консультанта

Отображение ошибок оплаты покупателю

Настройка позволяет отображать ошибки, возникшие при оплате, покупателю вместо консультанта. Не влияет на оплату наличными (cash).

Наименование

Возможные значения

Описание

Файл /opt/sst-sco/conf/check.ini, секция [Check], настройки модуля чека

paymentErrorForCustomer

  • true
  • false (по умолчанию)
Отображать покупателю любые ошибки оплаты
paymentErrorTimeoutцелое положительное число
по умолчанию 5

Таймаут вызова консультанта после отображения ошибки оплаты, в секундах
Для ошибок, отображаемых покупателю по настройке paymentErrorForCustomer или через код ошибки в paymentFailCustomerCodes (в интеграции с Artix)

Если включен контроль веса, то ошибки контроля веса могут быть отложены до закрытия диалога ошибки оплаты.

Принудительное добавление оплаты в режиме редактирования

Возникают ситуации, когда из-за проблем с получением ответа от процессинга оплата завершается с ошибкой, а деньги у покупателя списываются. В таких случаях допускается добавить оплату в чек принудительно через меню редактирования чека.

Отображение кнопки "Добавление оплаты" определяется параметром showAddPaymentInCheckEdit. Код валюты, который будет назначен на кнопку "Добавление оплаты", определяется параметром paymentCodeInCheckEdit.

НаименованиеВозможные значенияОписание
Файл /opt/sst-sco/conf/check.ini, секция [Check], настройки модуля чека
showAddPaymentInCheckEdit
  • true
  • false (по умолчанию)
Отображение кнопки добавления оплаты в режиме редактирования чека
paymentCodeInCheckEdit

целое положительное число
по умолчанию 0

Код валюты при добавлении оплаты в режиме редактирования чека

Для корректной работы необходимо настроить параметр editInForming в положение false в конфигурационных файлах /opt/sst-sco/conf/check.ini и /opt/sst-sco/conf/artix.ini в секции [Check].

После нажатия кнопки оплата будет добавлена в чек. Необходимо перейти в режим формирования и закрыть чек вручную.

Настройки логики чека в интеграции

Наименование

Возможные значения

Описание

Файл /opt/sst-sco/conf/check.ini, секция [Check], настройки модуля чека
bonusDialog
  • true (по умолчанию)
  • false
Отображение диалога оплаты бонусами на стороне SCO
Для корректной работы интеграции установлено false в artix.ini
giftCardDialog
  • true (по умолчанию)
  • false

Отображение диалога оплаты сертификатом на стороне SCO
Для корректной работы интеграции должно быть true 

editInForming

  • true
  • false (по умолчанию)

Возврат в режим формирования перед редактированием чека. При переходе в режим редактирования SCO выполнит возврат в режим формирования
Для корректной работы интеграции должно быть true

При добавлении оплаты в режиме редактирования необходимо, чтобы значение настройки было false.

Запрет оплаты валютой в зависимости от роли пользователя

В Artix:SCO реализован запрет оплаты валютой в зависимости от роли пользователя, подробнее можно прочитать в статье "Запрет оплаты валютой".

  • No labels