ОКНА
Секундочку…
ОКНА/Справка
Вся справка

Подключение Robokassa

Robokassa — агрегатор платежей: клиент выбирает удобный способ (карта, Мир, СБП, кошельки), а деньги приходят напрямую на ваш счёт в Robokassa — ОКНА в расчётах не участвуют и комиссию не берут, вы платите только комиссию Robokassa по своему тарифу.

Валюта — только рубли (RUB).

Что понадобится

  1. Магазин, зарегистрированный в Robokassa — с ним вы получаете идентификатор магазина (MerchantLogin).
  2. Пароль #1 и Пароль #2 — оба лежат в личном кабинете Robokassa: Мои магазины → ваш магазин → Технические настройки.
  3. Знать, какая хеш-функция выбрана там же, в Технических настройках (MD5, SHA-256 или SHA-512).

Пароли для боевого и тестового режимов разные — в кабинете это две отдельные пары. Не перепутайте: боевой пароль в тестовом режиме не работает и наоборот.

Шаг 1. Введите реквизиты в ОКНА

  1. Откройте Настройки → Приём оплаты.
  2. В блоке «Россия» выберите Robokassa.
  3. Заполните поля:
    • Идентификатор магазина (MerchantLogin) — как в кабинете Robokassa;
    • Пароль #1 (подпись платежа);
    • Пароль #2 (проверка результата);
    • Алгоритм подписи — тот же, что выбран в ЛК Robokassa (Технические настройки → Хеш-функция). По умолчанию MD5.
  4. Переключатель «Тестовый режим» оставьте выключенным, если сразу принимаете реальные оплаты (подпись под ним покажет «боевой режим»).
  5. Нажмите Сохранить и включить — Robokassa сразу появится в списке способов оплаты со статусом «Активен».

Пароли хранятся только на сервере и после сохранения больше не показываются — в полях будет «•••••••• (сохранён)». Переключателем «Принимать оплату» в карточке можно в любой момент временно отключить приём, не удаляя реквизиты.

Шаг 2. Укажите Result URL в кабинете Robokassa

Под формой в ОКНАх показан блок «Webhook URL для кабинета провайдера» — адрес персональный, вида:

https://okna.one/api/public/payments/webhook?provider=robokassa&org=<ваш id>

Скопируйте его целиком (вместе с &org=…) и в личном кабинете Robokassa откройте Технические настройки:

  1. вставьте адрес в поле Result URL;
  2. метод отправки данных — POST;
  3. сохраните настройки.

Там же в кабинете задаются Success URL и Fail URL — страницы, куда Robokassa возвращает клиента после оплаты. ОКНА их не подставляют, так что клиент вернётся туда, куда укажете вы (например, на ваш сайт). На отметку оплаты это не влияет: запись помечается оплаченной по Result URL, даже если клиент никуда не вернулся.

Шаг 3. Проверьте подключение

В карточке Robokassa есть блок «Проверить подключение». Пока подтверждения нет, там написано: «Ждём тестовое уведомление из Robokassa. Совершите тестовый платёж в тестовом режиме Robokassa».

  1. Включите «Тестовый режим», введите тестовые Пароль #1 и Пароль #2 из кабинета Robokassa и сохраните.
  2. Создайте тестовую запись на себя и оплатите её на странице оплаты — в тестовом режиме реальные деньги не списываются.
  3. Блок в ОКНАх станет зелёным: «Подключение проверено». Если он не обновился — обновите страницу.

⚠️ Тестовый платёж проходит по обычной записи и пометит её оплаченной — делайте его на тестовой записи, а не на настоящей сессии клиента.

Когда проверка прошла, верните боевые пароли: выключите «Тестовый режим», введите оба боевых пароля и сохраните.

Как это видит клиент

  • В письме о записи (и в напоминании об оплате) — кнопка «Оплатить сеанс».
  • Открывается страница оплаты ОКОН: сумма, время сессии и список подключённых способов. Клиент нажимает «Оплатить» у Robokassa.
  • Дальше — страница Robokassa с уже подставленной суммой, где он выбирает карту, СБП или кошелёк.
  • После успешной оплаты запись автоматически помечается «Оплачено», а вам приходит уведомление «клиент оплатил».

Частые вопросы

Какая сумма подставляется в оплату? Персональный тариф клиента на услугу, если он задан; иначе — цена услуги. Если счёт выставлен платёжной ссылкой — сумма из ссылки.

Можно ли принимать евро или доллары? Через Robokassa — нет, только рубли. Для валютных клиентов подключите Stripe или PayPal либо укажите валютную ссылку в разделе Настройки → Приём оплаты → «Моя ссылка на оплату». Оплату по такой ссылке вы отмечаете вручную.

Клиент оплатил меньше, чем нужно. Что будет? Оплата не засчитается: запись останется «Не оплачено», а сам платёж будет виден в кабинете Robokassa.

Как сделать возврат? Возврат делается в кабинете Robokassa. В ОКНАх статус оплаты при этом не меняется — снимите отметку «Оплачено» в карточке записи вручную.

Если не работает

  • Сменили алгоритм подписи или тестовый режим, а ничего не изменилось. Такие правки сохраняются сами, без паролей — проверьте, что нажали «Сохранить» после переключения и что выбранный алгоритм действительно совпадает с тем, что в ЛК Robokassa (Технические настройки → Хеш-функция).
  • Оплата прошла, но запись «Не оплачено». Проверьте в Технических настройках Robokassa: Result URL скопирован целиком (включая &org=…), метод — POST, а хеш-функция та же, что выбрана в ОКНАх. После исправления оплату можно отметить вручную в карточке записи.
  • Robokassa показывает ошибку про номер счёта. Каждый платёж получает свой номер автоматически — если ошибка повторяется, напишите нам через Обратную связь на Главной.
  • На странице оплаты нет Robokassa. Проверьте статус карточки («Активен») и валюту записи: Robokassa показывается только у рублёвых записей.
  • Не помогло — напишите нам через Обратную связь на Главной, приложите время оплаты и номер записи.

См. также

Не нашли ответ? Напишите нам через «Обратную связь» на Главной.