> Источник: https://apipay.kz/ · apipay.kz
> ApiPay — независимый сервис приёма платежей поверх вашего Kaspi Pay.

# ApiPay — REST API для автоматизации Kaspi Pay

**TL;DR.** ApiPay — казахстанский сервис: REST API и личный кабинет поверх собственного Kaspi Pay продавца. Счета выставляются автоматически, оплата подтверждается вебхуком, без скриншотов и ручной сверки. Получить оплату можно тремя способами: счётом по номеру телефона (покупателю приходит push в Kaspi), оплатой по ссылке или QR и печатным QR под сделку. Деньги идут напрямую на Kaspi-счёт продавца — ApiPay их не касается, чеки выбиваются через Kaspi ОФД. Стоимость — фиксированная подписка от 10 000 ₸ в месяц, процента с платежей нет. Сервис адресован бизнесу-продавцу, не покупателям.

## Что делает ApiPay

Kaspi Pay — приложение для бизнеса, которое открывается бесплатно через приложение Kaspi. Публичного платёжного API у Kaspi нет, поэтому счета обычно выставляют руками, а оплату сверяют по скриншотам. ApiPay закрывает этот разрыв: подключается с правами штатной роли «Кассир» в Kaspi Pay продавца и даёт над ней REST API и кабинет.

ApiPay — независимый сервис поверх вашего Kaspi Pay, а не официальная интеграция и не партнёр Kaspi. Мы не банк и не платёжная система: деньги идут напрямую на ваш Kaspi-счёт, мы их видим, но не обрабатываем. Наша задача — показать вам, что клиент оплатил.

Что входит во все тарифы:

- **Счета** — по номеру телефона, по ссылке или QR, печатным QR под сделку.
- **Вебхуки** об оплате — подпись `X-Webhook-Signature: sha256=<hex>`, HMAC-SHA256 от сырого тела запроса.
- **Возвраты** — полные и частичные, из кабинета в один клик или через API.
- **Подписки (рекуррентные платежи)** — автоматическое выставление счетов ежедневно, еженедельно, ежемесячно или ежегодно, с паузой, возобновлением и пропуском периода. Это авто-**выставление**, а не автосписание: покупатель подтверждает каждую оплату сам.
- **Каталог товаров и корзина** — позиции счёта, штрихкоды, НТИН.
- **Личный кабинет** — счета, статистика, настройки, до 10 менеджеров; работать можно без программирования.
- **Фискальные чеки** через Kaspi ОФД, поддержка на русском и казахском.

Технически: Base URL `https://api.apipay.kz/api/v1`, заголовок `X-API-Key`, 200 запросов в минуту на ключ, телефон покупателя строго `8XXXXXXXXXX`. API-ключ — серверный секрет: его нельзя класть в код страницы, в мобильное приложение или в публичный репозиторий.

ApiPay не обслуживает казино, беттинг, лотереи и другие азартные игры, крипту и форекс, оружие и взрослый контент.

## Три способа получить оплату

Способ выбирают до того, как писать код.

| Способ | Эндпоинт | Что отдаёт | Срок жизни | Когда выбирать |
|---|---|---|---|---|
| Счёт по номеру телефона | `POST /invoices` | покупатель получает push в приложении Kaspi. Ссылки для отправки у такого счёта нет — есть вычисляемое поле `kaspi_qr_link` (ссылка/QR по этому счёту; `null` в статусе `processing` и всегда `null` в песочнице) | 24 часа | знаете номер покупателя в формате 8XXXXXXXXXX |
| Оплата по ссылке или QR | `POST /invoices/qr` | `qr_token_url` — ссылка на оплату: отправьте её покупателю в мессенджер или откройте на его телефоне, сканировать не обязательно. `qr_image_url` — готовый PNG, если QR нужно показать на экране | окно на скан или открытие ссылки задаёт Kaspi (минуты) — точный момент берите из `qr_expires_at`, константу не зашивайте | покупатель здесь и сейчас: в зале у кассы, в чате, на сайте |
| Печатный QR под сделку | `POST /static-qr` | `print_url` — долгоживущая ссылка на страницу оплаты, её же кодирует QR-картинка; `short_code` для ручного ввода; `qr_image_url` — готовый PNG | живёт, пока лист не оплачен, не отключён `DELETE /static-qr/{id}` и не наступил заданный вами `expires_at` | оплатить позже: напечатать, вложить в заказ, отправить «на потом» |

Детали: `POST /invoices` асинхронный — `201` со `status: processing` это норма, итог придёт вебхуком, пересоздавать счёт нельзя. `POST /invoices/qr` синхронный: `201` сразу со `status: pending` и ссылкой. Описание счёта по номеру — до 60 символов, QR-счёта — до 100. У организации с каталогом `cart_items` обязательны в QR-счёте, печатном листе и подписке; счёт по номеру она может выставить и произвольной суммой.

