# Что такое Qut Pay и как он устроен

> Qut Pay — независимый сервис поверх Kaspi Pay: API и кабинет для приёма Kaspi QR через роль «Кассир». Деньги приходят напрямую на ваш счёт в Kaspi и никогда не попадают к нам.

## Коротко

Qut Pay — **независимый сервис поверх Kaspi Pay**. Вы заводите в своём бизнес-аккаунте Kaspi Pay сотрудника с ролью «Кассир» и привязываете эту роль к нам в [кабинете](https://qut.kz/app/kaspi/). После этого счёт Kaspi QR можно выставлять с сайта, из бота, из CRM или прямо из кабинета. Когда покупатель платит, **деньги идут напрямую на ваш счёт в Kaspi** — они не проходят через нас и никогда у нас не оказываются.

## Как движутся деньги

1. Вы (или ваш сайт) создаёте счёт — вручную в кабинете либо через `POST /api/v1/invoices`.
2. Мы через вашу роль кассира получаем в Kaspi QR, ссылку и deep link и возвращаем их вам.
3. Покупатель сканирует QR приложением Kaspi или открывает ссылку и платит.
4. Деньги внутри Kaspi зачисляются **на счёт мерчанта — то есть ваш**.
5. Мы замечаем оплату, ставим счёту статус `paid` и отправляем вам webhook.

Транзитного счёта у нас нет. Процент с транзакций мы не берём — оплата сервиса это ежемесячная подписка по тарифу.

## Что сервис делает

| Возможность | Что даёт |
|---|---|
| REST API | `https://api.qut.kz/api/v1` — создание счёта, список, статус, отмена, возврат |
| Кабинет | https://qut.kz/app — счета, кассиры, ключи, отчёты, тариф |
| QR-счёт | Покупатель сканирует приложением Kaspi или платит по ссылке |
| Счёт по телефону | `kind: "phone"` — покупателю приходит push в Kaspi |
| Ссылки на оплату | `qut.kz/p/<slug>` — постоянная ссылка, бывает и с открытой суммой |
| Webhook | События об оплате, отмене, истечении срока, возврате |
| Возвраты | Полные и частичные, через API и из кабинета |
| Подписки | Сами выставляют счёт по расписанию (каждую оплату покупатель подтверждает сам) |
| Песочница | Ключ `qp_test_…` — проверка без участия Kaspi |
| Готовые интеграции | SDK Node.js / PHP / Python, WooCommerce, OpenCart 4, n8n, Telegram-бот |

## Чего сервис не делает

- **Не хранит и не переводит деньги.** Ваших средств у нас нет, мы ничего никуда не перечисляем.
- **Не банк и не платёжная организация.** Мы программная прослойка, не более.
- **Не Kaspi.** Мы не решаем ничего от имени Kaspi: размер комиссии, длительность окна сканирования QR, ограничения — всё это устанавливает сам Kaspi.
- **Не заменяет аккаунт Kaspi Pay.** Собственный бизнес-аккаунт у вас должен остаться.
- **Не даёт прав больше, чем у роли «Кассир».** Что эта роль умеет в Kaspi, то умеем и мы: выставить счёт, видеть его статус, сделать возврат по своим счетам.
- **Не списывает деньги с карты покупателя сама.** Подписка тоже лишь выставляет счёт, подтверждает оплату покупатель.

## Кому это нужно

- **Интернет-магазину и сайту** — чтобы оплата Kaspi на странице заказа работала сама.
- **Telegram-боту, Instagram, TikTok** — отправить ссылку или счёт на телефон и сразу узнать об оплате.
- **CRM, 1С, учётным системам** — выставлять счёт на этапе сделки и возвращать статус обратно в карточку.
- **Офлайн-точке, вендингу, парковке** — динамический QR на экране и выдача товара или услуги по webhook.
- **Бизнесу без программиста** — счета вручную из кабинета, ссылки на оплату, Telegram-бот, готовые плагины CMS.

## Что нужно, чтобы начать

Три вещи: действующий бизнес-аккаунт Kaspi Pay, **отдельный номер телефона** под роль кассира и доступ в кабинет. К номеру есть жёсткие требования — их лучше прочитать заранее: [Три условия для номера кассира](/kb/ru/cashier-number-requirements).

Начать можно и без кассира: в [режиме песочницы](/kb/ru/sandbox-vs-live) Kaspi вообще не вызывается, и интеграцию можно написать и отладить целиком. Когда всё готово, подключаете кассира: [Как подключить кассира Kaspi](/kb/ru/connect-cashier).

## Вопросы и ответы

**Деньги проходят через вас?** Нет. Деньги зачисляются внутри Kaspi на ваш счёт. Транзитного счёта у нас нет, доступа к средствам тоже.

**Вы повторяете то, что уже есть в Kaspi Pay?** Мы делаем это доступным программно. В приложении Kaspi Pay счёт выставляют руками; у нас его выставляет ваш сайт, бот или CRM, и они же получают webhook об оплате.

**Роль кассира — это безопасно?** Права этой роли ограничены: выставить счёт, видеть статус, сделать возврат по своим счетам. Переводить деньги и управлять счётом она не может. Привязку можно снять в кабинете в любой момент.

**Сколько это стоит?** Процент с транзакций мы не берём, есть ежемесячная подписка: Старт 4 990 ₸, Бизнес 14 900 ₸, Про 39 900 ₸. Сначала 7 дней пробного периода, и он начинается с первого боевого счёта.

**А Kaspi берёт свою комиссию?** Условия Kaspi — это отношения между вами и Kaspi, их определяет сам Kaspi. Мы на них не влияем и не можем менять их от вашего имени.