Как это работает у вас
В терминах школы:
Вы (или ваша система) выставляете ученику счёт за месяц → ученику приходит push в приложении Kaspi → он нажал «Оплатить» → вам приходит уведомление (вебхук или статус в кабинете) → отмечаете оплату, ученик ходит на занятия.
Для ежемесячных оплат заводите подписку: система сама создаёт счёт в день биллинга — вам остаётся смотреть, кто оплатил. Если ученик не оплатил — срабатывают повторные попытки выставления и grace-период, после которого подписка останавливается (подробности ниже).
Для разовых оплат («оплата за экзамен», доплата за вождение) — обычный счёт по номеру: он живёт 24 часа, и из него можно взять ссылку на оплату и отправить ученику в WhatsApp — ссылка работает те же 24 часа.
Компоненты ApiPay для школы
Школе доступны и кабинет без кода, и полный Kaspi API:
| Компонент | Зачем школе |
|---|---|
| Кабинет apipay.kz | Счета и возвраты вручную, без программиста; весь функционал доступен сразу в песочнице |
| Счёт по номеру | Разовые оплаты: push ученику, живёт 24 часа |
| Ссылка на оплату из счёта | Отправка в WhatsApp ученикам/родителям — работает 24 часа |
| Подписки (авто-выставление) | Ежемесячные оплаты: период monthly, день биллинга 1–28, сумма 100–1 000 000 ₸; обзор — рекуррентные платежи Kaspi |
| Ретраи + grace-период | Не оплатил — повторные выставления (по умолчанию 3 попытки), затем grace (по умолчанию 3 дня, до 30) |
| Вебхуки | Для тех, у кого есть сайт/CRM: автоматическая отметка оплат |
| Роли «менеджер»/«разработчик» | Администратор школы работает со счетами, не имея доступа владельца |
Пошаговый сетап
- Зарегистрируйтесь на apipay.kz — вход по WhatsApp-OTP на ваш личный номер (как войти; личный номер ≠ номер кассира).
- Попробуйте всё в песочнице: выставьте тестовый счёт из кабинета, посмотрите статусы. Это бесплатно и без ограничений по времени.
- Подключите номер кассира — отдельная SIM (требования). После подключения включите рабочий режим — будет 3 дня на живые тесты.
- Выставьте первые реальные счета из кабинета ученикам этого месяца — убедитесь, что push приходят и оплаты видны.
- Заведите подписки на постоянных учеников: сумма, период
monthly,billing_day(1–28), при необходимости — «выставить первый счёт сразу». - Настройте правила неплатежей: количество повторных выставлений и grace-период — сколько дней ученик может заниматься «в долг», прежде чем подписка остановится.
- Есть сайт или CRM? Подключите вебхуки (инструкция) — оплаты будут отмечаться сами; интеграцию соберёт ваш ИИ по apipay.kz/for-ai.
Грабли именно образования
- Ожидание автосписания. Самая частая путаница: слово «подписка» звучит как автосписание с карты. В Kaspi так не работает, и это сознательная модель: счёт выставляется автоматически, но списания нет — ученик получает push и сам нажимает «Оплатить». Плюс для вас: не нужны карточные данные, а претензии о списании без спроса попросту невозможны.
- Реактивации после expired нет. Если ученик не оплатил и grace истёк — подписка останавливается навсегда; вернулся через месяц — создавайте новую подписку, старую «включить обратно» нельзя.
- Пропущенный период при ошибке счёта. Если счёт подписки ушёл в ошибку (например, номер ученика не найден в Kaspi), это не считается «неоплатой» — повторного выставления не будет, период пропускается. Сверяйте список оплат в конце дня биллинга.
- Лимит тарифа считается «в день». Тарифы ограничивают число счетов в день. Если у вас пик — например, все платят 1-го числа — заранее обсудите объём с поддержкой.
- Международные ученики — не сюда. Оплатить может только пользователь Kaspi (Казахстан). международные оплаты через Kaspi невозможны — онлайн-школе с зарубежными учениками нужен отдельный карточный эквайринг для международки.
- Голосовые и «позвоните». Поддержка ApiPay работает в WhatsApp текстом; на номере поддержки звонков нет. Пишите текстом — так быстрее.
Пример: онлайн-школа с помесячной оплатой
Типичная ситуация выглядит так. У школы есть платная платформа для учеников с оплатой каждый месяц, и поначалу хочется, чтобы деньги списывались автоматически. Но автосписания в этой модели нет — и в этом её суть: подписка сама выставляет счёт, ученику приходит push в Kaspi, он нажимает «Оплатить». Сервис лишь автоматизирует действия на стороне Kaspi.
Если ученик не оплатил, система делает повторные выставления, затем наступает grace-период (по умолчанию 3 дня). Если оплаты так и нет — подписка останавливается, а школа получает уведомление.
На практике такой сценарий часто оказывается даже удобнее: родители сами подтверждают каждую оплату, и вопросов о списании без спроса не возникает.
Частые вопросы
Нужен ли программист, чтобы начать?
Нет. Кабинет apipay.kz покрывает счета, подписки и возвраты вручную. Программист (или ваш ИИ-помощник) понадобится, только если хотите связать оплаты со своим сайтом/CRM.
Подписка снимает деньги с карты ученика?
Нет. Подписка автоматически выставляет счёт в Kaspi; ученик подтверждает оплату сам в приложении. Автосписания нет — это принципиальная модель.
Что происходит, когда ученик перестал платить?
Повторные выставления счёта (по умолчанию 3 попытки), затем grace-период (по умолчанию 3 дня, настраивается до 30). После — подписка останавливается навсегда; для вернувшегося ученика создаётся новая.
Можно отправить ссылку на оплату родителю в WhatsApp?
Да: выставьте счёт по номеру и возьмите из него ссылку — она живёт 24 часа, как и сам счёт.
Сколько стоит для школы на 100–300 учеников?
Тариф фиксированный, по числу создаваемых счетов в день, не процент с оборота; актуальные тарифы — на apipay.kz. При «пиковых» днях биллинга (например, все платят 1-го числа) напишите в поддержку — помогут с настройкой.