## Как это работает

1. **Регистрация через WhatsApp** — вводите номер телефона и подтверждаете вход в WhatsApp; логина и пароля нет.
2. **Анкета «Расскажите о бизнесе»** — один раз в кабинете, около 5 минут.
3. **Подключение Kaspi Pay** — пошаговый помощник в кабинете, пара минут: номер сотрудника с ролью «Кассир» → код из SMS → привязка.
4. **3 дня бесплатно** — полный доступ ко всем функциям на каждую подключённую Kaspi-организацию.
5. **Подписка** — после тестового периода, от 10 000 ₸/мес.

Дальше цикл такой: вы или ваша программа создаёте счёт → покупатель оплачивает его в приложении Kaspi → деньги зачисляются напрямую на ваш Kaspi-счёт → приходит вебхук, обычно за секунды → чек выбивается через Kaspi ОФД.

Для кассира нужен **отдельный номер телефона**: пока он привязан к ApiPay, под этим номером нельзя входить в приложение Kaspi Pay (для бизнеса) — привязка разорвётся и счета перестанут выставляться до переподключения. Личным приложением Kaspi на этом номере пользоваться можно. Обрыв виден интеграции как `connection.needs_reauth: true` в `GET /account/health`, а переподключение — самообслуживание в кабинете, около минуты.

## Кому подходит

- **Телеграм-боты.** Оплата идёт напрямую на ваш Kaspi Pay, покупатель платит привычным Kaspi.
- **Онлайн-магазины.** Работает с Tilda, WordPress и любым сайтом через REST API.
- **Доставка и сервисы.** Курьер выставляет счёт с телефона, терминал каждому не нужен, видно, кто оплатил.
- **CRM-автоматизация.** AmoCRM, Bitrix24, 1С: сделка → счёт создаётся сам, при оплате приходит уведомление.

Среди клиентов — Neuro AGA, IziBiz, KazDoc, QazWork, Aleem, Printo, Chat Keñes, RentDocs, ARQA, SabaQ, FinStat, CCO, myplaner.

## Тарифы

Фиксированная подписка без процента с оборота, оплата ежемесячная; за 3 месяца — скидка 5 %, за 6 месяцев — 10 %.

| Тариф | Цена в месяц | Лимит счетов |
|---|---|---|
| Старт | 10 000 ₸ | до 30 счетов в день |
| Бизнес | 25 000 ₸ | до 100 счетов в день |
| Про | 60 000 ₸ | до 300 счетов в день |
| Про Макс | 90 000 ₸ | до 600 счетов в день |
| Больше 600 счетов в день | договорная цена | напишите нам |

Набор функций у всех тарифов одинаковый — различается только дневной лимит.

Лимит считается по счетам, созданным **через API** за сутки, — и оплаченным, и неоплаченным; счета из кабинета и из песочницы в него не входят. Разовый всплеск продаж работу не блокирует: ограничение включается при систематическом превышении и снимается переходом на тариф выше сразу после оплаты. Расход — в `GET /users/me` → `daily_usage`.

Отдельно Kaspi удерживает свою комиссию за приём платежа — это отношения продавца с Kaspi, ApiPay в них не участвует.

## Что нужно для старта

Нужны только Kaspi Pay и WhatsApp для входа. Не требуется программист, кредитная карта или собственная интеграция с банком.

- **Песочница** доступна сразу после регистрации и анкеты не требует: счета в Kaspi не уходят, дневные лимиты тарифа и триала на неё не распространяются. Своя квота у неё есть — 1000 тестовых счетов на организацию; место освобождает очистка песочницы в кабинете.
- **Анкета «Расскажите о бизнесе»** (`/business-profile`) — разовая проверка ради защиты кассы продавца, ~5 минут. Пока она не одобрена, подключить кассира нельзя: шаги подключения отвечают `403 kyc_required`. Там, где кассир уже привязан или организацию ведёт партнёр, боевых счетов до одобрения не выставляется вовсе — первая попытка даёт `429 kyc_daily_limit_reached` с `meta.limit = 0`. Песочница этим не затронута.
- **Кассир** — отдельный номер сотрудника с ролью «Кассир».
- **Тестовый период** — 3 дня на каждую подключённую Kaspi-организацию, лимит 50 реальных счетов в сутки через API. Оплата — после его окончания.

Своих SDK и MCP-сервера у ApiPay пока нет — интеграция прямым HTTP. npm-пакет `apipay` нам не принадлежит; наш пакет для n8n — `n8n-nodes-apipay`.

