Как автошколе или онлайн-школе принимать оплату Kaspi за обучение?

Как это работает у вас

В терминах школы:

Вы (или ваша система) выставляете ученику счёт за месяц → ученику приходит push в приложении Kaspi → он нажал «Оплатить» → вам приходит уведомление (вебхук или статус в кабинете) → отмечаете оплату, ученик ходит на занятия.

Для ежемесячных оплат заводите подписку: система сама создаёт счёт в день биллинга — вам остаётся смотреть, кто оплатил. Если ученик не оплатил — срабатывают повторные попытки выставления и grace-период, после которого подписка останавливается (подробности ниже).

Для разовых оплат («оплата за экзамен», доплата за вождение) — обычный счёт по номеру: ученику приходит push в приложении Kaspi, счёт живёт 24 часа. Отдельной ссылки на оплату у такого счёта нет — в ответе POST /api/v1/invoices её не бывает.

Если оплату нужно отправить в WhatsApp, сделайте печатный QR под сделку: POST /api/v1/static-qr вернёт ссылку qr.apipay.kz/{token}, счёт создаётся в момент перехода по ней (как это устроено). Ссылка листа — это доступ к оплате именно этой сделки: отправляйте её конкретному ученику или родителю, а не в общий чат.

Компоненты ApiPay для школы

Школе доступны и кабинет без кода, и полный Kaspi API:

Пошаговый сетап

1. Зарегистрируйтесь на apipay.kz — вход по WhatsApp-OTP на ваш личный номер (как войти; личный номер ≠ номер кассира).
2. Попробуйте всё в песочнице: выставьте тестовый счёт из кабинета, посмотрите статусы. Это бесплатно и без ограничений по времени.
3. Подключите номер кассира — отдельная SIM (требования). Подключение кассира даёт организации 3-дневный триал, дальше нужен оплаченный тариф (пробный период).
4. Заполните анкету «Расскажите о бизнесе» до массового запуска: пока она не одобрена, организация ограничена одним реальным платежом в сутки — счета из кабинета тоже считаются (зачем).
5. Выставьте первые реальные счета из кабинета ученикам этого месяца — убедитесь, что push приходят и оплаты видны.
6. Заведите подписки на постоянных учеников: сумма, период monthly, billing_day (1–28), при необходимости — «выставить первый счёт сразу».
7. Настройте правила неплатежей: количество повторных выставлений и grace-период — сколько дней ученик может заниматься «в долг», прежде чем подписка остановится.
8. Есть сайт или CRM? Подключите вебхуки (инструкция) — оплаты будут отмечаться сами; интеграцию соберёт ваш ИИ по apipay.kz/for-ai.

Грабли именно образования

• Автосписания нет. Подписка автоматически выставляет счёт, но деньги не снимаются: ученик получает push в Kaspi и подтверждает оплату сам. Карточные данные не нужны и не собираются.
• Реактивации после expired нет. Если ученик не оплатил и grace истёк — подписка останавливается навсегда; вернулся через месяц — создавайте новую подписку, старую «включить обратно» нельзя.
• Ошибка счёта подписки: смотрите error_code в вебхуке subscription.payment_failed. Сбой на нашей стороне или на стороне Kaspi попытку не сжигает и период не теряет — ближайший прогон повторит выставление сам, ученика дёргать не нужно. Вина плательщика (client_not_found — номера ученика нет в Kaspi) идёт обычным путём: повторные выставления, затем grace-период.
• Лимит тарифа считается «в день». Тариф ограничивает число счетов в день, созданных через API; счета, выставленные вручную из кабинета, в лимит не входят. Если у вас все платят 1-го числа каждый месяц, обсудите объём с поддержкой заранее — для неравномерных продаж организацию переводят на помесячный подсчёт. Подробно — Лимит счетов по тарифу.
• Международные ученики — не сюда. Оплатить может только пользователь Kaspi (Казахстан); онлайн-школе с зарубежными учениками нужен отдельный карточный эквайринг.

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