Общая информация
Принцип работы
  • Программный интерфейс построен по принципам REST, на основе спецификации JSON-API. При отправке запросов необходимо отправлять HTTP заголовок Content-Type=application/json
  • Тайм-аут на получение ответа от API: 1 минута
Главная
Аутентификация
Для доступа к API используется Bearer аутентификация на основе JWT токена. JWT токен (access token) необходимо передавать в каждом требующем аутентификации запросе в HTTP заголовке Authorization
Access token можно получить в личном кабинете мерчанта:

  1. Получите приглашение от вашего личного менеджера по Email
  2. Перейдите по ссылке из письма, чтобы задать пароль
  3. После создания пароля авторизуйтесь в личном кабинете мерчанта (https://merchant.wata.pro/login)
  4. В разделе "Терминалы" нажмите на плашку с боевым терминалом
  5. Справа откроется панель с настройками, в ней нужно создать токены. Всего можно создать от 1 до 5 токенов
  6. Придумайте название и выберите время жизни токена. Время жизни access token составляет от 1 до 12 месяцев
  7. После истечения этого времени запросы к API начнут возвращать 401 HTTP статус код
На стороне системы WATA не хранится access token, поэтому его невозможно восстановить. Возможно только сгенерировать access token заново, поэтому после генерации токена рекомендуем хранить его в безопасном месте
Webhook уведомления
В терминале можно указать URL адрес, куда будут приходить webhook-уведомления при оплате транзакции плательщиком (как успешной, так и неуспешной). Порядок работы webhook’ов и параметры уведомлений см. здесь.
HTTP статус коды ответов
В случае ошибки при обработке запроса API возвращает HTTP статус код, отличный от 200-го
Также в случае получения 400-го кода возвращается ответ с детализацией ошибки
Пример ответа с детализацией ошибки
Response 400
{
   "error":{
      "code":null,
      "message":"Ваш запрос недействителен!",
      "details":"При проверке были обнаружены следующие ошибки - 'Amount' должно быть заполнено.",
      "data":{
         
      },
      "validationErrors":[
         {
            "message":"'Amount' должно быть заполнено.",
            "members":[
               "amount"
            ]
         }
      ]
   }
}
Коды ошибок
Словарь терминов
Покупка звезд в Telegram (STARS)
Получение стоимости Stars
Используйте этот метод, чтобы проверить существование username в Telegram и получить стоимость приобретения и минимальную цену продажи одной звезды
Параметры запроса
Параметры ответа
Пример запроса 
GET https://dg-api.wata.pro/api/stars/price?Username=test
Response 200
Пример ответа 
{
  "name": "Price for 1 star in rub",
  "starPrice": 1.36,
  "minPrice": 1.46
}
Создание заказа
Используйте этот метод для создания заказа на покупку звезд и получения платежной ссылки. Доход мерчанта — это цена продажи звезд минус комиссия WATA (% от цены) и стоимость приобретения звезд. На платежной форме WATA могут находиться несколько методов оплаты, например, оплата картой и через СБП, в зависимости от выданного терминала. Платежная ссылка одноразовая и становится недействительной после первой успешной оплаты.
Параметры запроса
Параметры ответа
Пример запроса 
POST https://dg-api.wata.pro/api/stars
Authorization: Bearer <access-token>
{
  "username": "test",
  "count": 100,
  "amount": 150,
  "description": "test",
  "orderId": "3424124124",
  "successRedirectUrl": "https://wata.pro/",
  "failRedirectUrl": "https://wata.pro/"
}
Пример ответа
{
  "orderId": "3424124124",
  "username": "test",
  "count": 100,
  "amount": 150,
  "price": 136,
  "commission": 10.5,
  "description": "test",
  "paymentLink": "https://payment.wata.pro/pay-form/3a1b02f5-d60e-1497-f35e-200xxxxxxx",
  "successRedirectUrl": "https://wata.pro/",
  "failRedirectUrl": "https://wata.pro/"
}
Проверка статуса заказа
Используйте этот метод для проверки статуса заказа
Параметры запроса
Параметры ответа
Пример запроса
GET https://dg-api.wata.pro/api/stars/order/3424124124
Authorization: Bearer <access-token>
Response 200
Пример ответа 
{
  "orderId": "3424124124",
  "status": "Success",
  "username": "test",
  "count": 100,
  "amount": 150,
  "description": "test",
  "creationTime": "2025-10-27T09:46:44.453847Z",
  "successRedirectUrl": "https://wata.pro/",
  "failRedirectUrl": "https://wata.pro/"
}
Пополнение аккаунтов в Steam
Получение стоимости пополнения аккаунта
Используйте этот метод, чтобы для заданной суммы пополнения аккаунта в Steam рассчитать стоимость пополнения и минимальную цену продажи
Параметры запроса
Параметры ответа
Пример запроса
GET https://dg-api.wata.pro/api/v2/steam/amount?NetAmount=1000&Account=accountName
Authorization: Bearer <access-token>
Response 200
Пример ответа 
{
  "price": 1062.53,
  "minPrice": 1142.51
}
Создание заказа
Используйте этот метод для создания заказа на пополнение аккаунта в Steam и получения платежной ссылки
Доход мерчанта — это цена продажи минус комиссия WATA (% от цены) и стоимость пополнения аккаунта. На платежной форме WATA могут находиться несколько методов оплаты, например, оплата картой и через СБП, в зависимости от выданного терминала. Платежная ссылка одноразовая и становится недействительной после первой успешной оплаты
Параметры запроса
Параметры ответа
Пример запроса
POST https://dg-api.wata.pro/api/v2/steam
Authorization: Bearer <access-token>
{
  "account": "AccountName",
  "amount": 1200,
  "netAmount": 1000,
  "description": "test",
  "orderId": "324234234",
  "successRedirectUrl": "string",
  "failRedirectUrl": "string"
}
Пример ответа
{
  "orderId": "324234234",
  "amount": 1200,
  "price": 1058.18,
  "minPrice": 1137.83,
  "commission": 84,
  "paymentLink": "<PaymentLink>",
  "successRedirectUrl": "string",
  "failRedirectUrl": "string"
}
Проверка статуса заказа
Используйте этот метод для проверки статуса заказа
Параметры запроса
Параметры ответа
Пример запроса
GET https://dg-api.wata.pro/api/v2/steam/order/100200314
Authorization: Bearer <access-token>
Response 200
Пример ответа 
{
  "orderId": "100200314",
  "amount": 1200,
  "status": "Success",
  "successRedirectUrl": "string",
  "failRedirectUrl": "string"
}
Покупка игровых позиций (TopUp)
Получение списка игр и позиций
Используйте этот метод для получения списка игр, игровых позиций и ваучеров внутри каждой игры
Параметры ответа
Пример запроса
GET https://dg-api.wata.pro/api/v2/topup
Authorization: Bearer <access-token>
Response 200
Пример ответа 
[
  {
    "gameId": 3,
    "gameName": "Genshin Impact",
    "positions": [
      {
        "positionId": 3,
        "productId": 3,
        "positionName": "60 Genesis Crystals",
        "productName": "Genshin Impact",
        "minPrice": 81.44,
        "price": 75.74,
        "category": "Games",
        "country": ""
      },
      {
        "positionId": 6,
        "productId": 3,
        "positionName": "300 Genesis Crystals",
        "productName": "Genshin Impact",
        "minPrice": 414.84,
        "price": 385.8,
        "category": "Games",
        "country": ""
      },
      {
        "positionId": 7,
        "productId": 3,
        "positionName": "980 Genesis Crystals",
        "productName": "Genshin Impact",
        "minPrice": 1248.35,
        "price": 1160.97,
        "category": "Games",
        "country": ""
      },
  },
...
]
Получение информации по конкретной игре и ее позициям
Используйте этот метод для получения игровых позиций внутри конкретной игры и списка обязательных параметров для создания заказа
Параметры запроса
Параметры ответа
Пример запроса
Общая информация
Принцип работы

  • Программный интерфейс построен по принципам 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 можно получить в личном кабинете мерчанта:

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

В терминале можно указать URL адрес, куда будут приходить webhook уведомления при оплате транзакции плательщиком (как успешной, так и не успешной). Порядок работы webhook'ов и параметры уведомлений см. здесь.
HTTP статус коды ответов

В случае ошибки при обработке запроса API возвращает HTTP статус код, отличный от 200-го.
Также в случае получения 400-го кода возвращается ответ с детализацией ошибки.
Пример ответа с детализацией ошибки
Response 400
{
   "error":{
      "code":null,
      "message":"Ваш запрос недействителен!",
      "details":"При проверке были обнаружены следующие ошибки - 'Amount' должно быть заполнено.",
      "data":{
         
      },
      "validationErrors":[
         {
            "message":"'Amount' должно быть заполнено.",
            "members":[
               "amount"
            ]
         }
      ]
   }
}
Коды ошибок
Словарь терминов
Покупка звезд в Telegram (STARS)
Получение стоимости stars
Используйте этот метод, чтобы проверить существование username в Telegram и получить стоимость приобретения и минимальную цену продажи одной звезды.

Параметры запроса
Параметры ответа
Пример запроса 
GET https://dg-api.wata.pro/api/stars/price?Username=test
Пример ответа
Response 200
{
  "name": "Price for 1 star in rub",
  "starPrice": 1.36,
  "minPrice": 1.46
}
Создание заказа
Используйте этот метод для создания заказа на покупку звезд и получения платежной ссылки. Доход мерчанта - это цена продажи звезд минус комиссия WATA (% от цены) и стоимость приобретения звезд. На платежной форме WATA могут находиться несколько методов оплаты, например, оплата картой и через СБП, в зависимости от выданного терминала. Платежная ссылка одноразовая и становится недействительной после первой успешной оплаты.

Параметры запроса
Параметры ответа
Пример запроса
POST https://dg-api.wata.pro/api/stars
Authorization: Bearer <access-token>
{
  "username": "test",
  "count": 100,
  "amount": 150,
  "description": "test",
  "orderId": "3424124124",
  "successRedirectUrl": "https://wata.pro/",
  "failRedirectUrl": "https://wata.pro/"
}
Пример ответа
{
  "orderId": "3424124124",
  "username": "test",
  "count": 100,
  "amount": 150,
  "price": 136,
  "commission": 10.5,
  "description": "test",
  "paymentLink": "https://payment.wata.pro/pay-form/3a1b02f5-d60e-1497-f35e-200xxxxxxx",
  "successRedirectUrl": "https://wata.pro/",
  "failRedirectUrl": "https://wata.pro/"
}
Проверка статуса заказа
Используйте этот метод для проверки статуса заказа

Параметры запроса
Параметры ответа
Пример запроса
GET https://dg-api.wata.pro/api/stars/order/3424124124
Authorization: Bearer <access-token>
Пример ответа
Response 200
{
  "orderId": "3424124124",
  "status": "Success",
  "username": "test",
  "count": 100,
  "amount": 150,
  "description": "test",
  "creationTime": "2025-10-27T09:46:44.453847Z",
  "successRedirectUrl": "https://wata.pro/",
  "failRedirectUrl": "https://wata.pro/"
}
Пополнение аккаунтов в Steam
Получение стоимости пополнения аккаунта
Используйте этот метод, чтобы для заданной суммы пополнения аккаунта в Steam рассчитать стоимость пополнения и минимальную цену продажи.

Параметры запроса
Параметры ответа
Пример запроса 
GET https://dg-api.wata.pro/api/v2/steam/amount?NetAmount=1000&Account=accountName
Authorization: Bearer <access-token>
Пример ответа
Response 200
{
  "price": 1062.53,
  "minPrice": 1142.51
}
Создание заказа
Используйте этот метод для создания заказа на пополнение аккаунта в Steam и получения платежной ссылки.
Доход мерчанта - это цена продажи минус комиссия WATA (% от цены) и стоимость пополнения аккаунта. На платежной форме WATA могут находиться несколько методов оплаты, например, оплата картой и через СБП, в зависимости от выданного терминала. Платежная ссылка одноразовая и становится недействительной после первой успешной оплаты.


Параметры запроса
Параметры ответа
Пример запроса
POST https://dg-api.wata.pro/api/v2/steam
Authorization: Bearer <access-token>
{
  "account": "AccountName",
  "amount": 1200,
  "netAmount": 1000,
  "description": "test",
  "orderId": "324234234",
  "successRedirectUrl": "string",
  "failRedirectUrl": "string"
}
Пример ответа
{
  "orderId": "324234234",
  "amount": 1200,
  "price": 1058.18,
  "minPrice": 1137.83,
  "commission": 84,
  "paymentLink": "<PaymentLink>",
  "successRedirectUrl": "string",
  "failRedirectUrl": "string"
}
Проверка статуса заказа
Используйте этот метод для проверки статуса заказа

Параметры запроса
Параметры ответа
Пример запроса
GET https://dg-api.wata.pro/api/v2/steam/order/100200314
Authorization: Bearer <access-token>
Пример ответа
Response 200
{
  "orderId": "100200314",
  "amount": 1200,
  "status": "Success",
  "successRedirectUrl": "string",
  "failRedirectUrl": "string"
}
Покупка игровых позиций (TopUp)
Получение списка игр
Используйте этот метод для получения списка доступных игр

Параметры ответа
Пример запроса 
GET https://dg-api.wata.pro/api/v3/topup
Authorization: Bearer <access-token>
Пример ответа
Response 200
[
  {
    "id": "1",
    "name": "Genshin Impact",
    "isAvailable": true
  },
  {
    "id": "2",
    "name": "Honkai: Star Rail",
    "isAvailable": true
  },
  {
    "id": "3",
    "name": "Zenless Zone Zero",
    "isAvailable": true
  },
  {
    "id": "4",
    "name": "Love and Deepspace",
    "isAvailable": true
  },
  {
    "id": "5",
    "name": "Mobile Legends (Global)",
    "isAvailable": true
  },
...
]
Получение списка пополнений внутри игры
Используйте этот метод для получения списка пополнений (игровых позиций) внутри игры, их цен и обязательных параметров для создания заказа

Параметры запроса
Пример запроса 
GET https://dg-api.wata.pro/api/v3/topup/1
Authorization: Bearer <access-token>
Пример ответа
Response 200
{
  "details": {
    "categoryId": "1",
    "categoryName": "Genshin Impact",
    "type": "DirectTopUp",
    "fields": [
      {
        "Input1": "User ID",
        "Regex": "(7|8|18|6|9)\\d{8}"
      }
    ]
  },
  "products": [
    {
      "id": "1",
      "name": "60",
      "price": 57.26,
      "minPrice": 61.57,
      "isAvailable": true
    },
    {
      "id": "1816",
      "name": "60 Chronal Nexus",
      "price": 59.86,
      "minPrice": 64.37,
      "isAvailable": true
    },
    {
      "id": "1817",
      "name": "300 + 30 Chronal Nexus",
      "price": 305.39,
      "minPrice": 328.38,
      "isAvailable": true
    },
    {
      "id": "1818",
      "name": "980 + 110 Chronal Nexus",
      "price": 919.19,
      "minPrice": 988.38,
      "isAvailable": true
    },
    {
      "id": "1819",
      "name": "1980 + 260 Chronal Nexus",
      "price": 1993.35,
      "minPrice": 2143.39,
      "isAvailable": true
    },
...
Покупка игровой позиции
Используйте этот метод для создания заказа на покупку игровой позиции и получения платежной ссылки. Доход мерчанта - это цена продажи игровой позиции минус комиссия WATA (% от цены) и стоимость приобретения позиции.
На платежной форме WATA могут находиться несколько методов оплаты, например, оплата картой и через СБП, в зависимости от выданного терминала. Платежная ссылка одноразовая и становится недействительной после первой успешной оплаты


Параметры запроса
Параметры ответа
Пример запроса
POST https://dg-api.wata.pro/api/v3/topup
Authorization: Bearer <access-token> 
{
  "topupId": "1816",
  "amount": 70.00,
  "orderId": "test",
  "fields": {
    "Input1": "700123456",
  },
  "email": "test@mail.com",
  "description": "test",
  "successRedirectUrl": "https://wata.pro/tsifrovyyetovary",
  "failRedirectUrl": "https://wata.pro/tsifrovyyetovary"
}
Пример ответа
{
  "orderId": "test",
  "amount": 70,
  "commission": 4.9,
  "orderPrice": 59.86,
  "topupId": "1816",
  "email": "test@mail.com",
  "paymentLink": "<paymentLink>"",
  "successRedirectUrl": "https://wata.pro/tsifrovyyetovary",
  "failRedirectUrl": "https://wata.pro/tsifrovyyetovary"
}
Получение информации о заказе

Используйте этот метод для получения статуса заказа по его номеру

Параметры запроса
Параметры ответа
Пример запроса
GET https://dg-api.wata.pro/api/v3/topup/orders/test
Authorization: Bearer <access-token>
Пример ответа
{
  "orderId": "test",
  "status": "Pending",
  "amount": 70,
  "orderPrice": 59.86,
  "topupId": "1816",
  "email": "test@mail.com",
  "paymentLink": null,
  "successRedirectUrl": null,
  "failRedirectUrl": null
}
Покупка ваучеров (Vouchers)
Получение списка сервисов
Используйте этот метод для получения списка сервисов кодов пополнений (ваучеров)

Параметры ответа
Пример запроса 
GET https://dg-api.wata.pro/api/v3/vouchers/services
Authorization: Bearer <access-token>
Пример ответа
Response 200
[
  {
    "id": "51",
    "name": "Amazon Gift Card | AE",
    "isAvailable": true
  },
  {
    "id": "52",
    "name": "Apex Coins | Origin",
    "isAvailable": true
  },
  {
    "id": "53",
    "name": "Apex Coins | Xbox",
    "isAvailable": true
  },
  {
    "id": "54",
    "name": "Apple Wallet Code | AE",
    "isAvailable": true
  },
  {
    "id": "72",
    "name": "Binance Gift Card | GL",
    "isAvailable": true
  },
  {
    "id": "73",
    "name": "Black Clover Mobile",
    "isAvailable": true
  },
  {
    "id": "74",
    "name": "Blizzard Wallet Card | EU",
    "isAvailable": true
  },
...
Получение списка ваучеров внутри сервиса

Используйте этот метод для получения списка кодов пополнений (ваучеров) для выбранного сервиса и количества доступных ваучеров

Параметры запроса
Параметры ответа
Пример запроса 
GET https://dg-api.wata.pro/api/v3/vouchers/135
Authorization: Bearer <access-token>
Пример ответа
Response 200
{
  "details": {
    "categoryId": "135",
    "categoryName": "PUBG Mobile Voucher | GL",
    "type": "VoucherCode",
    "description": "",
    "fields": []
  },
  "vouchers": [
    {
      "id": "1258",
      "name": "10 UC",
      "price": 92.7,
      "minPrice": 99.68,
      "isAvailable": true,
      "stock": 101
    },
    {
      "id": "1259",
      "name": "60 UC",
      "price": 80.3,
      "minPrice": 86.34,
      "isAvailable": true,
      "stock": 2000
    },
    {
      "id": "1260",
      "name": "300 + 25 UC",
      "price": 404.75,
      "minPrice": 435.22,
      "isAvailable": true,
      "stock": 1200
    },
    {
      "id": "1261",
      "name": "600 + 60 UC",
      "price": 810.31,
      "minPrice": 871.3,
      "isAvailable": true,
      "stock": 1200
    },
...
]
Покупка ваучеров

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

Параметры запроса
Параметры ответа
Пример запроса 
POST https://dg-api.wata.pro/api/v3/vouchers
Authorization: Bearer <access-token>
Content-Type: application/json
{
  "voucherId": 1259,
  "amount": 100,
  "count": 1,
  "orderId": "test",
  "email": "test@gmail.com",
  "description": "test",
  "successRedirectUrl": "https://wata.pro/tsifrovyyetovary",
  "failRedirectUrl": "https://wata.pro/tsifrovyyetovary"
}
Пример ответа
Response 200
{
  "orderId": "test",
  "amount": 100,
  "commission": 7,
  "orderPrice": 80.3,
  "voucherId": "1259",
  "count": 1,
  "email": "test@gmail.com",
  "paymentLink": "<paymentLink>"",
  "successRedirectUrl": "https://wata.pro/tsifrovyyetovary",
  "failRedirectUrl": "https://wata.pro/tsifrovyyetovary"
}
Получение информации о заказе

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

Параметры запроса
Параметры ответа
Пример запроса 
GET https://dg-api.wata.pro/api/v3/vouchers/order/test
Authorization: Bearer <access-token>
Пример ответа
Response 200
{
  "orderId": "test",
  "status": "Success",
  "vouchers": [
    "RA-89AHCYJHL6UFFLCN"
  ],
  "amount": 100,
  "orderPrice": 80.3,
  "voucherId": "1259",
  "count": 1,
  "email": "test@mail.com",
  "paymentLink": null,
  "successRedirectUrl": null,
  "failRedirectUrl": null
}