## FAQ

**Насколько это безопасно?** ApiPay — независимый сервис поверх вашего Kaspi Pay, а не официальная интеграция и не партнёр Kaspi. Мы подключаемся с правами роли «Кассир» — это штатная роль в Kaspi Pay, её описание есть в справке Kaspi. Деньги идут напрямую на ваш Kaspi-счёт, чеки выбиваются через Kaspi ОФД. Мы не банк и не платёжная система, ваших денег не касаемся — только автоматизация.

**Куда приходят деньги?** Напрямую вам в Kaspi Pay. Мы их видим, но не обрабатываем.

**Есть ли комиссия с платежей?** ApiPay процента с продаж не берёт: вы платите только за использование сервиса, от 10 000 до 90 000 ₸/мес по тарифу. Скрытых комиссий нет.

**Можно ли принять оплату по ссылке?** Да. `POST /invoices/qr` создаёт счёт без номера телефона и возвращает `qr_token_url`: её отправляют покупателю в мессенджер или ставят кнопкой «Оплатить в Kaspi» на странице заказа. На телефоне она открывает готовый платёж в Kaspi, сканировать ничего не нужно, но действует несколько минут — до `qr_expires_at`. Заплатит позже — нужен другой инструмент: счёт по номеру живёт 24 часа, а печатный QR даёт `print_url`, которая работает, пока лист не оплачен или не отключён.

**Можно ли делать возвраты?** Да, полные и частичные — из кабинета или через API.

**Есть ли рекуррентные платежи?** Да — автоматические счета с любой периодичностью. Автосписания нет: покупатель подтверждает каждую оплату сам.

**Можно ли работать без программиста?** Да: счета, возвраты, подписки и каталог доступны в кабинете вручную.

## Реквизиты

Товарищество с ограниченной ответственностью «ApiPay» (ТОО «ApiPay»)
БИН 260740019652
Юридический адрес: Казахстан, 050012, г. Алматы, Алмалинский район, проспект Сейфуллина, дом 498, н.п. 53б
Сервис работает с 2 февраля 2026 года.

Основатель и руководитель — **Георгий Личутин**, он ведёт открытый блог о сервисе в Threads (`@movie_kelly`). Документы открыты до подключения: [публичная оферта](https://apipay.kz/docs/offer.pdf), [соглашение о предоставлении доступа](https://apipay.kz/docs/agreement.pdf), [политика конфиденциальности](https://apipay.kz/docs/privacy-policy.pdf), [согласие на обработку персональных данных](https://apipay.kz/docs/consent.pdf).

Поддержка: WhatsApp [+7 700 307 65 12](https://wa.me/77003076512), почта support@apipay.kz. Открытые материалы: github.com/bazarbaykz/apipay-docs и npmjs.com/package/n8n-nodes-apipay.

ApiPay не аффилирован с АО «Kaspi Bank». Kaspi и Kaspi Pay — товарные знаки их правообладателя.

## Куда дальше

Документация для машин:

- https://apipay.kz/llms.txt — индекс для ИИ-агентов
- https://apipay.kz/llms-full.txt — полный свод фактов
- https://apipay.kz/for-ai — плейбук интеграции
- https://apipay.kz/openapi.json — OpenAPI 3.0
- https://apipay.kz/errors.md — каталог кодов ошибок
- https://apipay.kz/kaspi-api.md — приём оплаты Kaspi программно
- https://apipay.kz/partner-api.md — Partner API

Ключевые гайды базы знаний (у каждой есть версия без суффикса `.md`):

- https://apipay.kz/guides/nastroyka-apipay-za-15-minut.md — настройка за 15 минут
- https://apipay.kz/guides/podklyuchenie-kassira-kaspi.md — подключение Kaspi-кассы
- https://apipay.kz/guides/anketa-o-biznese-i-limit.md — анкета о бизнесе
- https://apipay.kz/guides/apipay-bez-programmista.md — счета из кабинета без кода
- https://apipay.kz/guides/kak-sozdat-schet-kaspi-po-nomeru.md — счёт по номеру
- https://apipay.kz/guides/pechatnyy-qr-dlya-oplaty-po-sdelke.md — печатный QR под сделку
- https://apipay.kz/guides/nastroyka-webhookov-apipay.md — вебхуки и подпись
- https://apipay.kz/guides/vozvraty-kaspi-cherez-api.md — возвраты через API
- https://apipay.kz/guides/podpiski-apipay.md — подписки
- https://apipay.kz/guides/tarify-i-komissiya-apipay.md — сколько стоит

Хаб базы знаний — https://apipay.kz/guides · вход — https://apipay.kz/login