Формат взаимодействия с API Амра Касса

Особенности

Амра Касса — универсальное решение для работы с онлайн-платёжами. API построено на REST-принципах, работает с реальными объектами и обладает предсказуемым поведением. С помощью этого API вы можете отправлять запросы на оплату и многое другое.

API в качестве основного протокола использует HTTP, а значит подходит для разработки на любом языке программирования, который умеет работать с HTTP-библиотеками (cURL и другими).

API endpoint: https://kassa.amra-bank.com/api/v1

API поддерживает POST и GET-запросы. POST-запросы используют JSON-аргументы, GET-запросы работают со строками запросов. API всегда возвращает ответ в формате JSON, независимо от типа запроса.

Аутентификация

Для аутентификации запросов необходимо использовать HTTP Basic Auth. В заголовках запросов в качестве имени пользователя необходимо передать ID вашего магазина в Амра Кассе, в качестве пароля — ваш секретный ключ (его нужно сгенерировать).

Пример запроса с аутентификацией

curl https://kassa.amra-bank.com/api/v1/payments \
  -X GET \
  -u <Идентификатор магазина>:<Секретный ключ> \

Узнать идентификатор и выпустить секретный ключ (а также перевыпустить и удалить неактуальный) можно в личном кабинете, в разделе Настроек —> Ключи доступа.

Секретный ключ отвечает за безопасность ваших данных. Храните его в защищённом месте и не публикуйте на сторонних ресурсах (например, вместе с примерами кода).

Обработка запросов

API обрабатывает полученный запрос немедленно и возвращает результат обработки («успех» или «неудача»). Ответ содержит код ответа HTTP, стандартные заголовки и при необходимости тело ответа в формате JSON.

Если в течение 30 секунд невозможно дать точный ответ, например из-за неполадок на стороне эквайера, API вернёт код ответа HTTP 500, а для запросов, связанных с платёжами , также попытается отменить операцию.