Введение
Форма оплаты счета
Формирование формы
Счета
Создание счета на оплату
Получение платежных данных
Проверка текущего статуса счета
Получение выписки
Выплаты
Создание выплаты
Проверка возможности выплаты
Выполнение выплаты
Проверка статуса платежа
Получение выписки
Запрос текущего баланса
API для разработчика
Введение

Описание взаимодействия со шлюзом

Взаимодействие производится с использованием протокола HTTP over TCP/SSL.

Инициатором соединения всегда является только клиент платежной системы. Для каждого запроса создается новое соединение. Клиент имеет возможность создавать одновременно несколько соединений для разных платежей.

Каждому виду запроса соответствует определенный URI. Все запросы осуществляются методом POST. Не зависимо от типа, в каждом запросе передается два HTTP‐заголовка: DPAY_CLIENT и DPAY_SECURE. Данные внутри сообщения POST передаются способом: application/json. В любом случае обязательна передача заголовка Content-type: application/json в POST‐запросе. Домен для передачи запросов https://acquiring_api.obmenka.ua. Эндпоинты для конкретных типов запросов описаны ниже (например, https://acquiring_api.obmenka.ua/api/payment/balance)

DPAY_CLIENT - идентификатор клиента, номер кассы, соданной в личном кабинете.

DPAY_SECURE - подпись запроса (подпись формируется по телу запроса). Подпись запроса формируется по схеме base64_encode(md5($salt . base64_encode(sha1($data, true)) . $salt, true)), где salt - секрет из настроек кассы, а data - тело запроса.

Каждый ответ шлюза тоже имеет подпись, переданную в заголовке DPAY_SECURE.

HTTP‐параметр request содержит тело запроса в виде JSON-массива в кодировке UTF-8.

Тестовый данные

при выставлении счета или создании выплаты на 1000 операция всегда успешная.

при выставлении счета или создании выплаты на 2000 операция всегда не успешная.

Описание структуры запросов и ответов шлюза

Тело запроса передается в виде массива, сериализованного в формат JSON

Пример:
{"tracking": "1234"}

Ответ имеет аналогичную структуру.

В случае отказа в выполнении запроса будет возвращена ошибка с ее кодом и описанием.

Пример:
{ "error": { "code": 401, "message": "Payment not found" } }

В случае успешного выполнения запроса будет возвращен результат выполнения запроса.


О сервисе
Пользовательское соглашение
Требования к сайту
Партнерская программа
Модули CMS
Контакты