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

Отправляет email и пароль. Кабинет всегда требует второй фактор: код придёт на почту, после чего нужно вызвать wata_auth_verify. ПРЕДПОЧТИТЕЛЬНО вызывать БЕЗ аргументов: тогда почта и пароль берутся из переменных окружения WATA_EMAIL и WATA_PASSWORD и никуда не записываются. Аргументы этого инструмента попадают в историю диалога клиента в открытом виде, поэтому передавать пароль напрямую стоит только если другого способа нет.

Завершает вход, принимая код из письма. После успеха сессия сохраняется локально и живёт около 60 дней. Код одноразовый и живёт несколько минут: вызывайте сразу после получения. Неудачная попытка гасит запрос второго фактора — тогда начинайте вход заново. Учтите, что код попадёт в историю диалога; после входа он уже бесполезен, но саму историю стоит считать содержащей чувствительные данные.

Завершает сессию на сервере и очищает локально сохранённые куки.

Имя, почта, телефон, telegram, роли и идентификатор текущего пользователя.

Данные организации-мерчанта: название, статус, закреплённые менеджеры, даты создания и изменения.

Терминалы мерчанта с оборотом, выручкой, ставками WATA, типом продукта и доступными методами оплаты. Период From/To влияет на суммы оборота и выручки.

Полная карточка терминала, включая адрес вебхука, страницы успеха и ошибки, разрешённые домены.

Балансы терминалов и статус готовности к конвертации/выплате.

Транзакции мерчанта с курсорной пагинацией. Для следующей страницы передайте nextCursorId и nextCursorDate из предыдущего ответа.

Количество транзакций в разрезе статусов: created, paid, pending, declined.

Созданные платёжные ссылки мерчанта.

Список чарджбеков с курсорной пагинацией.

Регулярные списания (подписки) мерчанта.

Количество подписок по статусам: active, completed, failed.

Суммарный оборот и выручка мерчанта за период, по валютам.

Разбивка оборота и выручки по дням — основа для графиков и сверки.

Выплаты мерчанту: сумма, статус, дата, задействованные терминалы.

Конвертации выручки терминалов, включая курс и итоговую сумму.

Счета кошелька и остатки по валютам (в том числе USDT), с точностью каждой валюты.

История операций кошелька. accountId берётся из wata_wallet_balances.

Доступные способы фиатного вывода средств и привязанные к ним терминалы.

Банки, доступные для фиатного вывода, с их номерами для СБП.

Заказы направления digital goods: Steam, Telegram Stars, пополнения, ваучеры.

Обращения в поддержку: тема, категория, статус, наличие непрочитанных ответов.

Выполняет любой запрос к API личного кабинета с текущей сессией, antiforgery-токеном и защитой от DDoS-Guard. Нужен для того, что ещё не покрыто типизированными инструментами. Путь должен начинаться с /api/. Осторожно: метод, отличный от GET, изменяет данные аккаунта.

Комиссии WATA по всем методам оплаты для указанного терминала.

Задаёт, какая часть комиссии по конкретному методу оплаты перекладывается на плательщика. Ставка меняется по одному методу за вызов. Доступные методы смотрите в wata_terminal_rates.

Список выпущенных JWT-токенов публичного API для терминала (сами значения токенов сервер обычно не возвращает повторно).

Создаёт новый JWT для публичного API эквайринга. Значение токена показывается один раз — сохраните его сразу в WATA_ACQ_TOKEN. На терминал допускается от одного до пяти токенов, срок действия от 1 до 12 месяцев. Токен работает только с согласованных с WATA IP-адресов.

Безвозвратно отзывает выпущенный JWT публичного API.

Меняет настройки боевого терминала: адрес вебхука, страницы успеха и ошибки, а также какие именно уведомления слать. Это основной способ подключить приём вебхуков. Передавайте только те поля, которые нужно изменить. ВНИМАНИЕ: предоплатный вебхук (sendPrePayWebhook) требует ответа за 10 секунд — если ваш сервер не ответит, транзакция будет отклонена без обращения в банк.

Переключает терминал в тестовый режим или обратно.

Полная карточка транзакции по идентификатору.

