SetRetail10 ◾️ Сервис оплаты ПроЗапас Локо

Публичное пространство

SetRetail10 ◾️ Сервис оплаты ПроЗапас Локо

MMTR-1 - Получение подробных данных проблемы… СТАТУС

SRTZ-3548 - Получение подробных данных проблемы… СТАТУС

CR-11715 - Получение подробных данных проблемы… СТАТУС

10.4.8.0

Описание

ПроЗапас - удобный современный сервис для покупки товаров в магазине с помощью возобновляемого денежного лимита.

В рамках SetRetail это плагин интеграции с платежным сервисом, в котором реализованы следующие возможности:

  • оплата по QR-коду в мобильном приложении Локо-Банка;

  • отмена платежа в процессе оплаты;

  • возврат по чеку;

  • перезапросы оплаты при потере связи на кассе.

Подробное описание возможностей платежного сервиса в презентации Прозапас Локо Банк.pdf.

Ценность

Для покупателя:

  • Быстрое открытие лимита - не более 1 минуты.
  • Лимитом можно пользоваться на постоянной основе.
  • Бесконтактная оплата товаров (без пластиковой карты).
  • Гибкость управления лимитом: выбор даты, суммы и срока платежа.
  • Размещение промо-акций от магазинов-партнеров в сервисе "ПроЗапас".

Преимущества сервиса для партнёра:

  • Экономия на эквайринге.
  • Рост среднего чека за счёт полученного лимита.
  • Увеличение повторных продаж.
  • Цифровая витрина магазина с промо-акциями в мобильном приложении Локо-Банка.
  • "ПроЗапас" - канал привлечения новых покупателей.

Примеры работы

Оплата всего чека

1. Кассир добавляет товары в чек → нажимает → выбирает тип оплаты Оплата ПроЗапас Локо.

2. Кассир подтверждает сумму оплаты и нажимает ОПЛАТИТЬ.

3. Касса выводит сообщение "Отсканируйте QR-код покупателя".

4. Покупатель формирует QR-код в приложении Локо Мобайл.

5. Кассир сканирует QR-код.

6. Касса направляет в процессинг банка запрос TrancheCreateRequest на транш.

7. Касса получает успешный ответ на запрос (код ошибки 0).

8. Покупатель в мобильном приложении подтверждает оплату.

9. Касса направляет запрос статуса транша TranсheStatusRequest.

  • Если в ответе в поле status значение 6 - касса циклично повторяет запрос TranсheStatusRequest до получения финального успеха/ошибки, либо пока кассир не нажимает Отмена.

10. Касса получает успешный ответ на запрос (код ошибки 0) И в поле status значение 4.

11. Касса регистрирует чек.

Пример сценария возврата

Полный возврат

1. Кассир инициирует возврат по чеку.

2. Выбирает Возврат всего чека.

3. Сканирует позиции к возврату.

4. Переходит к оплатам.

5. Кассир выбирает возврат с помощью ПроЗапас Локо.

6. Касса направляет запрос TrancheRefundRequest.

7. Касса получает положительный ответ, в поле error код ошибки равен 0, то запрос прошел успешно.

8. Касса направляет запрос статуса транша TranсheStatusRequest.

9. Касса получает успешный ответ на запрос (код ошибки 0) И в поле status значение 5 или 8.

10. Касса регистрирует чек возврата.

Ограничения

  • Произвольный возврат данным типом оплаты не поддерживается.

Настройка

На сервере

1. На сервере SetRetail/SetCentrum перейдите в раздел Интеграция → Внешние процессинги → кликните .

2. Введите в строке поиска локо → кликните Платежные системы → установите флажок  Оплата ПроЗапас Локо → кликните .

3. Кликните по процессингу Оплата ПроЗапас Локо.


4. Введите необходимые настройки на вкладке ОБЩИЕ.

ПараметрОписание
Адрес подключения *

Адрес подключения к процессингу

Пример: https://pos-cristalapi-test.lockobank.ru:4447

Токен авторизации *Токен авторизации в сервисе. Предоставляется банком
Идентификатор кассового ПО в Банке *Идентификатор кассового ПО в банке (параметр partnerId в запросе)
Идентификатор торговой сети *Идентификатор торговой сети (параметр marketChainId в запросе)
Таймаут соединения (сек., по умолчанию: 3)Время соединения с сервисом при попытке оплаты.
Таймаут ожидания ответа (сек., по умолчанию: 5)Время ожидания ответа от сервиса после инициализации оплаты.
Количество попыток для запроса (по умолчанию: 5)Количество попыток запроса

Минимальная сумма оплаты 

Минимально допустимая сумма оплаты. 

