Skip to main content

Знакомство с LP Drive

Об LP Drive​

LP Drive (Life POS Drive) — интеграционная библиотека кассовых операций с открытым API для разработчиков ПО ККМ. Библиотека скрывает внутренний протокол обмена с платёжным терминалом и предоставляет единый типизированный интерфейс для полного спектра операций: оплата, возврат, отмена, расчёты СБП, сверка итогов и административные функции.

Термины и определения​

ТерминОпределение
LP Drive (Life POS Drive)Интеграционная библиотека кассовых операций, предоставляющая публичный C API для взаимодействия ПО ККМ с платёжным терминалом.
ККМКонтрольно-кассовая машина — устройство, на котором выполняется ПО партнёра, использующее LP Drive.
IKRТерминальное приложение — программный компонент на стороне платёжного терминала, с которым взаимодействует LP Drive.
DLL / SOДинамическая библиотека (Dynamic-Link Library / Shared Object) — файл поставки LP Drive: lpdrive.dll (Windows) / lpdrive.so (Linux).
APIApplication Programming Interface — набор публичных функций LP Drive, используемых ПО ККМ для вызова кассовых операций.
RRNReference Retrieval Number — уникальный идентификатор транзакции, присваиваемый на хосте банка-эквайера.
PANPrimary Account Number — маскированный номер платёжной карты (например: ************1234).
СБПСистема быстрых платежей.
НСПКНациональная система платёжных карт — оператор СБП.
LPDrive ProtocolВнутренний протокол обмена между LP Drive и терминальным приложением IKR. Скрыт от ПО ККМ публичным API.
ЭквайерБанк или платёжная организация, обрабатывающая транзакции на стороне хоста.
ISO 4217Международный стандарт кодов валют. Код российского рубля: 643.
ACKAcknowledgement — подтверждение доставки сообщения в протоколе LPDrive.

Поддерживаемые платформы и типы устройств​

Типы поддерживаемых устройств​

  • Терминалы с ПО ККМ под управлением Windows или Linux
  • Контрольно-кассовые машины со встроенным приложением (если ОС совместима с указанными выше)

Требования к среде​

КомпонентТребование
ОСWindows или Linux
Транспортный канал к терминалуCOM-порт или TCP/IP
Кодировка строкUTF-8
Доступное дисковое пространствоНе менее 200 МБ для библиотеки и логов

Подключение и развёртывание​

LP Drive разработана для встраивания в состав кассового программного обеспечения. Развёртывание не требует установщика, системных прав или регистрации компонентов.

Способ поставки​

LP Drive поставляется в виде динамической библиотеки (shared library):

  • Windows: lpdrive.dll
  • Linux: lpdrive.so

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

История изменений​

ВерсияДатаОписание
1.030.04.2026Первоначальная редакция документа. Описание публичных методов кассовых операций, форматов сообщений и обработки ошибок.
1.103.06.2026Добавлена поддержка COM-порта в разделе конфигурации. Обновлены коды ошибок: добавлены NET-016, NET-017, FLW-001, FLW-002. Уточнено описание полей response_code и response_desc в финальном ответе. Расширен раздел конфигурации: добавлены секции Internet Access и управление логами.