Формат взаимодействия с API платежей картами

Работа с UnonaPay API строится на принципах REST. Для приема платежей вам необходимо выполнять запросы к UnonaPay API в формате, описанном для каждого типа транзакции. Однако, независимо от типа каждый запрос должен соответствовать следующим требованиям:

• использовать авторизацию типа Basic c идентификатором и секретным ключом магазина как имя пользователя и пароль соответственно;
• содержать заголовки Content-Type: application/json и Accept: application/json;
• иметь тело в формате JSON;
• использовать кодировку UTF-8.

Обязательные параметры запроса отмечены * обязательный. Неотмеченные параметры считаются опциональными.

Info

При получении в ответе на транзакцию ошибки с HTTP кодом 429 (Too Many Requests), рекомендуется повторять запросы до получения ответа с HTTP кодом 200, каждый раз увеличивая интервал между повторными запросами.

Info

C 15 сентября 2022 для всех https://gateway.unonapay.com/- методов также поддерживается API v.3. Для запросов к этой версии API добавьте заголовок X-API-Version: 3. Описание параметров и их значений приведено в руководстве по API версия 3.

Info

Обратите внимание, что в системе UnonaPay разрешение на отправку host-to-host запросов с номером карты (credit_card.number) активируется на уровне магазина. Если для магазина не активировано данное разрешение, при попытке отправить запросы типов оплата, авторизация, выплата, P2P-перевод, проверка c номером карты, в ответе вернется ошибка (код ошибки для запросов API v.3 – E.1065).

Для отправки запросов с токеном карты, а также для указания данных карты в параметре recipient_credit_card.number в запросе на P2P-перевод, данное разрешение не требуется.