Что вообще за Revolut Business API и зачем он нужен

Если вы используете Revolut Business для операций с валютами, платежами, картами и так далее, рано или поздно появляется мысль: «Всё это можно было бы автоматизировать». И это правда — рутины много, а времени мало. Revolut Business API — это как раз про автоматизацию.

API (Application Programming Interface) — по сути, набор правил и методов, через которые одна программа общается с другой. Представьте: ваш сайт или сервис хочет отправить платёж, но вы не хотите каждый раз заходить в личный кабинет, подтверждать код, копировать реквизиты вручную. С API всё это делается парой строк кода.

Но есть важный нюанс: API — это не волшебная кнопка «всё автоматизировано», а инструмент, который нужно правильно подключить. Если ошибиться с правами доступа или scope, вы либо не получите нужный функционал, либо откроете слишком много — и это уже вопрос безопасности.

Отсюда вытекает вопрос о подписках. Revolut Business API — это не одна большая кнопка «доступ ко всему», а отдельные функциональные блоки, каждый из которых нужно подключить отдельно. Такая подписка в данном контексте — это активация определённого набора функций API для вашего бизнес-аккаунта.

Сейчас разберём, как это работает, из чего выбирать и на что обращать внимание.

Какие вообще бывают подписки в Revolut Business

На момент написания статьи Revolut предлагает несколько уровней пакетов для бизнеса:

Basic — бесплатный, с ограниченным функционалом и лимитами. Подходит для микробизнеса или просто чтобы посмотреть, как всё устроено.
Growth — уже что-то посерьёзнее. Можно выпускать карты, подключать сотрудников, настраивать базовую аналитику. Часто именно с него начинают, когда рутина начинает отнимать больше времени, чем сама работа.
Scale — для более крупных задач. Здесь уже больше лимитов, более гибкие настройки. Многие компании переходят сюда, когда текущий пакет начинает «жевать» ограничения или не хветает нужных опций.
Enterprise — максимальный уровень с максимальными возможностями. Тут уже речь про крупный бизнес, кастомные решения, интеграции, которые строятся под конкретную компанию.

Для доступа к API обычно достаточно тарифа Growth и выше. Basic тоже может давать базовый доступ, но с серьёзными лимитами, и если вы хотите реально что-то автоматизировать, то Basic быстро упирается в потолок.

Важно понимать: одного «API-тарифа» как отдельной сущности в системе нет. API-доступ встроен в существующие пакеты. То есть вы не покупаете «подписка на API» — вы выбираете пакет, который открывает нужные вам возможности, включая API.

Кому и зачем подключать API

Не каждому бизнесу API вообще нужен. Иногда это оверквалифайд — как покупать профессиональный сварочный аппарат, если у вас только пара гвоздей в гараже ржавеет.

Но если вы узнаёте себя хотя бы в одном из следующих сценариев — подключение API имеет смысл:

У вас интернет-магазин и вы хотите, чтобы возвраты, выплаты или платежи проходили автоматически, без участия бухгалтера каждую операцию.
Вы платите подрядчикам, самозанятым или сотрудникам за рубежом и устали каждый раз вводить реквизиты и подтверждать коды.
Вам нужна синхронизация данных между Revolut и вашей учётной системой (например, выгрузка транзакций, статусы платежей, остатки по счетам).
Вы разрабатываете финтех-продукт, который даёт вашим клиентам доступ к платежам, и вам нужна платформа «как сервис».
У вас много юридических лиц или проектов в одной учётной записи и нужно разграничивать права доступа для разных людей/систем.
Вы просто не любите рутину и готовы один раз настроить автоматизацию, чтобы потом не трогать это руками.

Если же вы делаете 5-10 переводов в месяц, ведёте один счёт и всех сотрудников у вас — два человека, сидящих рядом, то API, скорее всего, не окупит времени на подключение. Честно.

Как подключить API: пошагово

Процесс не самый сложный, но требует внимательности на каждом этапе. Поехали.

Шаг 1. Определяем, какой тариф нам нужен

Сначала идём в личный кабинет Revolut Business и выбираем подходящий пакет. Смотрим:

Есть ли в выбранном тарифе API-доступ.
Какие лимиты на операции — количество транзакций в месяц, максимальные суммы, количество карт и т.п.
Поддерживает ли тариф множественные счета — если у вас несколько счетов в разных валютах, это может быть критично.

На этом этапе не нужно гнаться за максимальным тарифом. Берите тот, который закрывает ваши текущие задачи + небольшой запас. Всегда можно апгрейдить, а вот понизить тариф без потери некоторых функций — уже сложнее.

Шаг 2. Переходим в раздел API

После активации нужного тарифа в интерфейсе личного кабинета должен появиться раздел, связанный с API (обычно в разделе настроек или интеграций). Там же можно:

