Общее описание интеграции с бонусной системой Extrovert
Термины
- Потребитель — система в которую встроена интеграция с бонусным сервером Extrovert
Алгоритм взаимодействия
- При каждом изменении чека, потребитель отправляет на бонусный сервер запрос
на расчет количества доступных бонусов
REST endpoint check.
Формат чека.
- Бонусный сервер на основании данных чека, условий программы, количества
бонусов на карте клиента рассчитывает количество бонусных балов, которые
могут быть списаны на чек и отвечает в
формате бонусного расчета по чеку.
- Потребитель на основании информации из тега
<Max> отображает количество
доступных бонусов к списанию на текущий чек и предлагает клиенту
использовать их для оплаты.
- Если клиент желает использовать все или часть бонусов, потребитель
повторяет запрос
REST endpoint check
с
GET параметром try равным количеству запрошенных к списанию бонусных баллов.
- Бонусный сервер на основании запрошенной суммы списания, данных чека,
условий программы, количества бонусов на карте клиента рассчитывает
количество бонусных балов, которые могут быть списаны на каждую из строк чека
и отвечает в
формате бонусного расчета по чеку
- Перед проведением оплаты потребитель для каждой из строк заказа:
- Сохраняет Значение атрибута “ref” в поле (новое) “код расчета”
- Отнимает из поля “сумма” значение атрибута “useMoney”
- Перед печатью чека потребитель производит проведение операции начисления/списания бонусов:
REST endpoint apply.