Документ для wiki по подключению MaxBonus в кассовом ПО.
Содержит только требования к настройкам и список используемых API-методов.
Перед началом работы необходимо:
11 (MaxBonus).AdressApiMaxBonusTokenMaxBonusUseMaxBonus = trueAdressApiMaxBonus = https://...MaxBonusOnOff = trueTokenMaxBonus = ...Важно: токен задается именно в локальной конфигурации кассира.
Базовый путь должен вести на контур MaxBonus API.
Рекомендуемый формат:
https://api.maxbonus.ru:<port>В этом случае путь должен корректно резолвиться к API-контру.
Ниже перечислены методы, используемые кассой.
POST customer/auth?phone={phone}
Авторизация по номеру телефона.
POST customer/authqr?qrcode={qrcode}
Авторизация по QR-коду.
POST check
Предварительный расчет чека (скидка, доступные бонусы, начисление).
POST check/write
Финальное проведение чека с учетом скидки и списания бонусов.
POST customer/details?token={customerToken}GET customer/register-request?phone={phone}
Запрос request_token для регистрации.
POST customer
Завершение регистрации клиента по request_token и PIN.
POST check возвращает расчет.POST check/write.Если интеграция не работает, сначала проверить:
UseMaxBonus и MaxBonusOnOff;TokenMaxBonus в локальной конфигурации кассира;AdressApiMaxBonus в глобальных настройках администратора;Частые случаи:
401/403 — неверный или просроченный токен;404 — неверный базовый путь API;