ошибки оплаты бонусами

Ошибки оплаты бонусами на кассе iiko

Раздел охватывает ошибки, возникающие при добавлении и проведении типа оплаты «Бонусы ПЛ» (платёжная система Remarked) на кассе iiko: отсутствие типа оплаты, нефискальная оплата, конфликты ревизий заказа, лицензионные и инициализационные ошибки.


Не настроен тип оплаты «Бонусы ПЛ»

Симптом. На кассе отсутствует или не срабатывает тип оплаты «Бонусы ПЛ».

Причины и решение.

  1. Выключен плагин. Перезагрузить кассу либо запросить видео с авторизацией гостя.
  2. Гость не авторизован в заказ, а пытаются применить тип оплаты. Запросить видео авторизации гостя. Если авторизация есть, а ошибка осталась — снять логи.

В логах проверить, прошла ли авторизация гостя, обратив внимание на методы:

  • guest/get — запрос информации о госте;
  • order/update — обновление заказа.

«Для оплаты "Бонусы ПЛ" установлен минимальный порог...»

Симптом. При оплате появляется сообщение об установленном минимальном пороге.

Причина. Клиент сначала ввёл сумму через окно нашего типа оплаты, а затем изменил её на циферблате справа. Так делать нельзя.

Решение. Удалить тип оплаты «Бонусы ПЛ» из оплаты и добавить заново.


Нефискальная оплата

Симптом. Появляется предупреждение:

В заказ добавлена нефискальная оплата. Добавление фискальной оплаты не...
Вы хотите удалить данные оплаты?
RemarkedLoyalty_ - 2421 руб. 00 коп.

Решение. Поставить в настройках типа оплаты галочку «Проводить как скидку» или «Фискализировать как скидку»:

  • «Фискализировать как скидку» — тип оплаты можно комбинировать с нефискальной предоплатой; в OLAP-отчётах отображается как тип оплаты.
  • «Проводить как скидку» — уменьшает стоимость заказа на сумму платежа, позволяет комбинировать с другими фискальными типами оплаты; платёж уходит в ОФД как скидка и в OLAP-отчёте отображается как скидка.

«Ошибка при добавлении типа оплаты Remarked payment!»

Симптом.

Ошибка при добавлении типа оплаты Remarked payment!
Error converting value {null} to type 'System.Int32'. Path 'error.code', line 1, position 37.

Решение. Снять лог с терминала и направить на разбор в отдел ПЛ (оформить задачу по инструкции «Оформление задачи в ПЛ»).


Ошибка «Ревизий заказа» при оплате бонусами

Симптом. При оплате бонусами через платёжную систему Remarked:

Сущность Resto.Front.Api.V8.Data.Orders.Order была изменена до выполнения текущего действия.
Ожидаемая версия: 5884614. Фактическая версия: 5884616.

Причина. Конфликт версий сущности заказа:

  • параллельное изменение заказа другим процессом или кассиром;
  • гонка потоков (race condition) в плагине.

Решение. Не вносить параллельные правки в заказ во время оплаты; повторить операцию. При повторении — снять лог и передать в отдел ПЛ.


Ошибка типа оплаты — ArgumentNullException

Симптом.

System.ArgumentNullException: Значение не может быть неопределённым.
Имя параметра: ChangePaymentItemSum.PaymentItem

Решение. Проверить тип оплаты в настройках. Убедиться, что «Бонусы ПЛ» присутствует в таблице loyalty_payment_types.


Ошибка при инициализации оплаты — «Не удалось прочитать из IPC-порта, канал был закрыт»

Симптом. При инициализации оплаты типом «Бонусы ПЛ» (платёжная система Remarked): «Не удалось прочитать из IPC-порта, канал был закрыт. Обратитесь к администратору...».

Причина. Это внутренняя ошибка iiko.

Решение. Предварительно уточнить у дилера iiko. Попробовать перезагрузить терминал, либо направить клиента к дилеру iiko.


Ошибка лицензий

Симптом.

Ошибка: плагин BeOpen.Front.RemarkedJsonRpc_v2_20250617 — нет действующей лицензии

iikoFront пытается использовать плагин BeOpen.Front.RemarkedJsonRpc_v2_..., но для него отсутствует действующая лицензия.

Решение. Направить клиента к дилеру для проверки активности лицензии:

API Payment Connector — ID: 21016318