Онлайн-оплата через CloudPayments на сайте детского сада
Сайт создаёт в CloudPayments счёт на сумму к оплате, родитель платит по его ссылке, а CloudPayments сообщает сайту результат подписанным уведомлением. Чеки может пробивать CloudKassir той же компании с теми же ключами.
- Что вписать в админке
- Public ID и API Secret
- Уведомления об оплате
- Pay, Fail и Refund на адрес сайта, метод POST
- Чек 54-ФЗ
- CloudKassir вместе с платежом или отдельной кассой
- Для проверки
- Новый сайт в CloudPayments начинает в тестовом режиме
Как подключить CloudPayments
Ключи и уведомления берутся в одном месте — в настройках сайта в CloudPayments. Ключи в примере вымышленные.
-
Сайт в CloudPayments
Подключите CloudPayments и добавьте сайт сада в личном кабинете. Новый сайт работает в тестовом режиме: деньги не списываются.
-
Ключи
Личный кабинет CloudPayments → сайт → «Настройки»: Public ID и API Secret.
-
Настройки → Онлайн-оплата
Выберите CloudPayments и вставьте Public ID и API Secret.
В админке: Банк Public ID API Secret
-
Уведомления
В тех же настройках CloudPayments включите уведомления Pay, Fail и Refund на адрес сайта: метод POST, кодировка UTF-8, формат CloudPayments.
Адрес для уведомлений Pay, Fail и Refund — вставить в кабинете CloudPayments
https://ваш-сайт/pay/notify/cloudpayments -
Проверить подключение
Сайт отправляет тестовый запрос в API CloudPayments, ответ показывает, приняты ли ключи.
В админке: Проверить подключение
-
Чеки
Если к сайту в CloudPayments подключена CloudKassir, выберите в «Чеках 54-ФЗ» «Чек пробивает банк»: чек уйдёт вместе с платежом.
В админке: Кто пробивает чек
Что происходит после «Оплатить»
Номер счёта в CloudPayments — код счёта на сайте, поэтому уведомление сразу попадает к нужному счёту.
Счёт в CloudPayments
По кнопке «Оплатить» сайт создаёт в CloudPayments счёт с кодом счёта сада и ведёт родителя по его ссылке. Своё письмо со счётом CloudPayments не отправляет.
Уведомление
CloudPayments присылает Pay или Fail с подписью HMAC по ключу API Secret. Сайт проверяет подпись и сумму, чужое уведомление отклоняет.
Оплата на сайте
Оплата вносится в «Оплаты», оплаченный период продлевается или появляется абонемент, чек встаёт в очередь, если его пробивает отдельная касса.
Поиск платежа
Если уведомление не пришло, сайт ищет платёж в CloudPayments по номеру счёта: когда родитель вернулся со страницы оплаты и по расписанию.
Чек, возврат и проверка
- Чек 54-ФЗ
- Чек в формате CloudKassir уходит вместе с платежом: название услуги, сумма, НДС, признак расчёта и почта или телефон родителя. CloudKassir можно подключить и отдельной кассой — ключи возьмутся из настроек CloudPayments. CloudKassir
- Возврат
- Возврат делается в личном кабинете CloudPayments. По уведомлению Refund сайт отмечает счёт «Возвращён» и пишет сотрудникам, чтобы они поправили оплату.
- Тестовый режим
- Новый сайт в CloudPayments сначала работает в тестовом режиме, деньги не списываются. На нём можно пройти путь родителя до конца, от счёта до «Оплата прошла».
- Данные карты
- Номер карты и код родитель вводит на странице CloudPayments, сайт сада их не видит.
Частые вопросы
Не нашли ответ — напишите нам.
Какие уведомления включить в CloudPayments?
Pay, Fail и Refund на адрес https://ваш-сайт/pay/notify/cloudpayments, метод POST, кодировка UTF-8. Адрес с кнопкой копирования есть в настройках сайта.
Нужно ли отдельно подключать CloudKassir?
Если чек пробивается вместе с платежом, достаточно, чтобы CloudKassir была подключена к сайту в CloudPayments, и выбрать «Чек пробивает банк». Отдельной кассой CloudKassir выбирается в «Чеках 54-ФЗ», ключи те же.
Что увидит родитель?
Страницу счёта сада с суммой и кнопкой «Оплатить», затем страницу оплаты CloudPayments. После оплаты — «Оплата прошла» на сайте сада и уведомление в кабинете.
Сколько стоит приём оплаты?
Тарифы — у CloudPayments, на её сайте. Система с платежей ничего не берёт.
CloudPayments для детского сада и центра
CloudPayments принимает оплату по счёту: сайт сада создаёт в нём счёт с тем же кодом, что у счёта на сайте, и отправляет родителя по ссылке. Код связывает платёж со счётом, поэтому, получив уведомление, сайт точно знает, что оплачено.
Подпись уведомлений
Каждое уведомление Pay, Fail или Refund CloudPayments подписывает ключом API Secret. Сайт считает подпись от тела запроса сам и сравнивает: уведомление без верной подписи не меняет ни одного счёта. Сумму он сверяет со счётом до копейки, а если она не совпала, пишет сотрудникам и оплату не вносит.
CloudKassir: два способа
Облачная касса CloudPayments называется CloudKassir, и подключить её можно двумя способами. Если чек пробивается вместе с платежом, сайт кладёт позицию чека в запрос к CloudPayments. Если нужна отдельная касса, выберите CloudKassir в «Чеках 54-ФЗ»: сайт отправит чек после оплаты и проследит, чтобы касса его пробила. Ключи в обоих случаях одни и те же, а второй способ работает и тогда, когда деньги принимает другой банк.
Абонементы и помесячная оплата
Родитель платит за месяц кнопкой «Оплатить» в кабинете или по счёту от администратора. У детского центра так же покупается абонемент: после оплаты он сразу появляется у ребёнка с числом занятий и сроком из тарифа, а если на занятия уже ходили в долг, абонемент его погасит.
Оплаты уходят в обмен с 1С:Бухгалтерией 3.0, в комментарии к документу — номер платежа в CloudPayments. Тот же номер есть в реестре оплат для бухгалтера.
Если оплата не прошла
Если банк отказал, CloudPayments присылает Fail, и счёт отмечается «Не прошёл». Родитель видит, что деньги не списаны, и может попробовать ещё раз, например другой картой: ссылка на счёт работает до своего срока.
Другие банки, кассы и переводы
Нет вашего банка или кассы?
Напишите — добавим в ближайшем обновлении. Укажите банк или сервис касс и что у сада уже подключено: эквайринг, касса, ОФД.
Написать намОплатите счёт в демо
В демо включена тестовая оплата. Войдите в кабинет родителя, нажмите «Оплатить» — деньги не спишутся — и найдите оплату в админке, в разделе «Онлайн-оплаты». Настройки банков и касс в демо открыты для просмотра.