Сгенерировать API-ключи (если они ещё не созданы).
Настроить права доступа (scope) — то есть определить, что можно делать через API, а что нет.
Указать технические настройки — webhook URL, разрешённые IP-адреса и прочее.

Шаг 3. Настраиваем scope — права доступа

Это один из самых важных этапов, и именно здесь чаще всего ошибаются.

Scope — это набор разрешений, который выдаётся конкретному API-ключу. Грубо говоря, это ответ на вопрос: «Что этот ключ может делать?».

Простой пример: у вас два ключа. Один используется для проверки баланса и выгрузки отчётов. Второй — для отправки платежей. Логично дать первому ключу право только на чтение (read), а второму — ещё и на запись/отправку (write).

Зачем так делать?

Безопасность. Если ваш ключ с правом на чтение утечёт, максимум, что сделает злоумышленник — посмотрит баланс. Если бы у него был ключ с правом на отправку платежей — ситуация была бы в сотни раз хуже.
Порядок. Разделение ключей по функционалу помогает не запутаться при разработке и поддержке.
Аудит. Если что-то пойдёт не так, проще понять, какой ключ ответственен за какую операцию.

Шаг 4. Получаем и сохраняем API-ключи

Когда scope настроен, генерируем сам ключ. После генерации система покажет вам:

Client ID
Client Secret
Возможно — токен или сертификат (зависит от метода авторизации)

Важно: сохраните эти данные надёжно. Client Secret обычно показывается только один раз — если закрыли окно и не скопировали, придётся генерировать новый. Это не конец света, но лишняя работа и задержка.

Храните ключи:

Не в Google Docs общем доступе.
Не в коде, который выкладывается в публичные репозитории.
Лучше в защищённом хранилище секретов (Vault, KMS, переменные окружения на сервере с ограниченным доступом).

Шаг 5. Интегрируем с нашей системой

Тут начинается технический этап, который зависит от того, с чем вы интегрируете. Общая схема примерно такая:

Изучаем документацию Revolut Business API. Там описаны доступные эндпоинты (endpoints), методы (GET, POST и т.п.), форматы запросов и ответов.
Настраиваем авторизацию в запросах — используем полученные ключи для получения access_token, который подставляется в заголовки запросов.
Делаем тестовые запросы в «песочнице» (sandbox), если она доступна. Это среда, где можно крутить API без реальных денег.
Проверяем основные сценарии: получение баланса, список транзакций, создание платежа, статус платежа.
Переводим всё в боевую среду и ещё раз тестируем, уже с реальными, но небольшими суммами.

Если у вас есть разработчик или подрядчик — скиньте ему документацию и ключи. Если делаете сами — готовьтесь к тому, что первый рабочий прототип может занять пару дней, даже если кажется, что «там всего пара запросов».

Сравнение тарифов с точки зрения API

Ниже — примерное сравнение того, что вы получаете на разных уровнях подписки с точки зрения API. Конкретные цифры и доступность функций могут меняться — всегда сверяйтесь с актуальной информацией в личном кабинете или у поддержки Revolut.

Параметр	Basic	Growth	Scale	Enterprise
Доступ к API	Ограниченный	Базовый	Расширенный	Полный
Лимиты на операции	Низкие	Средние	Высокие	Индивидуальные
Гибкость настройки scope	Минимальная	Есть базовые роли	Более детальная	Максимальная
Поддержка	Общая очередь	Стандартная	Приоритетнее	Персональный менеджер
Для кого	Микробизнес, тесты	Малый и средний бизнес	Растущие компании	Крупный бизнес, финтех

Если совсем просто: для старта и первых интеграций обычно хватает Growth. Если вы уже понимаете, что API будет критичной частью вашей инфраструктуры — смотрите в сторону Scale или Enterprise.

Что выбрать в зависимости от вашей ситуации

Ситуация 1: Вы владелец небольшого интернет-магазина

У вас пара сотен заказов в месяц, один счёт в Revolut, бухгалтер частично на аутсорсе. Вы хотите автоматизировать возвраты и сверку платежей.

Что делать: начать с Growth. Этого обычно достаточно для базовой работы с API. Настройте выгрузку транзакций и автоматические возвраты. Если прямо сейчас всё работает и лимиты не упираются — можно не апгрейдить.

Ситуация 2: Вы финтех-стартап

Вы строите продукт, который будет показывать вашим клиентам их балансы, совершать платежи от их имени, собирать аналитику. То есть Revolut выступает у вас как платформа-как-сервис (BaaS).

Что делать: скорее всего, вам нужен Scale или Enterprise, и это уже не столько про «выбрать тариф», сколько про индивидуальные переговоры с Revolut. Обязательно свяжитесь с их отделом по работе с бизнесом/партнёрами, обсудите лимиты, SLA, кастомные интеграции.

