Принцип работы

• Программная интеграция построена на принципах REST, на основе спецификации JSON-API. При отправке запросов необходима отправлять HTTP заголовок Content-Type=application/json.
• Базовый адрес продуктивного окружения https://api.x10pay.com
• Тайм-аут на получение ответа от API — 1 минута.

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

Для доступа к API используются Bearer аутентификация на основе JWT токена. JWT токен (access token) необходимо передавать в HTTP заголовке авторизации аутентификации запроса в HTTP заголовке Authorization.

Access token можно получить в личном кабинете мерчанта.

1. Получить авторизационный токен можно в личном кабинете мерчанта в разделе Терминалы
2. Перейдите по ссылке из письма, чтобы задать пароль
3. После установки пароля, вы попадете в личный кабинет мерчанта https://merchant.x10pay.com
4. В разделе "Терминалы" нажмите на подразу с боковым терминалом
5. Справа откроется панель с настройками в ней нужно создать токен. Всего можно создать от 1 до 5 токенов.
6. Полученный назвние в выборке время жизни токена. Время жизни access token составляет от 1 до 12 месяцев.
7. После истечения жизни времени запроса в API начнут возвращать 401 HTTP статус код.

На втором системы WATA не хранится access token, поэтому его невозможно восстановить. Возможно только отозвать access token замен, поэтому после генерации токена рекомендуем скрыть его в безопасном месте.

Тестирование

• Для тестирования используется тестовая среда https://api-sandbox.x10pay.com/api/b2b
• Тестовый ЛК https://merchant-sandbox.x10pay.com/login
• Процесс получения Access token для тестирование включение процессу аутентификация в боевой среде

Для тестирования можно использовать карты

Тип	Номер карты	Результат оплаты
Карта MMP Bez 3DS	2200 0000 2222 2222	Success
Карта MMP Bez 3DS	2203 0000 0000 0043	Declined
Карта MMP c 3DS	2200 0000 0000 0004	Success
Карта VISA Bez 3DS	4111 1111 1111 1111	Declined

HTTP статус коды ответов

В случае ошибки при обработке запроса API возвращает HTTP статус код, отличный от 200-го.

Код	Описание	Комментарий
401	Запрос не авторизован	Не передан access token или передан access token с истекшим сроком действия, обновите access token
403	Доступ запрещен	У вас нет доступа к запрашиваемой информации
400	Некорректный запрос	Данные в запросе некорректны. Проверьте запрос, исправьте данные и повторите попытку
500	Ошибка сервера	Обратитесь пожалуйста в техподдержку с описанием проблемы и указанием тела запроса

Также в случае получения 400-го кода возвращается ответ с детализацией ошибки.

Пример ответа с детализацией ошибки (Response 400):

{
    "error": {
        "code": null,
        "message": "Ваш запрос недействителен",
        "details": "При проверке были обнаружены следующие ошибки - 'Amount' должно быть заполнено.",
        "data": {
        }
    },
    "validationErrors": {
        "message": "'Amount' должно быть заполнено.",
        "members": [
            "amount"
        ]
    }
}

Виджет

Встраивающая и встраиваемая платежная форма оплаты на сайте без редиректа на платежную форму WATA адаптирована под любые браузеры и мобильные устройства и не уводит клиентов из проекта.