API Flexo предназначен для проведения основных карточных операций.

Список поддерживаемых операций

Swagger

Особенности API

  • Идемпонентность. Если не получен ответ на запрос (timeout, ошибка соединения), то можно повторить запрос. В случае если он был обработан, вернется результат. Операция не задублируется.

  • Комбинация параметра externalId с siteId является уникальной.

  • При переходе операции в финальный статус клиенту отправляется callback.

Типы и последовательности операций

Заголовки запросов

  1. W1-Signature: SOME_VALUE - подпись запроса

  2. Content-Type: application/json

Параметры запросов

  1. Основные параметры запросов

Формирование подписи

  1. Алгоритм формирования подписи

Коды ответов

HTTP коды ответов делятся на 4 группы:

  • 200 - Операция успешна. Можно оказывать услугу.

  • 202 - Операция находится в обработке. Необходимо подождать callback-а.

  • 4XX - Операция неуспешна. Требуется изменить запрос или обратиться в службу поддержки.

  • 5XX - Техническая ошибка на стороне Flexo.

Основные коды ответов

3DSecure

В случае, если в ответе на purchase и auth поле status равно WAITING_FOR_CONFIRMATION, то необходимо отправить покупателя на ACS страницу банка.

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

  1. Тестовые карты

  2. Тестовый аккаунт

Примеры запросов и ответов

  1. Покупка с 3dsecure

  2. Покупка с 3dsecure V2

  3. Рекурренты

  4. Выплаты

  5. Покупка через платежную страницу

  6. Запрос баланса

Отчеты

  1. Ежедневный отчет о платежах

Контакты технической поддержки

integration@flexo.systems