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

Особенности

Epicsplat — универсальное решение для работы с онлайн-платежами и выплатами. API Epicsplat построено на REST-принципах, работает с реальными объектами и обладает предсказуемым поведением. С помощью этого API вы можете отправлять запросы на оплату, сохранять платежную информацию для повторных списаний, совершать возвраты, делать выплаты и многое другое. API в качестве основного протокола использует HTTP, а значит подходит для разработки на любом языке программирования, который умеет работать с HTTP-библиотеками (cURL и другими).

API endpoint: https://api.epicsplat.com/paysystem/v1/

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

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

HTTP Bearer Auth

Данные для аутентификации запросов необходимо передавать в заголовке запроса в параметре Authorization ваш API токен в Epicsplat.

API токен отвечает за безопасность ваших данных. Храните его в защищенном месте и не публикуйте на сторонних ресурсах.

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

cURL

curl https://api.epicsplat.com/paysystem/v1/orders/{order_id} \
    -H "Authorization: Bearer <token>"

Узнать и выпустить API токен (и удалить неактуальный) можно в личном кабинете Epicsplat.

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

Epicsplat обрабатывает полученный запрос немедленно и возвращает результат обработки («успех» или «неудача»). Ответ содержит код ответа HTTP, стандартные заголовки и при необходимости тело ответа в формате JSON. Подробнее о формате ответа Если в течение 30 секунд невозможно дать точный ответ, например из-за неполадок на стороне эквайера, Epicsplat вернет код ответа HTTP 500, а для запросов, связанных с платежами , также попытается отменить операцию. HTTP 500 не говорит об успешности или неуспешности выполнения вашей операции. Поэтому при получении HTTP 500 вам необходимо сначала узнать результат обработки запроса и только после этого принимать любые решения, связанные с этой операцией.