# Aitole

> Приём Kaspi Pay по REST API поверх собственного аккаунта мерчанта. Казахстан.
> Фиксированная подписка вместо процента с оборота. Бесплатный тариф работает
> на настоящих деньгах, а не только в песочнице.

Aitole — независимый сервис. Не банк, не платёжная организация и не партнёр
АО «Kaspi Bank». Деньги покупателей идут напрямую на Kaspi-счёт мерчанта:
платформа передаёт команду выставить счёт и видит результат, но средств не
касается. Подключение делается через штатную роль «Кассир» в Kaspi Pay: мерчант
сам подтверждает доступ кодом из SMS на свой номер.

Для кого: интернет-магазины, Telegram-боты, CRM, SaaS-биллинг, AI-агенты —
всё, где счёт выставляет код, а не человек руками в приложении.

## Документация

- [Справочник API](https://aitole.kz/docs/index.md): аутентификация, QR и счета,
  идемпотентность, возвраты, вебхуки, коды ошибок. Markdown-версия страницы `/docs/`.
- [Справочник в HTML](https://aitole.kz/docs/): то же самое для человека.
- [Плейбук для ИИ-агента](https://aitole.kz/for-ai/): как интегрировать Aitole
  в чужой проект, чего не делать, готовый промпт.
- [Обзор продукта](https://aitole.kz/index.md): markdown-версия лендинга.

## Как это работает, в четырёх строках

1. Мерчант подключает свой Kaspi в кабинете: номер сотрудника с ролью «Кассир» и код из SMS.
2. Код выставляет счёт: `POST /v2/qr` или `POST /v2/invoices` с заголовком `X-API-Key`.
3. Покупатель платит в Kaspi. Поллер платформы видит оплату за несколько секунд.
4. Событие `payment.paid` приезжает вебхуком с подписью HMAC-SHA256 и ложится в журнал.

## Что стоит знать до интеграции

- Ключи бывают тестовые (`sk_test_`) и боевые (`sk_live_`). Тестовый работает ТОЛЬКО
  с песочницей, боевой ТОЛЬКО с настоящим Kaspi. Смешать нельзя — это проверка, а не соглашение.
- Песочница повторяет боевой путь целиком, включая задержку поллера. Деньги не двигаются.
- `Idempotency-Key` обязателен на всех операциях, создающих платёж.
- Провайдер может отказать, вернув HTTP 200 и операцию в статусе `failed` — это не ошибка HTTP.
- У Kaspi одна активная сессия на номер. Вход в приложение Kaspi Pay под номером кассира
  вытесняет сессию платформы, и приём платежей встаёт до повторного входа по SMS.
- У аккаунта может быть несколько Kaspi-касс. Ключ привязывается к кассе, и это граница:
  чужую кассу таким ключом не назвать даже явным `connection_id`.

## Правовое

- [Публичная оферта](https://aitole.kz/legal/oferta.html)
- [Политика конфиденциальности](https://aitole.kz/legal/privacy.html)
- [Согласие на обработку персональных данных](https://aitole.kz/legal/consent.html)

## Чего здесь нет

Aitole не выпускает карты, не хранит деньги, не делает эквайринг и не заменяет
Kaspi. Это тонкий слой автоматизации поверх аккаунта, который у мерчанта уже есть.