Подключение эквайринга

> Сервер оборудования
Дата обновления: 20 октября 2026 г. Дата публикации: 20 октября 2026 г. Автор: Машковцев Тимур

Перед добавлением эквайрингового терминала в Сервер оборудования убедитесь, что на компьютере есть каталог UPOS Сбербанка (sb_pilot) с файлом pinpad.ini, а сам пинпад подключён к компьютеру через COM-порт либо доступен по сети; при добавлении создаётся карточка терминала, в которой указываются название, параметры связи с пинпадом и путь к каталогу UPOS, и от корректности этих данных зависит возможность проведения оплат по банковским картам.

Каталог UPOS предоставляет банк. Распакуйте его в отдельную папку, например C:\sb_pilot в Windows или /opt/sb_pilot в Linux.
- В Windows Сервер оборудования работает через библиотеку pilot_nt.dll. Если её нет в каталоге UPOS, используется библиотека, поставляемая вместе с сервером.
- В Linux сервер запускает программу sb_pilot из каталога UPOS. У файлов sb_pilot и upnixmn.out должно быть право на запуск (chmod +x), а у службы — право на запись в каталог (sudo chown -R deviceserver <каталог>). Если записать в каталог нельзя, сервер работает с его копией в /opt/sb_pilot.

Откройте раздел «Эквайринг» в боковом меню. В таблице отображаются добавленные терминалы, способ подключения, путь к каталогу UPOS и данные лицензии: серийный номер, срок действия, доступ к обновлениям и примечания о состоянии лицензии (например, «Демо»). Нажмите «Добавить», чтобы открыть форму добавления.

Параметр	Описание
Название устройства	Уникальное имя терминала. Отображается в интерфейсе и используется в пути API-запросов к этому устройству, например `/api/v1/acquiring/{имя}/…`. Обязательное поле.
Тип подключения	Способ подключения к пинпаду: «TCP» или «COM». Обязательное поле.
Путь к pinpad.ini или каталогу UPOS	Каталог UPOS или полный путь к файлу `pinpad.ini` в нём, например `C:\sb_pilot` (Windows) или `/opt/sb_pilot` (Linux). Обязательное поле.
Единица суммы	В каких единицах кассовое ПО передаёт сумму операции: «Рубли» (например, `150.50`) или «Копейки» (например, `15050`). По умолчанию — «Рубли».
Банк-эквайер	Идентификатор банка-эквайера для настроек терминала и отчётов. Заполняйте по документации банка, если требуется. Необязательное поле.
Эмитент	Идентификатор банка-эмитента карты. Нужен, только если эквайер или банк требует отдельно указать эмитента. Необязательное поле.
Номер мерчанта	Номер отдела (мерчанта) на пинпаде, от 0 до 14. Если поле пустое, используется отдел по умолчанию, заданный на терминале. Номер мерчанта, переданный в запросе на операцию, имеет приоритет над этим значением.

Единица суммы выбирается из списка. Она должна совпадать с тем, как кассовое ПО передаёт суммы в запросах: при неверном значении сумма операции на пинпаде будет в 100 раз больше или меньше ожидаемой.

Типы подключения

Параметры подключения, указанные в форме, Сервер оборудования сам записывает в pinpad.ini: для TCP — PinpadIPAddr и PinpadIPPort, для COM — ComPort и Speed. Параметры другого типа подключения в файле комментируются. Остальные настройки pinpad.ini сервер не изменяет.

Выберите «TCP», затем укажите параметры сетевого подключения.

Параметр	Описание
Тип подключения	Выберите значение «TCP».
IP адрес	Укажите сетевой адрес пинпада в формате IPv4, например `192.168.1.202`.
Порт	Укажите номер TCP-порта пинпада — число от 1 до 65535, например `8888`.

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

Параметр	Описание
Тип подключения	Выберите значение «COM».
COM порт	Выберите порт пинпада из списка COM-портов, доступных на компьютере с Сервером оборудования. Если портов нет, в поле отображается «Нет доступных портов».
Скорость COM порта	Выберите скорость обмена между компьютером и пинпадом — от 110 до 256000 бод, например `115200`. Значение должно соответствовать настройкам пинпада.

Нажмите «Добавить», чтобы сохранить терминал. После сохранения сервер подключается к пинпаду и считывает его параметры.

Редактирование терминала

Чтобы изменить параметры, активировать лицензию или удалить терминал, нажмите на строку терминала в таблице. Форма редактирования содержит три вкладки.

Модальное окно редактирования устройства эквайринга

На вкладке «Подключение» находятся те же параметры, что и при добавлении. После нажатия «Сохранить» сервер переподключается к пинпаду с новыми параметрами. Кнопка «Удалить» удаляет терминал.

На вкладке «Лицензия» лицензия активируется для терминала. Лицензия привязывается к идентификатору терминала, поэтому перед активацией пинпад должен быть на связи.

Параметр	Описание
Пинкод	Пинкод лицензии. Введите его и нажмите «Активировать».

При первой активации может открыться «Регистрационная анкета». Заполните контактные данные: телефон, рабочий телефон, страну, регион и город. Если сервер лицензирования запросит полную регистрацию, также укажите ИНН, организацию, адрес и Email, после чего снова нажмите «Активировать».

После активации на вкладке отображаются серийный номер, тип лицензии, организация, ИНН организации, срок действия и дата, до которой доступны обновления. Кнопка «Деактивировать» отвязывает лицензию от терминала.

Без активной лицензии терминал работает в демо-режиме: оплаты и другие операции списания на сумму больше 100 рублей отклоняются. Возвраты и отмены не ограничиваются. Если до окончания лицензии осталось 7 дней или меньше, предупреждение об этом печатается на слипе.

На вкладке «Состояние» отображаются параметры, полученные от пинпада. Если параметры не отображаются, проверьте связь с пинпадом и настройки подключения.

Параметр	Описание
Идентификатор терминала	Идентификатор терминала (TID), считанный с пинпада.
Банк-эквайер	Идентификатор банка-эквайера.
Эмитент	Идентификатор банка-эмитента.
Печать слипа на терминале	Печатает ли пинпад слип самостоятельно: «Да» или «Нет».
Частичная отмена	Поддерживает ли терминал частичную отмену операции: «Да» или «Нет».