Лояльность для BPMSoft

  1. Главная
  2. Документы
  3. Лояльность для BPMSoft
  4. API процессинга покупок

API процессинга покупок

С помощью этого 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 — Возврат товаров

Статьи

Был ли данный материал полезен вам? Да 3 Нет