Что подготовить перед стартом
Чтобы подключение прошло без срывов, заранее подготовьте:
- юридические данные (ИП/ООО/самозанятый), ИНН/ОГРН, банковские реквизиты;
- домен с действующим HTTPS-сертификатом и доступом к админке сайта;
- CMS/движок (или команду разработчиков) для установки модуля/интеграции;
- контактные данные для договора и модерации.
Дополнительно стоит заранее изучить Тарифы, комиссии и вывод, чтобы спрогнозировать юнит-экономику.
Шаг 1. Регистрация Robokassa и вход в личный кабинет
- Перейдите на официальный сайт Robokassa и начните регистрацию.
- Подтвердите email/телефон и задайте надежный пароль.
- После регистрации авторизуйтесь через личный кабинет Robokassa — вход.
В личном кабинете вы создадите магазин (мерчант), настроите уведомления и получите ключи для интеграции.
Шаг 2. Создание мерчанта и договор
«Мерчант Robokassa подключение» включает заполнение анкеты, указание домена, описания бизнеса и прохождение модерации. На этом этапе важно корректно принять условия оферты/заключить договор Robokassa и загрузить требуемые документы.
Набор документов обычно включает уставные и регистрационные данные, карточку компании и подтверждение доменного имени/прав на сайт. Срок модерации зависит от профиля бизнеса и полноты данных.
Подсказка: если у вас франшиза/мультидомен, заранее продумайте структуру магазинов — один мерчант на несколько сайтов или отдельный мерчант на каждый.
Шаг 3. Техническая настройка: Result URL, Success/Fail, ключи
Ключевой шаг — правильно настроить адреса уведомлений и подпись запросов:
- Result URL Robokassa (часто ищут как «result url robokassa») — серверный вебхук, на который Robokassa отправляет результат платежа. Должен быть доступен по HTTPS, принимать POST/GET и возвращать корректный ответ.
- Success URL — страница, куда попадает пользователь после успешной оплаты.
- Fail URL — страница на случай неуспешной оплаты/отмены.
- Пароли #1 и #2 (секретные ключи) — используются для формирования и проверки подписи запросов. Храните их только на сервере.
Таблица рекомендаций по настройке:
| Параметр |
Назначение |
Рекомендации |
| Result URL |
Серверное подтверждение оплаты |
Принимать только HTTPS, логировать запросы, проверять подпись и сумму |
| Success URL |
Клиентская страница успеха |
Показывать чек/статус заказа, не менять статус без Result |
| Fail URL |
Клиентская страница ошибки |
Давать возможность повторить оплату |
| Подпись |
Защита от подмены |
Использовать Пароль #2 для вебхука, сверять валюту/сумму/InvoiceID |
Если нужен кастомный флоу или кастомные статусы, изучите Robokassa API: интеграция.
Шаг 4. Подключение через модуль CMS или API
Есть два пути: готовые модули или индивидуальная интеграция.
- Модули и плагины. Самый быстрый способ. Установите расширение для вашей CMS из раздела Модули и плагины Robokassa, укажите MerchantLogin, Пароль #1/#2, валюту и необходимые URL. Проверьте совместимость версии модуля и CMS.
- API-интеграция. Подходит для кастомных сайтов и мобильных приложений. Реализуйте редирект/виджет оплаты, подпись запросов, обработчик Result URL, обновление статусов заказов и логирование. Подробности — в Robokassa API: интеграция.
Совет: начните с модуля, если ваша CMS поддерживается — так вы быстрее пройдете модерацию и тесты.
Шаг 5. Тестовый режим Robokassa и проверка сценариев
Перед включением «боевого» режима используйте тестовый режим Robokassa. В нем платежи симулируются, а вебхуки ходят на ваши URL без списаний.
Что проверить в тестах:
| Сценарий |
Что должно произойти |
Где смотреть |
| Успешная оплата |
Заказ меняет статус на «оплачен» после Result |
Логи сервера, админка CMS |
| Отмена/ошибка |
Заказ остается «не оплачен», показан Fail |
Страница Fail URL |
| Несовпадение суммы |
Система отклоняет уведомление |
Логи подписи, уведомление об ошибке |
| Повторный Result (идемпотентность) |
Статус не меняется повторно |
Логи: «уже обработан» |
| Отправка чека |
Фискальный чек формируется и отправлен |
Раздел чеков в ЛК и почта клиента |
Для визуального контроля включите подробное логирование в модуле и на сервере приложений.
Шаг 6. Переход в рабочий режим и запуск
Когда тесты пройдены и модерация завершена:
- переключите магазин из тестового в рабочий режим в ЛК;
- еще раз сохраните Production-ключи и проверьте, что на сайте используются именно они;
- убедитесь, что Success/Fail/Result URL доступны из интернета и не блокируются файрволом;
- разместите на сайте информацию о способах оплаты и возвратах.
Для повышения конверсии добавьте логотипы методов оплаты и страницу с пояснениями — см. Оплата через Robokassa.
Способы оплаты, чеки и возвраты
- Методы оплаты. Подключите нужные способы в ЛК: банковские карты, СБП, Apple Pay/Google Pay и др. Подробности — в разделе Способы оплаты: СБП, Apple/Google.
- Чеки и фискализация. Если вы обязаны пробивать чеки, активируйте интеграцию с ККТ/ОФД. Пошагово описано в материале Robokassa — чек и фискализация.
- Возвраты и чарджбеки. Настройте процессы частичного/полного возврата и регламенты для поддержки — см. Возвраты и чарджбеки.
Комиссии, вывод средств и бухгалтерия
Проверьте действующие ставки, график зачислений и способы вывода в статье Тарифы, комиссии и вывод. Убедитесь, что применяемые тарифы соответствуют вашему обороту и категориям MCC.
Если у вас есть аудитория для рекомендаций Robokassa, изучите возможности монетизации через Партнерскую программу. Кейсы внедрения и идеи оптимизации конверсии — в разделе Отзывы и кейсы.
Типичные ошибки и как их исправить
Ниже — краткий список частых проблем после подключения и их решения.
| Симптом |
Вероятная причина |
Что делать |
| «Неверная подпись» |
Пароли #1/#2 перепутаны или ошибка в порядке полей |
Перепроверьте алгоритм подписи и используемые ключи, сравните с документацией |
| Result URL не вызывается |
URL недоступен извне, редирект/блокировка |
Откройте доступ, уберите авторизацию, проверьте SSL |
| Статус меняется без Result |
Логика «успех» на Success URL |
Обновляйте статус только после серверного Result |
| Дубликаты заказов |
Повторные вебхуки/повтор клика |
Реализуйте идемпотентность по InvoiceID |
Расширенную справку смотрите в разделе Ошибки и статусы платежей.
Безопасность и лучшие практики
- Храните секретные ключи только на бэкенде, не в JS/клиенте.
- Проверяйте подпись, валюту, сумму и уникальность InvoiceID на каждом Result.
- Используйте HTTPS и корректные коды ответов (200 OK) на вебхуки.
- Логируйте все уведомления с маскированием персональных данных.
- Настройте уведомления о сбоях (алерты) и мониторинг доступности Result URL.
- Периодически обновляйте модуль/SDK до последних версий.
Чек-лист запуска
| Шаг |
Статус |
| Регистрация Robokassa и вход в ЛК |
☐ |
| Создание мерчанта и подписание договора |
☐ |
| Заполнение Success/Fail/Result URL |
☐ |
| Настройка ключей и подписи |
☐ |
| Интеграция модуля/API |
☐ |
| Тестовый режим: успешный/неуспешный платеж |
☐ |
| Проверка чеков и возвратов |
☐ |
| Включение рабочего режима |
☐ |
| Проверка комиссий и графика выплат |
☐ |
| Документация саппорта/FAQ для команды |
☐ |
Итоги и следующий шаг
Теперь вы знаете, как подключить Robokassa и пройти полную настройку — от регистрации и договора до тестов, Result URL и запуска. Выберите путь интеграции (модуль или API), проверьте сценарии в тестовом режиме и подключайте востребованные способы оплаты. При необходимости изучите смежные материалы: модули, API, комиссии и ошибки.
Готовы перейти к делу? Оставьте заявку — поможем с подключением и настройкой за короткий срок, чтобы ваши клиенты могли оплачивать покупки уже сегодня.
