SaaS-рынок Казахстана активно развивается: CRM-системы, сервисы автоматизации, образовательные платформы, инструменты для бизнеса. Большинство из них работают по подписочной модели — ежемесячный или годовой платёж за доступ к сервису. И в казахстанских реалиях основной способ оплаты — Kaspi.
Но Kaspi не поддерживает автоматические рекуррентные платежи так, как это делает Stripe или PayPal. Каждый месяц клиент должен вручную совершить перевод и подтвердить оплату. Для SaaS-сервиса это означает: проверка каждого чека, управление сроками подписки, обработка просрочек и продление доступа. В этой статье разберём, как автоматизировать этот процесс.
Проблемы подписочной модели с оплатой через Kaspi
Отсутствие автосписания
В отличие от международных платёжных систем, Kaspi не позволяет настроить автоматическое списание подписки. Каждый месяц клиент должен:
- Вспомнить о необходимости оплаты
- Совершить перевод на нужную сумму
- Отправить подтверждение (чек) сервису
Для SaaS-сервиса с 200 клиентами это 200 ежемесячных проверок, каждая из которых требует верификации суммы, получателя и отсутствия дубликатов.
Задержки продления
Клиент оплатил в пятницу вечером, отправил чек в чат. Менеджер увидел в понедельник утром. Два дня клиент без доступа, хотя уже оплатил. Или наоборот: клиент не оплатил, но продолжает пользоваться сервисом, потому что менеджер не проверил статус подписки.
Мошенничество с подписками
Подписочная модель создаёт специфические риски:
- Повторное использование чека. Клиент отправляет чек за прошлый месяц как подтверждение текущей оплаты.
- Передача чека между аккаунтами. Один пользователь оплачивает, а чек используется для продления другого аккаунта.
- Фейковый чек для пробного периода. Пользователь регистрируется повторно и отправляет поддельный чек для активации полного доступа.
Важно: В SaaS-модели каждый неоплаченный месяц — это прямые потери. Если 5% из 200 клиентов используют поддельные или старые чеки, вы теряете доход от 10 подписок ежемесячно. При средней стоимости подписки 15 000 тенге это 150 000 тенге потерь каждый месяц.
Архитектура решения: API-интеграция
Для SaaS-сервиса оптимальный подход — интеграция ProverkaCheka через API. Это позволяет полностью автоматизировать проверку оплат и управление подписками без ручного вмешательства.
Общая схема работы
- Клиент заходит в личный кабинет. Видит статус подписки, дату окончания и кнопку «Оплатить».
- Совершает перевод через Kaspi. Сумма и реквизиты указаны на странице оплаты.
- Загружает PDF-чек. Через форму в личном кабинете или отправляет боту в Telegram.
- Система проверяет чек через API. Подлинность, сумма, получатель (ИИН/БИН), дубликаты.
- При успехе — подписка продлевается. Доступ автоматически расширяется на оплаченный период.
- При ошибке — уведомление клиенту. С указанием причины: неверная сумма, дубликат, чек не найден.
Пример запроса к API
Отправьте PDF-файл на endpoint /upload с вашим API-ключом и параметром ИИН/БИН:
POST https://api.proverkacheka.kz/upload
Content-Type: multipart/form-data
file: receipt.pdf
api_key: your_api_key
iin: 123456789012API вернёт JSON с результатом проверки: статус, номер чека, сумма, имя продавца и информация о дубликатах.
Обработка ответа
На основе ответа API ваша система принимает решение:
| Результат проверки | Действие | Уведомление клиенту |
|---|---|---|
| Чек валиден, сумма совпадает | Продлить подписку | «Подписка продлена до [дата]» |
| Сумма не совпадает | Запросить корректный чек | «Сумма в чеке не соответствует стоимости подписки» |
| Дубликат | Отклонить | «Этот чек уже использован для оплаты» |
| Чек не найден | Отклонить | «Чек не прошёл проверку. Убедитесь, что отправили PDF из Kaspi» |
| ИИН/БИН не совпадает | Отклонить | «Платёж адресован другому получателю» |
Управление подписочным циклом
Напоминания об оплате
Настройте автоматические напоминания на стороне вашего сервиса:
- За 3 дня до окончания подписки. «Ваша подписка истекает через 3 дня. Оплатите [сумма] тенге и отправьте чек.»
- В день окончания. «Подписка заканчивается сегодня. Не забудьте оплатить для продолжения доступа.»
- На следующий день. «Подписка истекла. Оплатите в течение 3 дней, чтобы восстановить доступ без потери данных.»
Grace-период (льготный период)
Не блокируйте доступ мгновенно после истечения подписки. Рекомендуемая практика:
- Дни 1-3 после истечения. Полный доступ сохраняется, но пользователь видит баннер с напоминанием об оплате.
- Дни 4-7. Ограниченный доступ — только просмотр данных, без возможности создавать новые записи.
- После 7 дней. Полная блокировка. Данные сохранены, но доступ закрыт до оплаты.
Такой подход снижает отток клиентов: не все задерживают оплату намеренно. Часто клиент просто забыл, уехал в отпуск или у него временные проблемы с балансом.
Функция баланса позволяет накапливать платежи к целевой сумме. Если клиент оплатил частично (например, 10 000 из 15 000 тенге), система запомнит поступившую сумму. Когда клиент доплатит оставшиеся 5 000, общий баланс достигнет целевой суммы и подписка активируется автоматически.
Сценарии для разных типов SaaS
CRM-система
Казахстанская CRM для малого бизнеса: 50 клиентов, подписка 9 900 тенге/мес. Менеджер вручную проверял чеки и продлевал подписки. С API ProverkaCheka процесс автоматизирован: клиент загружает чек в личном кабинете, через 10 секунд подписка продлена. Менеджер видит дашборд со статусом всех подписок.
Бухгалтерский сервис
Онлайн-бухгалтерия с тарифами: базовый (5 000 тг/мес), стандарт (12 000 тг/мес), премиум (25 000 тг/мес). API ProverkaCheka проверяет не только подлинность чека, но и соответствие суммы тарифу клиента. Если клиент на «стандарте» отправляет чек на 5 000 тенге — система обнаруживает несовпадение.
Образовательная платформа
Подписка на библиотеку курсов: 4 990 тенге/мес или 49 900 тенге/год. Платформа принимает оба варианта. API различает годовую и месячную оплату по сумме и продлевает подписку на соответствующий период.
Технические рекомендации для разработчиков
Обработка ошибок
API ProverkaCheka может вернуть retry_after: 5 в ответе, если Kaspi API временно недоступен. В этом случае:
- Не блокируйте пользователя — покажите сообщение «Проверка займёт чуть больше времени»
- Поставьте задачу в очередь и повторите запрос через указанный интервал
- Уведомите пользователя о результате, когда проверка завершится
Безопасность API-ключа
API-ключ ProverkaCheka — это конфиденциальные данные. Храните его в переменных окружения, не вкладывайте в клиентский код. Все запросы к API должны идти через ваш серверный бэкенд.
Идемпотентность
Каждый чек имеет уникальный номер транзакции. Если один и тот же чек отправить на проверку дважды, вторая проверка покажет его как дубликат. Это гарантирует, что одна оплата не будет зачислена дважды.
Webhook-уведомления
Для полной автоматизации настройте webhook на вашей стороне. Когда клиент отправляет чек через Telegram-бота ProverkaCheka, вы можете получить уведомление и автоматически обновить статус подписки в вашей системе.
ROI автоматизации для SaaS
| Метрика | Ручная проверка | С ProverkaCheka API |
|---|---|---|
| Время на проверку 1 чека | 3-5 мин | Автоматически |
| Время продления подписки | 1-48 часов | 10-15 секунд |
| Обнаружение дубликатов | Нет | Да |
| Потери от мошенничества | 5-10% клиентов | 0% |
| Нагрузка на менеджера | 15-20 часов/мес | 0 часов |
| Удовлетворённость клиентов | Жалобы на задержки | Мгновенный доступ |
Пошаговая интеграция
- Зарегистрируйте аккаунт. Откройте @ProverkaChekakzbot и получите API-ключ.
- Добавьте endpoint в ваш бэкенд. Создайте маршрут, который принимает PDF-файл от клиента и отправляет его на API ProverkaCheka.
- Обработайте ответ. На основе результата проверки обновите статус подписки клиента.
- Добавьте UI в личный кабинет. Кнопка загрузки чека, отображение статуса проверки, история платежей.
- Настройте уведомления. Напоминания об оплате, подтверждение продления, предупреждение об истечении.
- Протестируйте. Используйте демо-режим для проверки интеграции без расхода кредитов.
Важно: Начните с простой интеграции — загрузка чека через форму в личном кабинете и автоматическое продление. Усложнять (grace-периоды, частичные платежи, автоуведомления) можно поэтапно, когда базовый процесс заработает стабильно.
Заключение
Для SaaS-сервиса в Казахстане проверка платежей Kaspi — это не опция, а необходимость. Без автоматизации вы тратите время менеджеров, теряете деньги на мошенничестве и раздражаете клиентов задержками с продлением. API ProverkaCheka решает все три проблемы: мгновенная проверка, защита от дубликатов, автоматическое обновление статуса подписки.
Интеграция занимает несколько часов разработки и окупается с первого месяца использования. Начните с бесплатного теста — отправьте один чек боту и убедитесь в скорости и точности проверки.