Оплата вебинара и онлайн-курса через Kaspi
Разовая оплата вебинара, курс помесячно и частями, доступ к урокам по вебхуку, SMS и WhatsApp участникам и возвраты через KazPayment.
Короткий ответ. Принимать оплату за вебинар или онлайн-курс через Kaspi можно тремя способами, и их удобно сочетать. Разовое участие оплачивается заказом: ваш сайт заводит его через API и получает ссылку на оплату, а если сайта нет, хватит постоянной ссылки и QR товара. Курс с ежемесячной оплатой оформляется подпиской: счёт в Kaspi приходит сам каждый месяц, напоминания уходят только тем, кто не заплатил. Рассрочку на курс собирают из подписки с датой окончания. Об оплате ваш сайт узнаёт из вебхука и сам открывает доступ к урокам.
Что даёт KazPayment, а что делает ваш сайт
KazPayment отвечает за деньги: заводит счёт в Kaspi, отмечает оплату, напоминает должникам, возвращает деньги через кассу. Личного кабинета ученика, плеера уроков и рассылки по расписанию события в KazPayment нет. Это делает ваш сайт или платформа курсов, а с KazPayment они общаются через API.
| Задача | Чем закрывается |
|---|---|
| Оплата за один вебинар | заказ через API или ссылка и QR товара |
| Курс помесячно | тариф и подписка, счёт приходит сам |
| Курс в рассрочку | подписка с датой окончания |
| Узнать, кто оплатил | вебхук payment.received или запрос статуса |
| Открыть урок | ваш сайт по вебхуку |
| Ссылка на эфир, напоминания | SMS и WhatsApp через API |
| Вернуть деньги | кабинет или POST /api/v1/orders/{номер}/refund |
Пошаговый разбор продажи вебинаров с регистрацией есть в инструкции «Свой сценарий». Ниже про то, какой способ оплаты выбрать и как их совместить.
Разовая оплата: вебинар, интенсив, мероприятие
Если у вас свой сайт с регистрацией, заводите заказ через
POST /api/v1/orders. Номер заказа external_ref придумывает ваш сайт,
например номер регистрации. В ответ приходит payUrl: на телефоне страница
открывает Kaspi с суммой одной кнопкой, на компьютере показывает QR. Платить
можно и приложением другого банка.
Передайте customer_phone, и участник появится у вас в «Клиентах», а в
приложение Kaspi ему придёт счёт. Тогда ссылку на оплату можно отправить ему в
WhatsApp одним запросом POST /api/v1/orders/{номер}/notify. По одному заказу
это сообщение уходит один раз, повторно счёт не дублируется.
Повтор запроса с тем же номером второй заказ не создаёт, а возвращает прежний. Если связь оборвалась на регистрации, участник не получит два счёта.
Как подключить сайт по шагам, описано в инструкции «Подключить интернет-магазин или телеграм-бот», а без программиста, кнопкой на Тильде или Taplink, — в статье «Оплата Kaspi на сайте».
Если сайта нет, заведите вебинар товаром в разделе «Товары» с ценой. У товара появится постоянная ссылка и QR, их можно поставить в описание профиля, пост или рассылку. Каждое нажатие «Оплатить» становится отдельным заказом, а в столбце «Оплачено» видно, сколько человек заплатили. Подробнее в статье «QR-код Kaspi на товар».
Учтите разницу. Заказ, который завёл ваш сайт, связан с конкретной регистрацией. Оплату по ссылке товара покупатель запускает сам, вашему сайту она неизвестна, и в вебхуке нет ни имени, ни телефона. Поэтому если доступ к записи или эфиру нужно выдавать автоматически, заводите заказ через API.
Курс с ежемесячной оплатой
Курс, который длится месяцами, удобнее вести подпиской, а не новым заказом
каждый месяц. В кабинете в «Клиенты и подписки» → «Тарифы» заведите тариф
с режимом «Подписка» и периодом «месяц». Ваш сайт при записи ученика заводит
клиента (POST /api/v1/payers) и подписку (POST /api/v1/subscriptions).
Сами тарифы через API не создаются: цену задаёт владелец в кабинете.
Дальше KazPayment сам выставляет счёт в Kaspi каждый месяц в выбранный день, отмечает оплату и шлёт напоминания по вашим сценариям: по умолчанию за 3 дня до срока, в день срока и через 3 дня после. Заплатившему ничего не приходит. Подробнее о напоминаниях в статье «Напоминания об оплате клиентам».
Удобный выбор периода:
- по календарю: счёт каждый месяц в один день, например 1-го. Пришедшему посреди месяца можно выставить полную сумму или за оставшиеся дни;
- от дня оплаты: каждые 30 дней с момента оплаты. Ученик заплатил с опозданием, и отсчёт пошёл от дня оплаты, оплаченные дни не теряются.
В вебхуке об оплате подписки есть paid_until, последний оплаченный день. По
нему ваш сайт держит доступ к урокам и не считает периоды сам. Когда подписку
отменяют, приходит subscription.cancelled с тем же paid_until: доступ
закрывайте после этой даты. Так же устроен платный Telegram-канал, разобранный
в статье «Платный Telegram-канал через Kaspi».
Что делать с учеником, который перестал платить, вы решаете один раз правилом в «Тарифах»: копить долг, добавлять его в следующий счёт, не считать пропуск долгом или отменять подписку через заданное число дней.
Курс в рассрочку
Отдельной функции «рассрочка» в KazPayment нет, и рассрочку Kaspi сервис не оформляет. Но разбить цену курса на несколько равных платежей можно подпиской с датой окончания.
Пример: курс стоит 90 000 ₸, платить можно тремя частями по 30 000 ₸.
- Заведите тариф «Курс, оплата частями» на 30 000 ₸ в месяц.
- При записи оформите подписку с
starts_onв день старта иends_onтак, чтобы в срок попали ровно три счёта. - Счета придут сами, напоминания тоже. После даты окончания новых счетов нет.
Если у кого-то своя договорённость, у подписки есть своя цена (amount в
запросе или поле в кабинете), тариф при этом остаётся общим.
Выберите правило для первого счёта: полная сумма в день записи или за оставшиеся дни месяца. При неполном первом месяце первая часть выйдет меньше. Проверьте расписание на одной подписке в песочнице, прежде чем продавать.
Второй путь для тех, у кого своя логика: ваш сайт сам заводит несколько
заказов с разными номерами, например KURS-104-1, KURS-104-2,
KURS-104-3, и отправляет каждый в свой срок. Расписание тогда целиком на
вашем сайте, напоминаний по графику KazPayment не будет.
Регистрация, вебхук и доступ к уроку
Обычная цепочка выглядит так:
- Участник заполняет форму на вашем сайте. Номер телефона можно подтвердить
кодом из SMS через
POST /api/v1/otp/request, проверка кода бесплатна. - Сайт заводит заказ или подписку и показывает ссылку на оплату.
- Участник платит в Kaspi.
- KazPayment присылает на ваш адрес вебхук
payment.received. У заказа в нём вашorder_ref, у подпискиsubscription_id,payer_idиpaid_until. - Сайт проверяет подпись, отвечает 2xx и открывает урок.
Пока участник на странице оплаты, она спрашивает кассу каждые несколько
секунд, и статус обычно меняется за секунды. Если он закрыл страницу раньше,
оплату подхватит сверка с выпиской кассы, она идёт раз в час. На всякий
случай сайт может спросить статус заказа сам, GET /api/v1/orders/{номер},
но не чаще раза в минуту.
Одно и то же событие может прийти дважды, поэтому открывайте доступ один раз
по event_id. И смотрите на поле event: возврат и отмена тоже несут номер
заказа, и приёмник, который их не различает, откроет урок по сообщению о
возврате.
Рассылка участникам
Время отправки выбирает ваш сайт: расписания «за 2 часа до эфира» в KazPayment нет.
SMS уходит с любым текстом до 160 знаков: POST /api/v1/sms. Цена 30 ₸ за
каждую часть. Кириллицей одна часть вмещает 70 знаков, поэтому короткое
«Эфир в 19:00» со ссылкой на Zoom обычно укладывается в одну-две части.
Номер только казахстанский мобильный.
WhatsApp стоит 18 ₸ за служебное сообщение, но свой текст туда не
отправить: Meta принимает только одобренные шаблоны. Для движения заказа
(«ждёт оплаты», «оплата получена») шаблон уже есть,
POST /api/v1/whatsapp/order. Для ссылки на эфир нужен отдельный шаблон:
пришлите текст, одобрение у Meta занимает около суток.
Реклама следующего курса стоит дороже служебного сообщения, и вид
сообщения указываете вы: kind: "marketing" у SMS или отдельный адрес у
WhatsApp. Согласие на рекламу проверяет ваш сайт.
Деньги за сообщения списываются с баланса бизнеса до отправки. Если канал
отказал, они возвращаются. Текущие цены отдаёт GET /api/v1/balance.
Возвраты
Вебинар перенесли, участник передумал: деньги возвращаются через ту же кассу Kaspi, на карту, с которой пришли.
- Из кабинета: «Начисления» → «Возврат», сумма и причина. Так возвращаются и оплаты по подписке.
- Через API:
POST /api/v1/orders/{номер}/refundсrefund_ref, вашим номером возврата. Это только для заказов, которые создал ваш сайт. Повтор с тем жеrefund_refденьги второй раз не трогает.
Частично вернуть можно, но по одному счёту только один раз: после первого
возврата второй уже не пройдёт. Возвращайте нужную сумму одним запросом.
После возврата по заказу придёт вебхук order.refunded, по нему сайт
закрывает доступ. Если касса откажет, учёт не изменится. Подробнее в
инструкции «Вернуть деньги клиенту».
С чего начать
- Зарегистрируйтесь и подключите кассу Kaspi.
- Заведите тарифы курсов по инструкции «Первые начисления».
- Выпустите ключ интеграции и задайте адрес вебхука.
- Проверьте весь путь в песочнице: там нет настоящих денег, а оплату вы нажимаете сами.
Частые вопросы
Можно ли принимать оплату за вебинар без своего сайта?
Да. Заведите вебинар товаром с ценой, и у него появится постоянная ссылка и QR. Их можно поставить в соцсети или отправить в чат, каждый заплативший виден в столбце «Оплачено». Автоматически выдать доступ так не получится: вашей системе оплата по ссылке товара не известна, и кому отправить ссылку на эфир, решаете вы сами.
Как сделать оплату курса частями?
Заведите тариф с суммой одной части и периодом «месяц», а ученику оформите подписку с датой окончания. Счета придут сами столько раз, сколько попадёт в срок, с напоминаниями. Отдельной кнопки «рассрочка» нет, и кредитную рассрочку Kaspi сервис не оформляет.
Как сайт узнает, что ученик оплатил?
Из вебхука payment.received, который KazPayment отправляет на ваш адрес. У заказа в нём ваш номер, у подписки идентификаторы подписки и клиента и дата paid_until. Если приёмник был недоступен, статус заказа всегда можно спросить запросом GET /api/v1/orders/{номер}.
Можно ли отправить участникам ссылку на Zoom в WhatsApp?
Только отдельным шаблоном, который одобрит Meta: свободный текст WhatsApp не пропускает. Пришлите текст, одобрение занимает около суток. Без шаблона ссылку можно отправить по SMS запросом POST /api/v1/sms, это 30 ₸ за каждую часть.
Работает ли API на бесплатном тарифе?
Да, API и вебхуки работают на любом тарифе, включая Free. На Free через API можно завести до 500 заказов и до 500 подписок за 30 дней, а оплат на тарифе до 100 за 30 дней. В песочнице предела нет.
Как вернуть деньги за курс, который ученик оплачивал помесячно?
Из кабинета: найдите оплату в «Начислениях» и нажмите «Возврат». Через API возвращаются только заказы, которые завёл ваш сайт, у помесячных счетов подписки номера заказа нет. Затем отмените подписку, чтобы новые счета не приходили.
Попробуйте KazPayment бесплатно
Тестовый режим без ограничения по времени: заведите тарифы, товары и счета и посмотрите, как это работает, до того как подключать настоящую кассу.
Начать бесплатно