Ситуация 3: У вас несколько юрлиц и проектов

Вы держите в Revolut несколько счетов для разных направлений бизнеса, у вас несколько сотрудников, которым нужен разный уровень доступа.

Что делать: как минимум Scale. Здесь уже важна гибкость в управлении правами доступа, разделении ролей, настройке scope под каждого пользователя/систему. Плюс — более высокие лимиты, чтобы не упираться в потолок при росте.

Ситуация 4: Вы просто хотите попробовать

У вас нет срочных задач, но интересно поиграться с API, понять, как оно работает, может быть, сделать внутренний инструмент.

Что делать: можно начать с Basic, если он даёт доступ к нужным вам эндпоинтам. Если нет — перейти на Growth на время экспериментов. Не забывайте про sandbox, если он доступен — это хороший способ потренироваться без рисков.

Частые ошибки при подключении API

Теперь про грабли, на которые наступают чаще всего.

Слишком широкий scope «на будущее». Логика «дадим права на всё, авось пригодиться» — это минус к безопасности. Лучше начинать с минимально необходимого набора прав и расширять по мере необходимости.
Хранение ключей в коде или репозитории. Публичный репозиторий с Client Secret — это приглашение для всех желающих поиграться с вашими деньгами. Учитесь работать с переменными окружения и секрет-менеджерами с самого начала.
Игнорирование лимитов. У API есть лимиты на количество запросов, на объём операций и так далее. Если вы их не учитываете, в какой-то момент интеграция просто перестаёт работать — запросы начинают отклоняться.
Нет обработки ошибок. Если ваш код уверен, что каждый запрос проходит успешно, — значит, вы ещё не сталкивались с реальным продакшеном. Нужно корректно обрабатывать таймауты, ошибки 4xx/5xx, ретраи, деградацию сервиса.
Нет разделения ключей по задачам. Один ключ «на всё» — это нормально для старта, но когда у вас уже несколько систем, лучше разделить: один ключ на чтение, другой на платежи, третий на что-то ещё.
Забывают про webhook и статусы. Вместо того чтобы постоянно опрашивать API «а изменилось ли что-то», лучше настроить вебхуки — сам Revolut будет присылать вам события об изменениях. Это и эффективнее, и спокойнее.

Как лучше сделать: практические советы

Несколько простых рекомендаций, которые сэкономят вам нервы в будущем.

Начинайте с малого. Не пытайтесь сразу построить «универсальную систему автоматизации». Сделайте одну конкретную интеграцию, которая закроет самую болезненную часть рутины. Например, выгрузку транзакций или автоматические выплаты.
Используйте песочницу. Если есть sandbox — используйте его по максимуму. Проверяйте сценарии, ошибки, нестандартные ситуации там, а не в боевой среде.
Документируйте свои интеграции. Подписывайте, какой ключ за что отвечает, какие системы с ним работают, кто имеет доступ. Когда вас будет больше одного человека — это спасёт кучу времени.
Следите за лимитами и логами. Настройте базовый мониторинг: сколько запросов уходит, какие ошибки возникают, не приближаетесь ли вы к лимитам. Это не должно быть сложно — даже простой лог и пара алертов уже много дают.
Планируйте рост. Если вы чувствуете, что через полгода-год вы вырастете из текущего тарифа — заложите это в план. Апгрейд тарифа — не мгновенный процесс, и хорошо бы делать это не в режиме пожара.

Итог: что делать дальше

Подписка на сервисы через Revolut Business API — это не магия, а вполне конкретный набор шагов:

Определить, какие задачи вы хотите автоматизировать.
Выбрать подходящий тариф (чаще всего Growth или Scale).
Включить API-доступ в личном кабинете.
Настроить scope — права доступа под каждую задачу.
Сгенерировать и безопасно сохранить ключи.
Интегрировать с вашей системой, обязательно потренировавшись в тестовой среде.
Не забывать про безопасность, лимиты и мониторинг.

Если вы только начинаете — не нужно сразу строить сложные интеграции. Возьмите одну конкретную боль (например, ручная сверка платежей) и автоматизируйте её. Когда заработает, будет понятно, куда двигаться дальше.

А если чувствуете, что API — это про вас и надолго, не стесняйтесь связаться с поддержкой Revolut и обсудить более высокие тарифы и индивидуальные условия. На уровне Scale и Enterprise условия часто обсуждаются персонально, и это может быть выгоднее, чем просто брать максимальный пакет «вслепую».

Информация в статье носит ознакомительный характер. Условия тарифов, доступность API и конкретные функции могут меняться. Перед подключением и настройкой интеграций рекомендуется уточнять актуальные детали в официальной документации Revolut и у профильных специалистов.