С помощью этого API вы можете рассчитывать скидку, запрашивать бонусный баланс, подтверждать покупку, совершать оплату бонусными баллами, совершать возвраты и тд.
В качестве основного протокола используется HTTP, а значит, подходит для разработки на любом языке программирования, который умеет работать с HTTP-библиотеками. API процессинга является RPC и использует POST-запросы с телом в JSON формате. API всегда возвращает ответ в формате JSON.
Более подробное описание методов API доступно по ссылке:
https://app.swaggerhub.com/apis-docs/Samarasoft/Samarasoftloyalty/v1#
Аутентификация
Для аутентификации запросов используется Http Bearer Auth — реализация аутентификации по токену (HTTP Bearer token). Для аутентификации с помощью токена нужно передать его в http заголовке Authorization. Например:
Authorization: Bearer FFFF70it7tzNsHddEiq0BZ0i-OU8S3xV
Токен доступа настраивается в файле конфигурации или через переменные окружения сервиса процессинга в параметре API_AUTH_TOKEN.
Ошибки
Если в процессе обработки запроса произойдет ошибка, API вернет объект ошибки и стандартный HTTP-код.
HTTP-коды, используемые в API
200 — Успешный запрос.
400 — Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API.
401 — Неверный токен доступа или отсутствует заголовок Authorization.
500 — На стороне процессинга что-то пошло не так. Результат обработки запроса неизвестен. Обратитесь к системному администратору.
Коды ошибок бизнес логики
shop_not_found — не найдена точка продаж
client_not_found — не найден клиент
card_blocked — карта заблокирована
card_already_activated — карта уже активирована
product_not_found — товар не найден
purchase_already_confirmed — покупка уже подтверждена
not_enough_bonus — не хватает бонусных баллов для оплаты
purchase_not_found — покупка не найдена
refund_already_exists — возврат покупки с таким же номером уже существует
Методы
purchase/calculate — Расчет скидки и запрос бонусного баланса
catalog/calculate — Расчет цен в каталоге и на карточке товара
purchase/confirm — Подтверждение покупки
purchase/create — Создание покупки
purchase/update — Обновление покупки
purchase/complete — Завершение покупки
purchase/refund — Возврат товаров