# Как принимать оплату Kaspi через Telegram

> Есть два сценария. Если вы продаёте сами — бот Aitole выставляет счёт Kaspi на номер клиента, одноразовую или постоянную ссылку на оплату одним сообщением («4990 +7 701 … маникюр») и присылает «✅ Оплачено» с суммой и именем. Если у вас свой Telegram-бот — он подключается к Aitole по API: выставляет счёт или QR одним запросом и узнаёт об оплате вебхуком. В обоих случаях деньги идут напрямую на ваш Kaspi Pay.

Источник: https://aitole.kz/kaspi-telegram-bot/ · Aitole — https://aitole.kz

## Бот Aitole: оплата из переписки за 10 секунд

Подключите Telegram в кабинете Aitole (раздел «Уведомления») — и пишите боту обычным текстом:

| Сообщение | Что сделает бот |
|---|---|
| `4990 +77011234567 Маникюр` | Покажет имя владельца номера из Kaspi и после подтверждения выставит счёт — он придёт клиенту в Kaspi |
| `5000 кофе` | Пришлёт ссылку Kaspi на оплату — её можно переслать клиенту; QR в Kaspi живёт 5 минут |
| `ссылка 4990 Консультация` | Создаст постоянную ссылку aitole.kz/pay/… для профиля или закрепа |
| `ссылка Донат` | Постоянная ссылка, где сумму вводит клиент |

Сумма, номер и комментарий — в любом порядке, номер с пробелами и скобками тоже понимается.

## Уведомления об оплате

Каждая оплата приходит сообщением: сумма, касса, способ (QR или счёт на номер), имя клиента, если оно известно, и комментарий. Отдельно — красное предупреждение, если Kaspi остановил приём платежей по кассе: обычно это значит, что под номером кассира вошли в приложение Kaspi Pay.

## Свой Telegram-бот с оплатой Kaspi

Если у вас бот для записи, заказов или доступа к закрытому каналу, оплату к нему подключают через API Aitole:

1. Бот получает от клиента номер телефона и вызывает `POST /v2/invoices` — счёт уходит клиенту в Kaspi. Или `POST /v2/qr` — бот присылает ссылку на оплату.
2. Когда клиент оплатил, Aitole шлёт вебхук `payment.paid` с подписью — бот выдаёт доступ, подтверждает запись или отправляет заказ.
3. Всё можно проверить в песочнице без настоящих денег.

Подробно — в [справочнике API](/docs/). Если бот пишет ИИ-ассистент, дайте ему [инструкцию для ИИ](/for-ai/).

## Что важно знать

- Бот выставляет счета только с боевой кассы и только в личном чате с вами — в группах он не принимает команды на оплату.
- Перед счётом на номер бот спрашивает подтверждение: опечатка в номере не уйдёт чужому человеку.
- Кассовый чек выдаёт ваша онлайн-касса или Kaspi Касса — бот его не пробивает.

## Вопросы

### Можно ли принимать оплату Kaspi прямо в Telegram без сайта?

Да. Бот Aitole выставляет счёт или ссылку из переписки, клиент оплачивает в приложении Kaspi, вам приходит уведомление. Сайт не нужен.

### Как подключить оплату Kaspi к своему Telegram-боту?

Через REST API Aitole: бот выставляет счёт или QR одним запросом и получает вебхук об оплате. Есть песочница и готовый промпт для ИИ-ассистента.

### Будут ли приходить уведомления, если счёт выставлен не через бота?

Да. Уведомления приходят обо всех оплатах кассы — из кабинета, по ссылке, по API и регулярных счетов.

### Почему бот не выставляет счета в группе?

Команды на выставление счетов бот принимает только в личном чате с тем, кто подключил его в кабинете. Так счёт не выставит случайный участник группы.

### Сколько стоит?

Бот бесплатный. Платите только за оплаченные платежи сверх 20 в месяц: тариф Start — 7 000 ₸ в месяц за 500 оплат.
