Онлайн-оплата через Точку на сайте детского сада
Сайт создаёт в Точке ссылку для оплаты картой или через СБП, а о прошедшей оплате Точка сообщает подписанным уведомлением. Код клиента подскажет проверка подключения, уведомления сайт подключит сам.
- Что вписать в админке
- JWT-ключ и client_id ключа, код клиента подскажет проверка
- Уведомления об оплате
- Сайт подключает их сам по client_id
- Способы оплаты
- Карта и СБП
- Чек 54-ФЗ
- Партнёр Точки по онлайн-кассе или облачная касса
Как подключить Точку
Ключ выпускается в интернет-банке, остальное сайт находит сам. Ключи в примере вымышленные.
-
Интернет-эквайринг
В интернет-банке Точки: «Сервисы» → «Интернет-эквайринг», подайте заявку. Если нужны чеки, там же выберите партнёра по онлайн-кассе.
-
JWT-ключ
«Интеграции и API» → «Создать JWT-ключ». Дайте ключу права MakeAcquiringOperation, ReadAcquiringData, ReadCustomerData и ManageWebhookData. Рядом с ключом показан его client_id.
-
Настройки → Онлайн-оплата
Выберите Точку и вставьте JWT-ключ и client_id.
В админке: Банк JWT-ключ client_id ключа
-
Проверить подключение
Сайт находит код клиента и торговые точки эквайринга: код останется вписать в поле, номер точки — только если их несколько. С client_id сайт сам подключает уведомления об оплате на свой адрес.
В админке: Проверить подключение Код клиента Номер торговой точки
-
Срок ключа
Срок JWT-ключа вы выбираете при выпуске. Перед окончанием выпустите новый, вставьте его вместе с новым client_id и снова нажмите «Проверить подключение».
Что происходит после «Оплатить»
Точка сообщает только об успешной оплате, остальное сайт узнаёт сам.
Платёжная ссылка
Сайт создаёт в Точке ссылку на оплату картой или через СБП с назначением из счёта. Ссылка живёт до срока счёта, но не дольше 31 дня, у каждой попытки свой номер.
Уведомление
Точка присылает уведомление строкой JWT, подписанной ключом банка. Сайт проверяет подпись открытым ключом с сайта Точки и сверяет код клиента.
Оплата на сайте
Оплата вносится в «Оплаты», оплаченный период продлевается, родитель получает «Оплата получена».
Проверка по расписанию
Неоплаченные и истёкшие счета сайт проверяет у Точки сам: по расписанию и когда родитель вернулся со страницы оплаты.
Чек, возврат и ключ банка
- Чек 54-ФЗ
- Точка пробивает чек через партнёра по онлайн-кассе, и для такого чека нужна почта плательщика: без неё сайт не создаст платёж. Проверьте почту в карточках семей или попросите родителя вписать её на странице счёта. Облачные кассы
- Возврат
- Возврат делается в интернет-банке Точки. Уведомлений о возвратах Точка не присылает, поэтому оплату в «Оплатах» сотрудник поправляет сам.
- Тестовый режим
- Отдельного тестового режима для Точки в настройках сайта нет. Ключ проверяет кнопка «Проверить подключение», а путь родителя без денег показывает тестовая оплата сайта.
- Ключ Точки
- Открытый ключ Точки сайт хранит сутки и держит запасной. Уведомления проверяются, даже если страница с ключом на сайте Точки не ответила.
Частые вопросы
Не нашли ответ — напишите нам.
Где взять код клиента?
Искать не нужно: впишите JWT-ключ и нажмите «Проверить подключение». Сайт покажет код клиента, его останется вписать в поле.
Нужно ли настраивать вебхуки в Точке?
Нет, если вписан client_id и у ключа есть право ManageWebhookData: сайт подключит уведомления на свой адрес при проверке подключения.
Что будет, когда истечёт JWT-ключ?
Точка перестанет принимать запросы сайта, а «Проверить подключение» скажет, что ключ не принят. Выпустите новый ключ и вставьте его с новым client_id.
Какие способы оплаты увидит родитель?
Карту и СБП: сайт просит у Точки оба способа, когда создаёт ссылку.
Интернет-эквайринг Точки для детского сада
С Точкой сайт работает через её Open API. Доступ даёт JWT-ключ, который выпускается в интернет-банке в разделе «Интеграции и API», а остальное сайт находит сам. После проверки подключения он показывает код клиента и номера торговых точек эквайринга, а по client_id подключает уведомления о платежах на свой адрес.
Карта и СБП
Для каждого счёта сайт создаёт в Точке платёжную ссылку сразу с двумя способами оплаты — картой и через СБП. Срок ссылки берётся из срока счёта, но не больше 31 дня. У каждой попытки оплаты свой номер ссылки, поэтому после неудачи родитель может заплатить ещё раз.
Подпись уведомлений
Уведомление об оплате Точка присылает строкой JWT, подписанной её ключом RS256. Сайт проверяет подпись открытым ключом с сайта Точки, хранит этот ключ сутки и держит запасной на случай, если сайт Точки не ответит. Уведомление с чужим кодом клиента сайт отклоняет, даже если подпись верна.
Что Точка не сообщает
Уведомления приходят только об успешной оплате. Неоплаченные и истёкшие счета сайт проверяет по расписанию, а возвраты, сделанные в интернет-банке, сотрудник отражает в «Оплатах» сам.
Чеки
Если чеки пробивает партнёр Точки по онлайн-кассе, сайт создаёт платёж сразу с чеком: название услуги, НДС, система налогообложения, признак расчёта и почта плательщика. Без почты такой платёж не создаётся, поэтому её стоит проверить в карточках семей заранее. Другой путь — облачная касса: она пробивает чек после оплаты по любому банку.
Ключ и его срок
JWT-ключ выпускается на срок, который вы выбираете сами. Когда он истечёт, Точка перестанет принимать запросы сайта, и кнопка «Проверить подключение» скажет, что ключ не принят. Выпустите новый, вставьте его вместе с новым client_id и снова нажмите проверку: сайт заново подключит уведомления.
Другие банки, кассы и переводы
Нет вашего банка или кассы?
Напишите — добавим в ближайшем обновлении. Укажите банк или сервис касс и что у сада уже подключено: эквайринг, касса, ОФД.
Написать намОплатите счёт в демо
В демо включена тестовая оплата. Войдите в кабинет родителя, нажмите «Оплатить» — деньги не спишутся — и найдите оплату в админке, в разделе «Онлайн-оплаты». Настройки банков и касс в демо открыты для просмотра.
