Руководства → Свой сценарий через API: вебинары, запись, своё расписание
Свой сценарий: что даёт KazPayment и что настраивает ваш сайт
Кабинет KazPayment покрывает обычный путь: клиент, счёт, оплата через Kaspi, напоминания. Если у вас свой порядок шагов — регистрация на сайте, оплата участия, сообщения по своему расписанию, — его не нужно ждать от нас кнопкой в кабинете. Основа есть, а сценарий вы собираете на своём сайте через API: каждый шаг — это один запрос.
Короткое вступление о подключении — на странице «Разработчикам».
Пример: продажа вебинаров
Задача: человек регистрируется на сайте, получает в WhatsApp ссылку на оплату, не оплатившим приходят напоминания, оплатившему — подтверждение, а в день вебинара за 2 часа — ссылка на Zoom.
| Шаг | Кто делает | Чем |
|---|---|---|
| Регистрация: имя, телефон, выбор тарифа | ваш сайт | своя форма; клиента и заказ передаёте нам запросом |
| Ссылка на оплату Kaspi в WhatsApp | KazPayment | POST /api/v1/orders/{номер}/notify |
| Узнать, что оплатили | KazPayment сообщает вашему сайту | вебхук об оплате или запрос статуса заказа |
| Напоминания не оплатившим | кабинет или ваш сайт | раздел «Напоминания» — или ваш сайт по своему расписанию шлёт POST /api/v1/whatsapp/order с текстом «ждёт оплаты» |
| «Оплата получена» клиенту | ваш сайт по вебхуку | POST /api/v1/whatsapp/order с текстом «оплата получена»; напоминания оплатившему не уходят сами |
| Ссылка на Zoom за 2 часа | ваш сайт в нужное время | SMS любым текстом — POST /api/v1/sms; в WhatsApp — только своим шаблоном, см. ниже |
| Регистрации, оплаты, история сообщений | KazPayment | кабинет: «Клиенты», оплаты, журнал сообщений |
Что важно знать заранее
- Время отправки выбирает ваш сайт. Расписания «за N часов до события» в KazPayment нет: в нужный момент ваш сайт сам вызывает API.
- Свободный текст в WhatsApp Meta не пропускает — только заранее одобренные шаблоны. Для движения заказа («ждёт оплаты», «оплата получена») шаблон уже есть. Для своего текста, например ссылки на Zoom, заведём вам отдельный шаблон: напишите нам текст, одобрение у Meta занимает около суток.
- Напоминания из кабинета сами выбирают канал: Telegram, если клиент его подключил, иначе WhatsApp, иначе SMS, последней — почта. Нужен строго один канал — отправляйте напоминания со своего сайта.
- Сообщения платные и списываются с баланса до отправки; если канал
отказал, деньги возвращаются. Цены —
GET /api/v1/balance. - API и вебхуки работают на любом тарифе, включая Free. Отлаживать удобнее в песочнице — там нет настоящих денег, см. Песочница и первые шаги.
С чего начать
- Зарегистрируйтесь на kazpayment.kz и подключите кассу — Подключить кассу Kaspi.
- Возьмите ключ интеграции и задайте адрес вебхука — Подключить интернет-магазин или телеграм-бот.
- Соберите шаги вашего сценария по таблице выше, сверяясь с документацией API.
Если какого-то шага в API нет совсем — напишите нам в чат на сайте или на support@kazpayment.kz: посмотрим, что можно сделать.
Не помогло? Напишите на support@kazpayment.kz — отвечает разработчик сервиса.