# Банковский терминал ВТБ

> Источник: https://wiki.virtualpos.ru/hc/hardware/pinpad/vtb  
> Обновлено: 2026-10-07  
> Где в программе: Касса → Управление → Настройка оборудования → Банковский терминал

Как подключить к кассе банковский терминал ВТБ, работающий через программу Arcus2: что должно быть установлено на кассовом компьютере, как настроить кассу и проверить оплату.

## Общее описание

Терминал ВТБ подключается к кассовому компьютеру и работает под управлением программы **Arcus2**, которую устанавливает банк. Касса обращается к терминалу через службу [VirtualPos Hardware Bridge](https://wiki.virtualpos.ru/hc/hardware/hwbridge): служба запускает Arcus2, а Arcus2 управляет терминалом и связывается с банком.

- **Тип терминала на кассе** — «ВТБ» (в панели управления — «ВТБ24»)
- **Что нужно на кассовом компьютере** — Windows, программа Arcus2 в папке `C:\Arcus2`, служба Hardware Bridge
- **Что настраивается на кассе** — Только адрес службы Hardware Bridge и печать слипов. Порт терминала и связь с банком настроены в Arcus2

> **Примечание:**
> **Подсказка.** Если ваш терминал ВТБ работает через программу INPAS DualConnector, а не через Arcus2, подключайте его по инструкции [Банковский терминал INPAS](https://wiki.virtualpos.ru/hc/hardware/pinpad/inpas).

## Порядок подключения

1. **Терминал** — Банк устанавливает на кассовый компьютер программу Arcus2, подключает терминал и проводит проверочную операцию.
1. **Hardware Bridge** — Установите службу VirtualPos Hardware Bridge на тот же компьютер.
1. **Настройка кассы** — Выберите тип терминала «ВТБ» и укажите адрес службы.
1. **Пробная оплата** — Проведите оплату на небольшую сумму, возврат и закрытие смены.

## Программное обеспечение терминала

Arcus2 устанавливает и настраивает инженер банка или его сервисной организации: подключает терминал, загружает параметры и ключи.

> **Важно:**
> **Внимание.** Arcus2 должен быть установлен в папку `C:\Arcus2` — служба Hardware Bridge ищет его только там. Попросите инженера банка не менять папку установки.

Служба использует три файла:

- `C:\Arcus2\CommandLineTool\bin\CommandLineTool.exe` — Программа, которой служба передаёт команду: оплата, возврат, отчёт
- `C:\Arcus2\output.dat` — Результат операции: код ответа, сведения о карте, текст ошибки
- `C:\Arcus2\cheq.out` — Текст слипа или отчёта, который печатает касса

У пользователя Windows, под которым запущена служба, должны быть права на запуск программы и чтение этих файлов.

## Настройка на кассе

1. Установите [VirtualPos Hardware Bridge](https://wiki.virtualpos.ru/hc/hardware/hwbridge) и убедитесь, что служба отвечает.
1. На кассе откройте **Управление → Настройка оборудования**, раздел **«Банковский терминал»**.
1. В поле **«Тип терминала»** выберите **«ВТБ»**.
1. Заполните параметры.

![Настройка терминала ВТБ на кассе](https://wiki.virtualpos.ru/_media/hc/hardware/pinpad/vtb/settings.png)

1. Нажмите **«Сохранить»**. Касса перезагрузится.

- **IP-адрес сервера** — Адрес компьютера со службой Hardware Bridge. Если служба на том же компьютере, на котором открыта касса, — `127.0.0.1`. Если служба работает не на порту 8080, допишите порт через двоеточие: `127.0.0.1:8093`
- **Пустые строки перед отрезкой** — Сколько пустых строк протянуть после слипа перед отрезкой: от 0 до 9. Увеличьте, если нож режет слип по тексту
- **Количество слипов** — Сколько копий слипа печатать: от 1 до 5

> **Права доступа:**
> Изменять настройки оборудования может пользователь с правом `pos.settings.update`.

## Проверка

1. Пробейте чек с оплатой картой на небольшую сумму. Терминал должен попросить карту, после оплаты касса печатает слип и чек.
1. Оформите по этому чеку [возврат](https://wiki.virtualpos.ru/hc/pos/op_refund).
1. [Закройте смену](https://wiki.virtualpos.ru/hc/pos/op_zreport#закрытие_смены): касса покажет отчёт терминала, а на терминале выполнится сверка итогов.

Кнопки проверки у терминала в настройках кассы нет. Если оплата не проходит, сначала проверьте терминал средствами банка: если и там операция не выполняется, причина не в кассе.

## Что касса делает с терминалом

- **Оплата** — Передаёт сумму на терминал и ждёт, пока покупатель приложит карту и введёт ПИН-код. Слип печатается на принтере кассы, затем печатается чек
- **Возврат** — При [возврате по чеку](https://wiki.virtualpos.ru/hc/pos/op_refund), оплаченному картой, отправляет на терминал возврат на ту же сумму со ссылкой на исходную оплату
- **Отмена оплаты** — Если после оплаты картой чек напечатать не удалось, кассир может отменить операцию — см. [Если чек не напечатался](https://wiki.virtualpos.ru/hc/pos/payment#если_чек_не_напечатался). На терминале ВТБ отмена выполняется как возврат
- **Закрытие смены** — Запрашивает краткий отчёт терминала — он показан на шаге ввода безналичной выручки — и выполняет сверку итогов с банком, см. [Смена и отчёты](https://wiki.virtualpos.ru/hc/pos/op_zreport)

Текст слипа и отчётов формирует Arcus2, касса печатает его без изменений.

## Частые ошибки

Если терминал отклонил операцию, касса показывает под заголовком ошибки текст, который вернул Arcus2: причину отказа сообщает терминал или банк.

| Сообщение | Причина | Что делать |
| --- | --- | --- |
| Текст отказа от терминала | Терминал или банк отклонил операцию: недостаточно средств, отмена на терминале, нет связи с банком | Повторите операцию. Если повторяется — обратитесь в банк |
| Ошибка при возврате средств по банковскому терминалу | Терминал или банк отклонил возврат | Под заголовком — описание от терминала. Повторите возврат или выполните его на терминале вручную |
| Внутренняя ошибка системы при оплате по банковской карте. | Касса не получила ответа от службы Hardware Bridge | Проверьте, что служба запущена, и адрес в настройках кассы — см. [Связь с оборудованием](https://wiki.virtualpos.ru/hc/pos/faq#связь_с_оборудованием) |

## Связанные разделы

- [Банковские терминалы](https://wiki.virtualpos.ru/hc/hardware/pinpad) — Типы терминалов и общие параметры
- [Банковский терминал INPAS](https://wiki.virtualpos.ru/hc/hardware/pinpad/inpas) — Терминалы, работающие через DualConnector
- [VirtualPos Hardware Bridge](https://wiki.virtualpos.ru/hc/hardware/hwbridge) — Служба для работы с оборудованием
- [Оплата чека](https://wiki.virtualpos.ru/hc/pos/payment) — Оплата банковской картой и действия при сбое печати
- [Возврат](https://wiki.virtualpos.ru/hc/pos/op_refund) — Возврат на банковскую карту
- [Смена и отчёты](https://wiki.virtualpos.ru/hc/pos/op_zreport) — Отчёт терминала и сверка итогов
