Платёжные терминалы (США) — Paloma POS 2

Эта статья про Paloma POS 2 — новую кассу-приложение линейки Paloma — и про приём оплаты картой в США: через терминалы Valor, PAX, Netevia (в том числе с пинпадом), Sunmi/TSYS, ChargeAnywhere и Forte (Ashburn). Здесь же — как в конце дня закрыть батч (партию) по терминалу, где посмотреть историю закрытий и что делать, если терминал не отвечает. Если вы не уверены, какой у вас продукт, начните со статьи «Как понять, что у вас Paloma POS 2». Как принять оплату по заказу в целом — в статье «Оплата заказа».

Обзор

Оплата картой в Paloma POS 2 идёт через платёжный терминал, привязанный к кассе. Касса сама передаёт сумму на терминал, ждёт ответ банка и закрывает чек — вручную вводить сумму на терминале не нужно. Поддерживаются терминалы разных провайдеров:

• «Valor Terminal» — терминал Valor (встроенный SDK или полуинтеграция по WebSocket).
• «Sunmi (TSYS)» — устройство Sunmi с процессингом TSYS.
• «Netevia (cloud)» и «Netevia PinPad» — облачная интеграция Netevia и вариант с отдельным пинпадом.
• «ChargeAnywhere (cloud)» — облачная интеграция ChargeAnywhere.
• «Forte (Ashburn)» — интеграция Forte через Ashburn.
• Терминалы на базе PAX подключаются через соответствующего провайдера (например, Netevia на устройстве PAX).

В конце дня по терминалу закрывают батч (партию) — пакет всех дневных транзакций отправляется в банк на расчёт (settlement). Это отдельная операция от закрытия кассовой смены и Z-отчёта — подробнее в статье «Закрытие смены и Z-отчёт».

Настройка терминала

Терминал добавляет и настраивает администратор один раз:

1. Откройте Настройки → «Платёжные устройства» → «Добавить устройство».
2. Выберите провайдера — «Valor Terminal», «Sunmi (TSYS)», «Netevia (cloud)», «Netevia PinPad», «ChargeAnywhere (cloud)» или «Forte (Ashburn)» — и заполните поля подключения (для Valor — EPI ID и IP; для Netevia — GMID/GTID; для ChargeAnywhere — Terminal ID и Merchant ID).
3. Проверьте связь кнопкой «Проверить подключение»; найти терминал в сети помогает «Найти терминалы в сети».
4. В блоке видов оплаты отметьте, какие способы идут через этот терминал. Если одному способу назначено несколько терминалов, отметьте один звёздочкой «По умолчанию».
5. Если провайдер поддерживает авторасчёт в конце дня, включите «Автосведение» и задайте время — тогда батч будет закрываться сам.

Если в списке пусто, касса покажет «Добавьте платёжный терминал для приёма карт.» А сообщение «Эта сборка не включает SDK платёжного терминала. Переустановите из соответствующего магазина (Sunmi App Store, Valor App Store), чтобы добавить карточный терминал.» означает, что приложение установлено не из того магазина под ваше устройство.

Оплата картой

1. В карточке заказа нажмите «Оплатить чек» → «Карта».
2. Если терминалов несколько, касса покажет «Выберите платёжный терминал» — выберите нужный (по умолчанию помечен «По умолчанию»).
3. Касса передаёт сумму на терминал и показывает «Вставьте карту / обработка...». Дайте клиенту приложить, вставить или провести карту на терминале (или пинпаде для Netevia PinPad).
4. Дождитесь ответа банка. При успехе появится экран «Оплата завершена».

Пока идёт обработка, не убирайте карту и не закрывайте экран. Если терминал отклонил операцию, заказ остаётся открытым — можно повторить оплату, выбрать другой терминал или принять наличные. Частичную и смешанную оплату картой касса тоже поддерживает — см. «Оплата заказа».

Чаевые на терминале

Как терминал спрашивает чаевые, зависит от настройки момента чаевых:

• До оплаты — «Оператор сначала выбирает чаевые; терминал списывает сумму + чаевые.»
• После оплаты — «Терминал сначала списывает заказ; чаевые фиксируются локально после.»

Чаевые входят в дневной итог батча и видны отдельной строкой при закрытии партии.

Закрытие батча в конце дня

В конце рабочего дня по каждому карточному терминалу закрывают батч — это отправляет дневные транзакции в банк на расчёт. Куда зайти:

• Раздел «Смены» → «Закрытие батча».
• Или на экране Z-отчёта — кнопка «Закрыть пакет».
• Или из экрана «История закрытий партий» кнопкой закрытия партии.

Порядок:

1. Запустите закрытие. Если терминалов несколько, касса покажет «Закрыть партию — выберите терминал» — выберите нужный.
2. Касса переспросит «Закрыть партию?» и покажет итог дня — количество заказов, продажи и чаевые.
3. Подтвердите. Касса свяжется с терминалом и рассчитает партию.
4. При успехе появится «Партия закрыта.» (или «Партия закрыта терминалом (ref …).» с номером расчёта) и «Отчёт по партии отправлен на принтер.»