НЕОБРАТИМАЯ ДЕНЕЖНАЯ ОПЕРАЦИЯ. Создаёт возврат по транзакции. Нужны только идентификатор исходной транзакции и сумма — валюта берётся из неё же. Для полного возврата передайте сумму, равную сумме исходной транзакции. Поля «причина возврата» в API нет.

Просит WATA повторно доставить вебхук об оплате на адрес терминала. Удобно, когда ваш сервер не принял уведомление.

Карточка платёжной ссылки по идентификатору.

Создаёт платёжную ссылку от имени кабинета — без JWT-токена терминала. Удобно, когда токен ещё не выпущен: терминал указывается явно. Если вы интегрируете приём платежей в свой сервис, используйте wata_acq_link_create.

Закрывает платёжную ссылку, чтобы по ней больше нельзя было платить. Кабинет требует передать вместе со статусом сумму, валюту и терминал ссылки — возьмите их из wata_link_get. Создание ссылок делается через wata_acq_link_create.

Карточка чарджбека по идентификатору.

Карточка регулярного списания.

Приостанавливает, возобновляет или отменяет подписку.

Актуальные курсы конвертации, используемые кошельком.

Карточка одной операции по идентификатору.

Лимиты вывода. Параметры обязательны: для фиата — currency и method, для крипты — currency и blockchainType. Без них сервер отвечает «Ваш запрос недействителен».

Информация о терминале, через который проходит фиатный вывод.

Считает комиссию и возвращает orderId и quoteId, без которых нельзя создать заявку. Ничего не списывает — безопасный способ узнать итоговую сумму заранее.

ДЕНЕЖНАЯ ОПЕРАЦИЯ. Создаёт заявку на вывод; деньги ещё не уходят. Сначала вызовите wata_wallet_withdrawal_commission — оттуда берутся orderId и quoteId. В ответе придёт credentialTokenId, он нужен для подтверждения. Для СБП нужны bankNumber (из wata_wallet_banks) и телефон получателя из 11 цифр, начиная с 7. Вывод НА КАРТУ через API невозможен: номер карты вводится только в защищённом виджете кабинета.

ДЕНЕЖНАЯ ОПЕРАЦИЯ, НЕОБРАТИМАЯ. После этого вызова средства уходят. Нужны код подтверждения и credentialTokenId из заявки. Для фиата дополнительно передаётся orderId, для крипты — нет.

Текущее состояние ранее созданной заявки.

Запрашивает реквизиты для пополнения кошелька в криптовалюте.

ДЕНЕЖНАЯ ОПЕРАЦИЯ. Переводит средства между счетами кошелька.

Текущие правила автоматического вывода выручки.

Создаёт запрос на изменение правил автоматического вывода. Требует подтверждения кодом. balancePercentage — какая доля баланса выводится, minimumThreshold — порог срабатывания.

Подтверждает изменение правил автоматического вывода средств.

Обращение в поддержку целиком, включая переписку.

Открывает новое обращение в поддержку WATA. Категория определяет маршрут обращения внутри WATA — например, MissingTransaction для недошедшего платежа. Указывайте в тексте идентификаторы транзакции и терминала: так обращение решается быстрее.

Добавляет комментарий в обращение поддержки от имени мерчанта. Кабинет принимает этот запрос как multipart/form-data, а не как JSON — инструмент собирает нужную форму сам.

Снимает отметку о непрочитанном ответе поддержки.

Количество заказов digital goods в разрезе статусов.

Карточка заказа digital goods по терминалу и идентификатору заказа.

Выключает баннеры-истории в интерфейсе кабинета.

Отправляет на почту код для восстановления пароля.

Устанавливает новый пароль, используя код из письма.

Расширенный список подписок, доступный из административного раздела кабинета.

Создаёт платёжную ссылку через публичный API. Ссылка создаётся для терминала, которому принадлежит токен WATA_ACQ_TOKEN — отдельно терминал не указывается. В ответе поле url можно сразу отдавать плательщику. Ограничения: сумма от 10 RUB (1 USD/EUR) до 999999.99; срок жизни от 10 минут до 30 дней, по умолчанию 3 дня. Точные лимиты шлюза уточняются у менеджера WATA.

