Когда нужен счёт на номер, а когда ссылка
- Счёт на номер — когда вы знаете покупателя: записался на услугу, оформил заказ в директе, продлевает абонемент. Счёт сам появляется у него в Kaspi, ничего пересылать не надо.
- Ссылка или QR — когда покупатель вам ещё не знаком: ссылка в профиле Instagram, QR на кассе. Подробнее — в статье о ссылке на оплату Kaspi.
Три способа выставить счёт без ручной работы
Из Telegram одним сообщением
Подключите бота в кабинете и напишите ему сумму, номер и комментарий в любом порядке: 4990 +77011234567 Маникюр. Бот спросит у Kaspi, чей это номер, и покажет: «Счёт 4 990 ₸ для Сауле К. — выставить?». Опечатка в номере ловится до того, как счёт уйдёт чужому человеку.
Из сайта или CRM по API
Один запрос POST /v2/invoices с номером и суммой — и счёт у клиента в Kaspi. Об оплате ваша система узнаёт вебхуком payment.paid с подписью. Есть песочница: весь путь можно проверить без настоящих денег. Подробно — в справочнике API.
Регулярно, по расписанию
Для абонементов и подписок: укажите номер, сумму и период — неделя, месяц или квартал. Счёт уходит сам в выбранный день; если клиент не оплатил, Aitole повторит и сообщит вам.
Что происходит после отправки
| Статус | Что это значит |
|---|---|
| Ждёт оплаты | Счёт у клиента в Kaspi |
| Оплачен | Деньги на вашем счёте Kaspi Pay, вам пришло уведомление |
| Отклонён | Клиент отказался от счёта в приложении Kaspi |
| Истёк | Клиент не оплатил: счёт Kaspi живёт около суток |
Оплаченный счёт можно вернуть — полностью или частично — из кабинета или по API.
Что важно знать
- Номер должен быть зарегистрирован в Kaspi: иначе счёт не придёт, и бот предупредит об этом заранее.
- Деньги идут напрямую на ваш Kaspi Pay. Aitole подключается через штатную роль «Кассир», которая не умеет выводить деньги.
- Тарифы считают только оплаченные счета: выставленные и неоплаченные лимит не тратят.