Group 65 Вернуться на сайт

Техническое описание типовой интеграции

January 12, 2021 Интеграция API 1 minute, 13 seconds

В этом разделе рассмотрим механизм интеграции, описанный по ссылке: Интеграция — общее описание

1. Клиент скачивает себе электронную карту. В этот момент от сервиса uCards в систему Заказчика поступает запрос на создание клиента — т.к. карта еще не персонализирована, система uCards уведомляет систему Заказчика о том, что создана новая карта и ей присвоен определенный уникальный номер (например, 000023).

От системы uCards отправляется вебхук «passCreated», соответстветственно, необходимо реализовать на стороне системы заказчика приём и обработку такого запроса. То есть, система Заказчика при получении такого запроса должна создать новую запись клиента и присвоить ему указанный номер карты.

2. Клиент персонализирует карту — заполняет на ней свои данные. В этот момент в систему Заказчика из системы uCards отправляется вся информация, предоставленная клиентом.

От системы uCards отправляется вебхук «passPersonalized» — система Заказчика должна обновить в своей БД данные по клиенту с указанным номером карты.

3. При каждой покупке клиент предъявляет карту — продавец сканирует штрих-код (или QR-код) на карте и номер карты отображается в торговом терминале (ровно так же, как это происходит с пластиковыми скидочными карточками).

4. Система Заказчика обрабатывает транзакцию покупки, изменяет баланс клиента и если необходимо — его размер скидки и/или начисленные бонусы. После этого система Заказчика отправляет запрос на сервис uCards с новыми параметрами клиента — и эти параметры отображаются на карте клиента в его телефоне.

Система Заказчика должна отправить запрос в систему uCards на изменение поля (например, поля, в котором содержится значение скидки) — пример можно увидеть на этой странице, п. 4., внутренние поля