API Steam+Acquiring

Общая информация

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

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

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

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

Получите приглашение от вашего личного менеджера по Email
Перейдите по ссылке из письма, чтобы задать пароль
После создания пароля авторизуйтесь в личном кабинете мерчанта (https://merchant.wata.pro/login)
В разделе "Терминалы" нажмите на плашку с боевым терминалом
Справа откроется панель с настройками, в ней нужно создать токены. Всего можно создать от 1 до 5 токенов.
Придумайте название и выберите время жизни токена. Время жизни access token составляет от 1 до 12 месяцев.
После истечения этого времени запросы к API начнут возвращать 401 HTTP статус код.

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

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

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

Пример ответа с детализацией ошибки

Response 400

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

Коды ошибок

Словарь терминов

Steam+Acquiring;Технология, которая позволяет мерчантам принимать платежи от клиентов онлайн за пополнение игровых аккаунтов в Steam с одновременным зачислением средств клиентам, используя банковские карты и другие методы, такие как СБП (система быстрых платежей) или T-Pay Мерчант;Клиент, который подключился к платежной системе WATA Транзакция;Запись о платеже в системе с уникальным идентификатором (UUID), суммой, номером заказа, описанием и статусом UUID транзакции;Уникальный идентификатор, присвоенный каждой транзакции в системе Статус транзакции;Результат обработки платежа. Он может быть успешным, если платеж прошел, отклоненным, если транзакция не прошла и был получен код ошибки, или в обработке, если ответа от системы не поступило Код ошибки;Уникальный идентификатор ошибки, который выдается после неудачного платежа и указывает на причину ошибки. Он представлен в виде текста, объясняющего причину, чтобы можно было понять, что именно пошло не так Терминал;Проект мерчанта, которому присваивается платежный шлюз с платежными методами Оборот;Общая сумма успешных транзакций, которые были проведены за определенный период времени Доход мерчанта;Разница между оборотом и стоимостью пополнения Steam Баланс;Сумма дохода мерчанта, которая накопилась до проведения автосеттла (автоматического расчета) Платежный метод;Способ оплаты (Карты, СБП, T-Pay и другие методы) Автосеттлы;Процесс автоматической выплаты средств мерчантам по схеме T+N, где T — это дата транзакции, а N — количество дней, через которые производится выплата T+N;Схема выплаты мерчантам. По этой схеме происходит конвертация рублей в USDT и выплата в зависимости от дня конвертации выплаты Мерчантка;Личный кабинет мерчантов, где они могут управлять своими транзакциями, терминалами, платежными ссылками и выплатами Платежная ссылка;Уникальная ссылка, которую мерчант получает через API или личный кабинет для того, чтобы клиент мог произвести оплату Access token;Ключ для интеграции сайта или бота мерчанта с платежным API, который используется для аутентификации и авторизации при отправке запросов к системе Secret Key;Уникальный ключ, используемый для обеспечения безопасности работы с API

Пополнение аккаунтов в Steam

Получение стоимости пополнения аккаунта
Используйте этот метод, чтобы для заданной суммы пополнения аккаунта в Steam рассчитать стоимость, включающую сумму пополнения и комиссию WATA.

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

Параметры ответа

Пример запроса

GET https://dg-api.wata.pro/api/orders/steam/amount?NetAmount=1000&Account=accountName
Authorization: Bearer <access-token>

Пример ответа

Response 200

{
  "amountTotal": 1033.78
}

Создание заказа
Используйте этот метод для создания заказа на пополнение аккаунта в Steam и получения платежной ссылки. Доход мерчанта формируется из разницы между суммой платежа и стоимостью пополнения аккаунта.
На платежной форме WATA могут находиться несколько методов оплаты, например, оплата картой и через СБП, в зависимости от выданного терминала. Платежная ссылка одноразовая и становится недействительной после первой успешной оплаты.

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

Параметры ответа

Пример запроса

POST https://dg-api.wata.pro/api/orders/steam
Authorization: Bearer <access-token>
{ 
 "account": "AccountName",
  "amount": 1100,
  "netAmount": 1000,
  "description": "steam",
  "orderId": "100200320"
}

Пример ответа

{
  "orderId": "100200320",
  "amount": 1100,
  "paymentLink": "https://payment.wata.pro/pay-form/3a1b02f5-d60e-1497-f35e-200xxxxxxx"
}

Проверка статуса заказа
Используйте этот метод для проверки статуса заказа

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

Параметры ответа

Пример запроса

GET https://dg-api.wata.pro/api/orders/steam/100200314
Authorization: Bearer <access-token>

Пример ответа

Response 200

{
  "orderId": "100200314",
  "amount": 1200,
  "status": "Success"
}