Ищет платёжные ссылки терминала. Пагинация постраничная: skipCount и maxResultCount — в отличие от поиска транзакций, где используется курсор.

Возвращает ссылку целиком, включая блок digitalGood, которого нет в результатах поиска.

Ищет транзакции терминала. Пагинация КУРСОРНАЯ: для следующей страницы передайте cursorId и cursorAmount из полей nextCursorId и nextCursorAmount предыдущего ответа.

Карточка транзакции. Учтите расхождение с вебхуком: здесь комиссия называется totalCommission, а в payload вебхука то же значение приходит как commission.

НЕОБРАТИМАЯ ДЕНЕЖНАЯ ОПЕРАЦИЯ. Нужны только два поля: идентификатор исходной транзакции и сумма — валюта берётся из исходной транзакции. Сумма должна быть больше нуля, не превышать доступный остаток и содержать не более двух знаков после запятой. Возврат недоступен на терминалах с продуктом «Цифровые товары + Эквайринг».

Баланс терминала на дату. Дата обязательна и может быть ТОЛЬКО сегодняшней или вчерашней по UTC — другие значения сервер отвергает. За более ранние периоды берите отчёты кабинета (wata_finance_daily).

Создаёт платёж по СБП и возвращает sbpLink для перенаправления плательщика. Только рубли — поля валюты у этого метода нет. Требуется прямая интеграция H2H.

Создаёт платёж через T-Pay и возвращает tPayLink. Только рубли, поля валюты нет.

Оплата картой по криптограмме. Криптограмму НЕЛЬЗЯ собрать на сервере: её формирует клиентский скрипт чекаута WATA в браузере плательщика, а вы лишь передаёте полученную строку. Если у вас нет готовой криптограммы, используйте платёжную ссылку (wata_acq_link_create).

Получает публичный RSA-ключ WATA в формате PEM. Авторизация не требуется. У боевого окружения и песочницы ключи РАЗНЫЕ — окружение выбирается переменной WATA_ENV.

Проверяет подлинность уведомления WATA: подпись из заголовка X-Signature по алгоритму SHA512withRSA. Передавайте СЫРОЕ тело запроса — ровно ту строку, что пришла по сети. Если разобрать JSON и собрать обратно, порядок ключей и пробелы изменятся, и проверка провалится на подлинном уведомлении. Ключ подтягивается автоматически, если не передан.

Возвращает справку по приёму уведомлений: где задать адрес, что вернуть в ответ, какие бывают события и как проверять подпись. Полезно перед написанием обработчика.

Считает стоимость пополнения Steam-аккаунта. Два сценария: по желаемой сумме зачисления на аккаунт либо по сумме платежа — выберите режим параметром by.

Создаёт заказ на пополнение Steam-аккаунта. При payment=acquiring в ответе будет ссылка на оплату для покупателя; при payment=deposit сумма спишется с депозитного баланса мерчанта.

Проверяет статус заказа на пополнение Steam. Укажите тот же payment, что и при создании: у депозитных заказов статус лежит по общему адресу, а не по адресу направления.

Возвращает стоимость покупки звёзд и минимально допустимое количество.

Создаёт заказ на покупку звёзд. Заказ может попасть в статус Review — тогда его нужно явно подтвердить (wata_dg_stars_order_confirm) или отклонить.

Подтверждает заказ, находящийся в статусе Review.

Отменяет заказ, находящийся в статусе Review.

Проверяет статус заказа на покупку звёзд.

Список доступных позиций: для topup — игры и внутриигровые позиции, для vouchers — сервисы и номиналы ваучеров. Набор зависит от способа оплаты.

Создаёт заказ на покупку игровой позиции (topup) или ваучеров (vouchers). Позицию берите из wata_dg_catalog с тем же значением payment.

Проверяет статус заказа. Для ваучеров с оплатой acquiring здесь же возвращаются коды ваучеров.

Текущий остаток депозитного баланса мерчанта — из него оплачиваются заказы с payment=deposit. Это отдельный баланс, не совпадающий с кошельком кабинета.