Онлайн-оплата через ЮKassa на сайте детского сада
Родитель платит на странице ЮKassa теми способами, что включены в магазине. Деньги получает сад по своему договору с ЮKassa, а сайт узнаёт об оплате, сверяет её у ЮKassa и вносит в учёт.
- Что вписать в админке
- shopId и секретный ключ
- Уведомления об оплате
- HTTP-уведомления в кабинете ЮKassa: адрес сайта и три события
- Чек 54-ФЗ
- «Чеки от ЮKassa», своя касса в ЮKassa или облачная касса
- Для проверки
- Тестовый магазин со своим shopId
Как подключить ЮKassa
Магазин, ключ API и адрес для уведомлений. Ключи в примере вымышленные.
-
Магазин в ЮKassa
Зарегистрируйтесь на yookassa.ru и подключите магазин. Для проверки сразу создайте тестовый магазин: у него свой shopId и ключ, деньги не списываются.
-
Ключ API
«Интеграция» → «Ключи API»: выпустите секретный ключ. shopId — номер магазина в личном кабинете.
-
Настройки → Онлайн-оплата
Выберите ЮKassa и вставьте shopId и секретный ключ.
В админке: Банк shopId Секретный ключ
-
HTTP-уведомления
В кабинете ЮKassa: «Интеграция» → «HTTP-уведомления». Вставьте адрес из настроек сайта и отметьте события payment.succeeded, payment.canceled и refund.succeeded.
Адрес для HTTP-уведомлений — вставить в кабинете ЮKassa
https://ваш-сайт/pay/notify/yookassa -
Проверить подключение
Сайт запрашивает у ЮKassa список платежей магазина. Если ключи верные, ЮKassa отвечает, а сайт напоминает про адрес для уведомлений.
В админке: Проверить подключение
-
Чеки
Если чеки пробивает ЮKassa — «Чеки от ЮKassa» или своя касса, подключённая к магазину, — выберите в «Чеках 54-ФЗ» вариант «Чек пробивает банк».
В админке: Кто пробивает чек
Что происходит после «Оплатить»
Сайт не верит уведомлению на слово: статус и сумму он берёт у самой ЮKassa.
Платёж в ЮKassa
Сайт создаёт платёж и ведёт родителя на страницу ЮKassa. Платёж одностадийный: деньги списываются сразу, подтверждать его в кабинете не нужно.
Уведомление
ЮKassa сообщает о платеже на адрес сайта. Уведомления ЮKassa не подписаны, поэтому сайт берёт из них только номер платежа.
Сверка с ЮKassa
По номеру сайт сам запрашивает у ЮKassa статус и сумму. Если ЮKassa не ответила, сайт просит прислать уведомление позже.
Оплата на сайте
Когда ЮKassa подтвердила платёж и сумма совпала до копейки, оплата попадает в «Оплаты», период продлевается, родителю приходит «Оплата получена».
Чек, возврат и проверка
- Чек 54-ФЗ
- С платежом сайт передаёт ЮKassa позицию чека: название услуги, сумму, ставку НДС, систему налогообложения и почту или телефон родителя. Для «Чеков от ЮKassa» нужна почта, поэтому страница счёта её спрашивает. Облачные кассы
- Возврат
- Возврат делается в личном кабинете ЮKassa. По событию refund.succeeded сайт узнаёт о нём, отмечает счёт «Возвращён» и пишет сотрудникам, чтобы они поправили оплату.
- Тестовый магазин
- Тестовый магазин ЮKassa работает со своими shopId и ключом и не списывает деньги. Проверьте на нём оплату и уведомления, потом замените ключи на рабочие.
- Повторное нажатие
- Если родитель нажал «Оплатить» ещё раз вскоре после первого, сайт вернёт его на уже созданный платёж, а не создаст второй.
Частые вопросы
Не нашли ответ — напишите нам.
Какие события отмечать в HTTP-уведомлениях?
payment.succeeded, payment.canceled и refund.succeeded. Без уведомлений сайт узнает об оплате, только когда родитель вернётся со страницы ЮKassa, или при проверке по расписанию.
Зачем сайт переспрашивает ЮKassa после уведомления?
ЮKassa не подписывает уведомления. Чтобы посторонний запрос не отметил счёт оплаченным, сайт берёт статус и сумму из ответа самой ЮKassa по номеру платежа.
Нужна ли почта родителя?
Для «Чеков от ЮKassa» — да. Если в карточке семьи почты нет, родитель впишет её на странице счёта в поле «Почта для чека».
Сколько стоит приём оплаты?
Тарифы — у ЮKassa, на её сайте. Система процент с платежей не берёт.
Можно ли сначала проверить без денег?
Да: подключите тестовый магазин ЮKassa или включите на сайте тестовую оплату, которая обходится вовсе без банка.
ЮKassa на сайте детского сада и центра
С ЮKassa страница оплаты принадлежит ЮKassa: родитель уходит на неё со страницы счёта и видит способы оплаты, которые включены в вашем магазине. Сайт сада платёжных данных не принимает, он создаёт платёж и ждёт результата.
Что нужно от сада
Магазин в ЮKassa, shopId, секретный ключ из раздела «Ключи API» и адрес для HTTP-уведомлений. Ключи вписываются в «Настройках» → «Онлайн-оплата», адрес уведомлений сайт показывает там же, с кнопкой копирования. Для проверки подойдёт тестовый магазин: платежи в нём не списывают деньги.
Почему сайт переспрашивает ЮKassa
Уведомления ЮKassa приходят без подписи. Чтобы посторонний не отметил счёт оплаченным, сайт берёт из уведомления только номер платежа и запрашивает статус и сумму у ЮKassa. Если ЮKassa в эту минуту не ответила, сайт отвечает ошибкой, и уведомление придёт повторно. Сумма сверяется со счётом до копейки: при расхождении оплата не вносится, а сотрудники получают письмо.
Чеки
«Чеки от ЮKassa» или своя касса, подключённая к магазину, пробивают чек по данным, которые сайт передаёт вместе с платежом: название услуги, сумма, ставка НДС, система налогообложения и признак расчёта. Название складывается из начала, которое задал бухгалтер, и назначения счёта, например «Присмотр и уход за ребёнком, Ясли, октябрь 2026». Если чеки пробивает облачная касса, её выбирают в «Чеках 54-ФЗ».
У детского центра так же оплачиваются абонементы: родитель покупает абонемент в кабинете, платит на странице ЮKassa, и абонемент с остатком занятий появляется у ребёнка, как только ЮKassa подтвердила платёж.
Счета и кабинет
Счёт выставляет администратор или начисления месяца, а родитель с помесячным тарифом может оплатить следующий месяц сам, кнопкой «Оплатить» в кабинете. Ссылка на счёт открывается без входа, её можно переслать в мессенджер. Всё, что прошло через ЮKassa, видно в разделе «Онлайн-оплаты» вместе с журналом ответов.
Другие банки, кассы и переводы
Нет вашего банка или кассы?
Напишите — добавим в ближайшем обновлении. Укажите банк или сервис касс и что у сада уже подключено: эквайринг, касса, ОФД.
Написать намОплатите счёт в демо
В демо включена тестовая оплата. Войдите в кабинет родителя, нажмите «Оплатить» — деньги не спишутся — и найдите оплату в админке, в разделе «Онлайн-оплаты». Настройки банков и касс в демо открыты для просмотра.
