# Счёт Kaspi из бота в Salebot

> Бот в Salebot блоком «API-запрос» отправляет через Qut Pay счёт в приложение Kaspi.kz клиента, а затем проверяет оплату. Настройка блока, переменные, ошибки и порядок проверки.

## Коротко

Бот, собранный в Salebot, может сам отправлять счёт Kaspi. Для этого в блок, где подтверждается заказ, добавьте раздел Salebot «API-запрос» и отправьте один запрос в API Qut Pay. Счёт придёт в приложение Kaspi.kz клиента. Когда клиент напишет «Оплатил», вторым запросом проверьте состояние счёта. Программист не нужен. Полная инструкция: [api.qut.kz/docs/guide/salebot](https://api.qut.kz/docs/guide/salebot).

Qut Pay и Salebot — разные сервисы, мы не партнёры. В Salebot API-функции работают только на тарифах «Бизнес» и «Инфобиз».

## Блок создания счёта

| Поле | Значение |
|---|---|
| Тип | `POST-json` |
| URL | `https://api.qut.kz/api/v1/invoices` |
| Заголовок запроса | `{"X-API-Key": "qp_live_…", "Content-Type": "application/json"}` |
| JSON параметры | `{"kind": "phone", "amount": #{amount}, "description": "Заказ #{order_id}", "idempotencyKey": "salebot-#{order_id}", "customer": {"phone": "#{phone}"}}` |
| Сохраняемые значения | `id->qp_invoice_id; status->qp_status; error->qp_error` |

`kind: "phone"` отправляет счёт прямо в приложение Kaspi клиента, поэтому ссылку в WhatsApp слать не нужно. Сумма — только целые тенге. Почему `phone` удобнее, читайте в статье [QR или счёт на телефон](/kb/ru/qr-vs-phone).

`idempotencyKey` нужен, чтобы при двойном нажатии не создался второй счёт. Подробнее: [повторный запрос](/kb/ru/idempotency).

## Блок проверки оплаты

| Поле | Значение |
|---|---|
| Тип | `GET` |
| URL | `https://api.qut.kz/api/v1/invoices/#{qp_invoice_id}` |
| Заголовок запроса | как в блоке создания |
| Сохраняемые значения | `status->qp_status` |

Затем проверьте блоком с условием:

- `paid` — «✅ Оплата получена».
- `pending` — «Счёт в вашем приложении Kaspi, после оплаты напишите ещё раз».
- `failed` — счёт не дошёл. Попросите у клиента номер Kaspi и отправьте заново с новым `idempotencyKey` ([если у клиента нет Kaspi](/kb/ru/customer-no-kaspi)).
- `expired` — срок истёк, создайте новый счёт.

Salebot не принимает вебхуки Qut Pay напрямую, поэтому состояние запрашивается, когда клиент пишет или нажимает кнопку. А вам о каждой оплате сообщит Telegram, подключённый в кабинете Qut Pay.

## Сначала в тестовом режиме

1. Кабинет → Интеграции → API-ключи → создайте тестовый ключ (`qp_test_…`) ([API-ключи](/kb/ru/api-keys)).
2. Сделайте заказ в боте сами — в кабинете появится тестовый счёт.
3. Откройте счёт и нажмите «[Sandbox] оплачен».
4. Напишите боту «Оплатил» — бот должен ответить «✅ Оплата получена».
5. Затем замените ключ на `qp_live_…`.

## Частые вопросы

### Это платно?

Входит в тариф Qut Pay, отдельно не оплачивается. В месячный лимит идут только оплаченные счета. Kaspi удерживает свою комиссию отдельно. Тариф Salebot — сам по себе.

### Номер клиента сохранён как «+7 701 …» — подойдёт?

Да. `+7 701 123 45 67`, `87011234567` и `77011234567` Qut Pay сам приводит к 11 цифрам.

### Что делать в Telegram-боте?

Уберите `kind` — в ответе придёт `payUrl`, страница с QR и кнопкой «Оплатить в Kaspi». Добавьте в сохраняемые значения `payUrl->qp_pay_url` и отправьте ссылку клиенту.

### Безопасно ли ставить ключ в бота?

Ключ хранится на сервере Salebot, клиент его не видит. Но не отправляйте его в чат, на скриншоты или в открытые документы. Если ключ утёк, удалите его в кабинете и создайте новый.
