Как провести миграцию с Robokassa на CloudPayments без простоя сайта

Вы решили уйти с Robokassa на CloudPayments. Причина может быть любой — не устраивают тарифы, хочется более современный API, нужны чеки 54-ФЗ без танцев с бубном или просто надоело ждать ответа поддержки. Но есть проблема: сайт принимает платежи каждый день, и неделю простоя в период переключения никто не планирует. Давайте разберёмся, как сделать так, чтобы переход прошёл незаметно для покупателей и без потери денег.

Почему нельзя просто «выключить одно и включить другое»

На первый взгляд кажется логичным: в последний день месяца выключить Robokassa, на следующий — подключить CloudPayments. Но реальность сложнее. У вас одновременно могут висеть незавершённые платежи, подписки, возвраты. Если вырубить старый шлюз, часть операций потеряется. Деньги не дойдут до вас, клиенты получат ошибки, а поддержка будет разбираться неделями.

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

Что нужно сделать до начала миграции

Прежде чем трогать код на сайте, подготовьте всё остальное. Это сэкономит вам нервы и время.

1. Зарегистрируйтесь в CloudPayments и пройдите модерацию. Это не мгновенный процесс — компании нужно проверить ваши документы. Начните заранее.
2. Получите тестовые ключи (API Key и Public ID). Они понадобятся для настройки в «песочнице».
3. Убедитесь, что ваша онлайн-касса совместима с CloudPayments. Если у вас уже есть касса, работающая по 54-ФЗ, проверьте — поддерживает ли она интеграцию с новым агрегатором.
4. Сделайте бэкап текущей интеграции с Robokassa. Сохраните все файлы с настройками, скрипты обработки уведомлений, логи.
5. Запишите все текущие подписки и рекуррентные платежи, если они есть. Их придётся переводить отдельно.

Сравнение Robokassa и CloudPayments: что реально меняется

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

Параметр	Robokassa	CloudPayments
Рекуррентные платежи	Поддерживаются, но через свои механизмы	Поддерживаются через токены карт
Чеки 54-ФЗ	Через подключение сторонней кассы или ОФД	Встроенная интеграция с кассами
API	REST + XML	REST, JSON
Страница оплаты	Перенаправление на страницу Robokassa	Встроенная виджет-форма или перенаправление
Поддержка Apple Pay / Google Pay	Ограниченная	Полноценная
Тарифы для интернет-магазинов	От 2,9% + фиксированная сумма (зависит от оборота)	От 2,5% (зависит от категории и оборота)
Возвраты	Через личный кабинет или API	Через API или личный кабинет

>

Тарифы указаны ориентировочные — точные зависят от категории бизнеса, оборота и условий договора. Уточняйте у вашего менеджера.

Пошаговый план миграции без простоя

Шаг 1. Настройте тестовый контур CloudPayments

Используйте тестовый режим, чтобы проверить все сценарии: успешная оплата, отказ, возврат, холдирование. Убедитесь, что ваш разработчик понимает разницу между тестовыми и боевыми ключами. Проверьте обработку вебхуков — CloudPayments отправляет уведомления о статусах платежей, и логика обработки может отличаться от Robokassa.

Шаг 2. Внедрите параллельную работу двух шлюзов

Это ключевой этап. На сайте нужно настроить логику, при которой платежи могут проходить через оба агрегатора. Самый простой вариант — добавить в настройках платёжного модуля возможность выбора шлюза или настроить маршрутизацию по определённым правилам.

Например:

• Первые 10% платежей направляются через CloudPayments для проверки
• Если система работает стабильно — увеличиваем долю до 50%
• После успешного тестирования переводим 100% трафика на новый шлюз
• Robokassa оставляем для обработки старых подписок и возвратов

Шаг 3. Настройте обработку вебхуков от обеих систем

CloudPayments и Robokassa по-разному отправляют уведомления о статусах платежей. Убедитесь, что ваш сервер корректно обрабатывает оба формата. Проверьте:

• Корректность проверки подписи (Signature) от каждого шлюза
• Обработку статусов: оплачено, отменено, возвращено, ожидает подтверждения
• Логирование всех входящих уведомлений для отладки

Шаг 4. Переведите рекуррентные платежи

Это самая сложная часть. Если у вас есть подписки или регулярные списания, нельзя просто взять и переключить их. Вам нужно:

1. Получить согласие клиентов на списание через новый шлюз (если это требуется по договору)
2. Сохранить токены карт или запросить у клиентов повторный ввод данных
3. Настроить новый цикл рекуррентных платежей в CloudPayments
4. Первые несколько списаний проверить вручную

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

Шаг 5. Отключите Robokassa

Когда весь основной трафик идёт через CloudPayments, а старые подписки завершились, можно отключить Robokassa. Но не удаляйте его полностью сразу — оставьте доступ к личному кабинету для обработки возвратов и просмотра истории платежей.

Частые ошибки при миграции

Здесь — то, что чаще всего идёт не так, по опыту реальных переходов:

• Не проверяют обработку ошибок. В тестовом режиме всё работает, а в боевом появляются неизвестные статусы платежей. Всегда предусматривайте обработку неизвестных статусов с логированием.
• Забывают про рекуррентные платежи. После отключения Robokassa подписки перестают продлеваться, клиенты жалуются, а вы теряете доход.
• Не настраивают должным образом проверку подписи вебхуков. Это прямая дорога к фродам — кто-то может подделать уведомление об оплате.
• Переключают всё сразу без тестирования. Если есть ошибка в интеграции, вы узнаете о ней только когда клиенты начнут жаловаться на неудачные платежи.
• Не учитывают особенности 54-ФЗ. Если вы переходите на другую кассу или меняете ОФД, нужно перерегистрировать кассу в ФНС. Это занимает время.

Как лучше сделать в зависимости от вашей ситуации

Если у вас простой интернет-магазин без подписок: можно провести миграцию за 1–2 недели. Настройте параллельную работу, проверьте основные сценарии, переключите трафик и отключите старый шлюз.

Если у вас есть подписки или регулярные платежи: закладывайте 4–6 недель. Потребуется перевести все рекуррентные платежи на новый шлюз, получить согласие клиентов, провести тестовые списания.

Если у вас высокий оборот и нулевая толерантность к ошибкам: рассмотрите вариант с частичным переключением трафика на протяжении 2–4 недель. 10% → 30% → 50% → 100%. Это снизит риск массовых проблем при обнаружении ошибок.

Если вы работаете с маркетплейсами или агрегаторами: уточните у них условия — некоторые площадки требуют определённых платёжных систем или имеют свои интеграции.

Что проверить после переключения

После того как основной трафик перешёл на CloudPayments, не расслабляйтесь. Первые дни — критически важные:

• Мониторьте успешность платежей — соотношение успешных и неуспешных транзакций
• Проверяйте приход денег на расчётный счёт — сроки зачисления могут отличаться
• Убедитесь, что чеки формируются корректно и отправляются клиентам
• Следите за обработкой возвратов — они должны работать так же гладко, как и оплата
• Проверьте работу на разных устройствах и в разных браузерах

Итог

Миграция с Robokassa на CloudPayments без простоя — это не одномоментное переключение, а процесс, который требует подготовки и параллельной работы двух систем. Начните с регистрации в CloudPayments и получения тестовых ключей. Внедрите параллельную обработку платежей, постепенно увеличивая долю трафика через новый шлюз. Не забудьте про рекуррентные платежи и особенности работы с онлайн-кассой. И главное — не торопитесь. Лучше потратить лишнюю неделю на проверку, чем потерять деньги и репутацию из-за массовых ошибок при оплате.

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

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