Если оплаченных заказов за день нет, касса покажет «Сегодня нет оплаченных заказов — отчёт пока пуст.» — закрывать нечего. Если включено «Автосведение», терминал закрывает батч сам в заданное время; ручное закрытие тогда не обязательно, но остаётся доступным.

История закрытий батчей

Все закрытия по этой кассе хранятся в разделе «История закрытий партий». По каждому закрытию видны суммы по строкам «Продажи», «Чаевые», «Возвраты» и «Отмены». Сводный отчёт за период открывается из раздела «Смены» → «Отчёт по батчам» с выбором диапазона (сегодня, 7 дней, 30 дней) и конкретного терминала. Это помогает сверить дневную выручку с выпиской банка.

Если терминал не отвечает

Если во время оплаты или закрытия батча терминал не отвечает, касса покажет «Терминал не ответил» с пояснением «Карточный терминал не подтвердил расчёт вовремя. Сверьтесь с собственным отчётом терминала, прежде чем повторять.» Сначала посмотрите отчёт на самом терминале — операция могла пройти на стороне банка. Только убедившись, что списания не было, повторяйте.

Общие шаги, если связь с терминалом теряется:

• Проверьте, что терминал включён и в одной сети Wi-Fi с кассой.
• Проверьте связь кнопкой «Проверить подключение» в настройках устройства или найдите его через «Найти терминалы в сети».
• Если операция «зависла», завершите или отмените её на самом терминале, затем повторите с кассы.
• При сомнении примите оплату наличными и оформите оплату вручную позже.

Частые проблемы

• «Ошибка карточного терминала. Повторите попытку.» — терминал вернул ошибку. Повторите оплату или выберите другой терминал.
• «Карта отклонена. Попробуйте другую карту или оплату наличными.» — банк отклонил карту. Попросите другую карту или примите наличные.
• «Тайм-аут карточного терминала. Проверьте устройство или отчёт по партии перед повтором.» — терминал не ответил вовремя. Сверьтесь с его отчётом, прежде чем повторять, чтобы не списать дважды.
• «Терминал недоступен. Проверьте устройство или оплату наличными.» / «Оплата картой не прошла: терминал не в сети» — касса не видит терминал в сети. Проверьте питание и Wi-Fi; деньги не списаны — повторите или примите наличные.
• «Приём платежей на терминале заблокирован. Проверьте, что поверх интеграции не запущена Kaspi Kassa, или напишите нам — подключится специалист провайдера.» — на терминале работает стороннее приложение поверх интеграции. Закройте его или обратитесь к провайдеру.
• «Терминал не завершил предыдущую операцию. Завершите или отмените её на устройстве и повторите.» — на терминале осталась незакрытая операция. Завершите её на устройстве и повторите с кассы.
• «Оплата картой отменена.» — операцию отменили на терминале. Заказ остался открытым — повторите оплату.
• «Терминал не ответил» / «Сбой расчёта» при закрытии батча — партия не закрылась. Сверьтесь с отчётом самого терминала и повторите; при повторной ошибке напишите нам — подключится специалист.
• «Сегодня нет оплаченных заказов — отчёт пока пуст.» — за день не было карточных оплат, закрывать батч не нужно.

FAQ

Чем закрытие батча отличается от закрытия смены?

Закрытие смены — кассовая операция: касса проверяет чеки, печатает Z-отчёт и завершает рабочий день (см. «Закрытие смены и Z-отчёт»). Закрытие батча — операция по банковскому терминалу: пакет дневных карточных транзакций уходит в банк на расчёт. Это разные шаги; обычно батч закрывают тоже в конце дня.

Нужно ли закрывать батч вручную каждый день?

Если у терминала включено «Автосведение», он закрывает батч сам в заданное время. Иначе закрывайте вручную из раздела «Смены» → «Закрытие батча» или кнопкой «Закрыть пакет» на экране Z-отчёта.

Списались ли деньги, если терминал не ответил?

Возможно, да — ответ мог потеряться уже после списания. Сначала посмотрите отчёт на самом терминале или в разделе «История закрытий партий», и только убедившись, что списания не было, повторяйте. Об этом же предупреждает сообщение «Карточный терминал не подтвердил расчёт вовремя…».

Где посмотреть суммы по закрытым партиям?

В разделе «История закрытий партий» — по каждому закрытию видны «Продажи», «Чаевые», «Возвраты» и «Отмены». Сводка за период — в «Отчёте по батчам» раздела «Смены».

Как принять оплату, если карта не проходит?

Попробуйте другую карту или примите наличные — заказ остаётся открытым, пока не закрыт весь остаток. Частичную и смешанную оплату (часть картой, часть наличными) касса поддерживает; порядок — в статье «Оплата заказа». Итоги по кассе за смену — в «Отчёте по кассе».