Значение по умолчанию - 500 руб.

Установка минимальной суммы менее 500 руб. не допускается, так как на стороне банка установлено ограничение на сумму 500 р, и при попытке оплаты заказа с меньшей суммой сервис вернет ошибку.

5. На вкладке ОПЛАТА ПРОЗАПАС ЛОКО установите дополнительные флажки настроек, если требуется → кликните .

ПараметрОписание
требует пропорциональный возвратПри возврате позиций чека, оплаченного смешанной оплатой, типы оплат будут пропорционально распределены между возвращаемыми позициями.
частичный возврат чека запрещенРазрешен только возврат чека полностью.
допускать запрет других типов оплатФункциональность не поддерживается в данной версии плагина.
код оплаты для передачи в систему событийКод оплаты для передачи в систему событий.
возвращать дополнительными способами вместо плагинаПри оформлении возврата чека, оплаченного с помощью ПроЗапас Локо, денежные средства могут быть возвращены только выбранными типами оплат из списка. Возврат через ПроЗапас Локо недоступен.

Дополнительные способы возврата, доступные всегда

Если включена "возвращать дополнительными способами вместо плагина", то этот список используется вместо плагина. Выбранные типы оплат должны быть разрешены в настройках шаблона кассы.

Список типов оплат, всегда используемых для выполнения возврата в дополнение к ПроЗапас Локо.

Способы возврата, дополнительно доступные по решению плагина

Если включена "возвращать дополнительными способами вместо плагина", то этот список не применяется. Выбранные типы оплат должны быть разрешены в настройках шаблона кассы.

Список типов оплат, используемых для выполнения возврата при невозможности завершить возврат плагинным типом оплаты.

Функциональность не поддерживается в данной версии плагина.

6. Перейдите в Кассовый модуль → Шаблоны касс → кликните требуемый шаблон.

7. Перейдите на вкладку ПРОЦЕСС ТОРГОВЛИ → НАСТРОЙКИ → в секции Типы оплат установите флажок  Оплата ПроЗапас Локо → кликните .


Экспорт в ERP

Экспорт в ERP-системы осуществляется в соответствии с интеграционной документацией:

Экспорт чека продажи

<purchase ...> 

  • <payments>
    • lokobankqr.payment.plugin - плагин оплаты ПроЗапас Локо
      • lokobankqr.application.id - идентификатор запроса на транш
  • </payments>


<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="111" userName="Админ a дмин" operationType="true" cashOperation="INCOME" operDay="2024-09-30+03:00" shop="8203" cash="62" shift="1" number="3" saletime="2024-09-30T14:59:55.267+03:00" begintime="2024-09-30T14:58:38.980+03:00" amount="53.23" discountAmount="0.00" factorynum="1234567890-0" inn="7802781104" kpp="780201001" qrcode="t=20240930T1459&s=53.23&fn=4298995562182866&i=5&fp=0&n=1" fiscalDocNum="5;3" status="REGISTERED" cashType="TOUCH_2" fiscalnum="NFM.8203.62.0.1727686241229">
        <plugin-property key="externalSystemId" value="82030621727697546883"/>
        <plugin-property key="PROMO_PRINT_DISABLED" value="true"/>
        <plugin-property key="FN_DOC_NUM_IN_SHIFT" value="3"/>
        <plugin-property key="FISCAL_DOC_ID" value="5"/>
        <plugin-property key="CASHIER_NAME" value="Админ a дмин"/>
        <plugin-property key="UID_PURCHASE" value="91493690-66e0-4c2c-9211-be4f29b0639e"/>
        <plugin-property key="KPP" value="780201001"/>
        <plugin-property key="CASH_TIME_ZONE" value="+03:00"/>
        <positions>
            <position order="1" departNumber="1" goodsCode="00004" barCode="4600004000004" count="1.000" cost="53.23" nds="20.0" ndsSum="8.87" discountValue="0.00" costWithDiscount="53.23" amount="53.23" dateCommit="2024-09-30T14:58:39.006+03:00" insertType="3">
                <plugin-property key="countryName" value="Бельгия"/>
                <plugin-property key="ffdTag2108"/>
                <plugin-property key="salesTax" value="0"/>
                <plugin-property key="minimalPrice" value="-1"/>
            </position>
        </positions>
        <payments>
            <payment order="1" typeClass="lokobankqr.payment.plugin" amount="53.23" description="Оплата QR ЛокоБанк">
                <plugin-property key="lokobankqr.application.id" value="109"/>
            </payment>
        </payments>
    </purchase>
</purchases>

Статьи по теме


© 1994-2025, ООО «Кристалл Сервис Интеграция».
Все права защищены.

Политика обработки персональных данных