Подключение ЮMoney (кошелёк)

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

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

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

1. Кошелёк ЮMoney — номер вида 4100 1XXX XXXX XXXX (виден в кабинете yoomoney.ru).
2. Секрет HTTP-уведомлений — берётся на специальной странице настроек кошелька (шаг 2 ниже).

⚠️ Частая ошибка. В ЮMoney есть раздел «Данные приложения» с длинным кодом client_id — это не тот секрет. Регистрация приложения для приёма оплат не нужна. Нужен именно секрет со страницы HTTP-уведомлений.

Шаг 1. Введите кошелёк в ОКНА

1. Откройте Настройки → Приём оплаты.
2. Выберите провайдер ЮMoney.
3. В поле Номер кошелька введите номер (только цифры).
4. Поле Секрет HTTP-уведомлений пока оставьте — возьмём его на шаге 2.
5. Скопируйте адрес из блока «Webhook URL для кабинета провайдера» — он персональный, вида:

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

Шаг 2. Настройте HTTP-уведомления в ЮMoney

1. Откройте страницу настроек уведомлений кошелька: yoomoney.ru → Настройки → HTTP-уведомления (прямой адрес: yoomoney.ru/transfer/myservices/http-notification).
2. В поле адреса вставьте скопированный Webhook URL из шага 1.
3. Включите «Отправлять уведомления».
4. На этой же странице показан секрет для проверки подлинности — скопируйте его.

Шаг 3. Сохраните секрет в ОКНА

1. Вернитесь в ОКНА → Настройки → Приём оплаты → ЮMoney.
2. Вставьте секрет в поле Секрет HTTP-уведомлений.
3. Нажмите Сохранить и включить.

Шаг 4. Проверьте связь

1. На странице HTTP-уведомлений ЮMoney нажмите «Протестировать» — ЮMoney отправит тестовое уведомление (платёж при этом не проводится).
2. В ОКНАх в форме ЮMoney блок «Проверить подключение» станет зелёным: «Подключение проверено».

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

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

• В письме о записи (и в напоминании об оплате) — кнопка «Оплатить сеанс».
• Открывается страница оплаты, оттуда — форма ЮMoney, где клиент выбирает оплату картой или со своего кошелька.
• После оплаты запись автоматически помечается оплаченной.

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

Нужно ли регистрировать «приложение» в ЮMoney? Нет. Достаточно кошелька и страницы HTTP-уведомлений. Код client_id из «Данных приложения» в ОКНАх не используется.

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

Есть ли лимиты? Да, у ЮMoney есть лимиты на анонимные/именные кошельки — чем выше статус идентификации кошелька, тем выше лимиты. Проверьте статус в кабинете ЮMoney.

Можно ли принимать валюту? Нет, только рубли. Для валютных клиентов — Stripe или PayPal.

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

• «Протестировать» проходит, но блок в ОКНАх не зеленеет. Проверьте, что вставили Webhook URL целиком — включая &org=… (он персональный).
• Блок не зеленеет и оплата не засчитывается. Секрет в ОКНАх не совпадает с секретом на странице HTTP-уведомлений. Пересоздайте секрет в ЮMoney, вставьте заново в ОКНА и повторите «Протестировать».
• Оплата прошла, но запись «Не оплачено». Убедитесь, что уведомления включены («Отправлять уведомления»), и что платили по ссылке из ОКОН (а не переводом на кошелёк напрямую — такой перевод к записи не привяжется). Оплату можно отметить вручную в карточке записи.
• Не помогло — напишите нам через Обратную связь на Главной.