Введение

API для взаимодействия с системой начисления и списания бонусных баллов

Протокол предназначен для зачисления и списания бонусных баллов с привязкой к определённой карте.

Сервис работает по протоколу HTTPS. Входные данные принимаются в виде GET/POST-запросов, ответ сервис отправляет в виде сформированного XML. Каждый запрос должен содержать в параметрах два обязательных: логин мерчанта и пароль мерчанта.

Операции зачисления баллов и их списания выполняются в две стадии. Первая стадия – открытие операции с получением уникального идентификатора операции, вторая стадия – подтверждение или отмена открытой операции по полученному уникальному идентификатору операции. В случае указания параметра autocommit=1 при передаче запроса на зачисление, транзакция подтверждается в автоматическом режиме.

Успешность выполнения контролируется исходя из значения аттрибута "code" в элементе "body" ответа сервиса. В случае успеха будет передан "0". При отличном от нуля коде – ответ должен интерпретироваться как оповещающий о сбое при проведении запрошеной операции. Так же в случае сбоя будет заполнен аттрубут "message", содержащий описание сбоя.