¶ NFC метки
Оплата NFC -метками на терминале Vendista: https://rutube.ru/video/d75ccd626e2c00d46d0bd28cf11a924a/
NFC метка - устройство позволяющее хранить и передавать некоторое значение (идентификатор) по технологии NFC.
Некоторые сборки терминалов Vendista (на момент написания инструкции сборки 113, 115, 116, 117, 121 - прошивка TuganPay, v87 и выше, сборки 128, 130,132 - прошивка версии Tugan Pay “Обновить прошивку” = 0) позволяют считывать NFC метки и выполнять определенные действия, которые владелец терминалов определяет в личном кабинете Vendista.
На момент написания инструкции существует 7 действий, на которые можно привязать одну NFC метку:
- Оплата - оплата товара/услуги через стороннюю систему, например Spirit.
- Обслуживание - сообщить терминалу, что было произведено обслуживание торгового автомата.
- Загрузка - сообщить терминалу, что была произведена загрузка ингредиентов в торговый автомат.
- Инкассация - сообщить терминалу, что была произведена инкассация в торговом автомате.
- Оплата бонусами - оплата товара/услуги при помощи бонусов, которые заранее были созданы для данной метки в разделе бонусов.
- Открыть сервисное меню - открыть на терминале сервисное меню.
- Оплата привязанной банковской картой - оплата товара/услуги через привязанную к метке банковскую карту в системе Paymaster.
¶ Настройка
Настройка производится в разделе NFC метки в личном кабинете Vendista. Каждую метку, как и другие сущности в Vendista можно добавить, изменить или удалить. Для создания метки можно использовать программу NFC tools.
NFC метки должны соответствовать формату банковских карт Classic Mifare использующих стандарт ISO 14443 Type A 13,56 МГц.
Для проверки и тестирования используются:
Mifare Classic 1k, ISO 14443-3A Type A 13,56 МГц. NFC метка NTAG 215 и др.
При добавлении метки обязательно необходимо ввести следующие поля:
- ID - идентификатор метки, представленный в шестнадцатеричном виде. Заполняется без разделителей заглавными буквами. Например, при значении метки AA BB 11 22 или AA:BB:11:22, в идентификатор необходимо ввести значение AABB1122.
- Наименование - наименование метки. Служит для опознавания пользователями, что это за метка. Необходимо исключительно для удобства пользователей.
- Действие - какое действие производить при использовании метки на терминале.
Для настройки действий Обслуживание/Загрузка/Инкассация/Открыть сервисное меню, данных настроек будет достаточно для работы меток.
Если сервисное меню открывается только при работе от аккумулятора, то СМ по метке тоже будет вызываться только при отключенном питании.
Для действий Оплата и Оплата бонусами требуются дополнительные действия.
Для активации NFC Меток используйте команду Режимы бесконтактной оплаты
Отправьте настройку NFC метка со значением 1 = Включить
Теперь для вызова сервисного меню в режиме MDB достаточно коснуться экрана для начала оплаты и поднести метку вызова Сервисного меню.
Если нужно, чтобы терминал распознавал не только NFC метки, но и банковские карты, в первом поле NFC тоже проставьте 1 перед отправкой команды. Далее по аналогии включаем или не включаем другие возможные методы приема оплаты QR-код, Tugan Pay.
¶ Оплата
Реализовать собственную оплату можно воспользовавшись протоколом по ссылке.
При настройки оплаты - есть два дополнительных поля:
- TID - номер терминала, который нужно передать. Необязательное поле. При пустом значении будет передавать номер терминала, на котором произведена оплата. В дальнейшем это поле может быть упразднено за ненадобностью.
- URL - URL шлюза, по которому будет производиться запрос на оплату по используемой метке. Обязательно к заполнению для правильной работы оплаты.
Для действия Оплата - можно создать универсальную метку (метка с пустым идентификатором), т.е. заполнить все обязательные поля кроме поля ID. Данная метка будет работать в том случае, если попытаться оплатить NFC браслетом и в личном кабинете не будет добавлена используемая на терминале метка. В таком случае при оплате меткой будет передана прикладываемая к терминалу метка с параметрами из универсальной метки. Данная возможность позволяет не создавать множество меток для оплаты, а пользоваться только настройками из универсальной метки.
¶ Оплата бонусами
Помимо создания самой метки в разделе NFC браслеты, вам необходимо создать для этой метки бонусный счет. Сделать это можно в разделе бонусы кликнув по кнопке Добавить. При создании бонусного счета в поле Номер карты / ID NFC метки, нужно ввести идентификатор метки, которую вы ввели в разделе NFC браслеты.
После создания бонусного счета перейдите в его редактирование и измените поле Остаток бонусов (в копейках), на тот который требуется. При каждой оплате данный остаток будет уменьшаться на сумму товара/услуги, пока не достигнет суммы, недостаточной для оплаты. Для того чтобы вновь работала метка, необходимо будет увеличить баланс счета повторно.
¶ Оплата привязанной банковской картой
Чтобы включить оплату по банковской карте через NFC метки должны быть соблюдены три условия:
- Настроен QR-провайдер PayMaster NFC Стикеры (СБП). Как это сделать можете прочитать в этой инструкции. Вам необходимо выполнить пт.1 и пт.3 в разделе Личный кабинет paymaster.ru и пт.1. в разделе Личный кабинет p.vendista.ru. Использовать данные стикеры не обязательно в рамках данного вида платежа.
- Вам одобрены рекуррентные платежи у PayMaster. Если нет, обратитесь в PayMaster по данному вопросу.
- У вас настроена универсальная метка (метка с пустым идентификатором) для действия оплата привязанной банковской картой.
Если вы все сделали правильно, то при поднесении новой NFC метки, когда терминал находится в режиме оплаты, терминал получит QR-код с ссылкой на тестовую оплату, необходимую для привязки банковской карты (снимется и вернется обратно на карту 1 рубль). После привязки можно оплачивать NFC меткой без каких либо подтверждений в рамках только ваших терминалов.