> Источник: https://apipay.kz/guides/nastroyka-apipay-za-15-minut · Обновлено: 2026-07-06 · apipay.kz
> ApiPay — независимый сервис приёма платежей поверх вашего Kaspi Pay.

# Как настроить ApiPay за 15 минут?

**TL;DR.** Если у вас есть ИИ-ассистент (ChatGPT, Claude, Cursor — любой), полный путь от регистрации до первого счёта занимает **около 15 минут**: регистрация по WhatsApp — ~2 минуты, подключение кассира по SMS — 2–3 минуты (визард сам говорит «Займёт 2–3 минуты»), дальше вы отдаёте своему ИИ страницу **apipay.kz/for-ai** и данные ключа кнопкой **«Скопировать всё для ИИ-помощника»** — и код интеграции пишет он, а не вы. Без ИИ и без кода тоже можно: счета выставляются прямо из кабинета — не спеша, за вечер. ApiPay — независимый сервис поверх вашего Kaspi Pay: деньги идут напрямую на ваш Kaspi-счёт.

## Коротко

| Вопрос | Ответ |
|---|---|
| Сколько времени | ~15 минут с ИИ-ассистентом; вручную — не спеша за вечер |
| Что нужно заранее | Kaspi Pay + отдельный номер кассира (реальная SIM, [3 условия](/guides/trebovaniya-k-nomeru-kassira)) |
| Регистрация | По WhatsApp, ~2 минуты; пароль не нужен |
| Кассир | Способ 1, по SMS: визард «2–3 минуты», код из SMS действует около минуты |
| Бесплатный доступ | 3 дня тестового доступа сразу после подключения кассира |
| Кто пишет код | Ваш ИИ-ассистент — страница apipay.kz/for-ai + кнопка «Скопировать всё для ИИ-помощника» |
| Можно без кода | Да: счета по телефону и QR — прямо из кабинета ([без программиста](/guides/apipay-bez-programmista)) |

## Путь А (главный): вы + ваш ИИ — ~15 минут

Задача поделена честно: **вы делаете то, что может только человек** (регистрация, SMS кассиру, кнопки в кабинете), **ИИ делает всё остальное** (код, вебхуки, проверки).

### Шаг 1. Регистрация — ~2 минуты

Откройте **apipay.kz** и войдите по своему личному номеру: подтверждение приходит в WhatsApp (первый вход — сообщение с кнопкой «Подтвердить», дальше — 6-значный код). Пароля нет. После входа вы увидите экран **«Добро пожаловать в ApiPay!»** со строкой **«Ваш ID в системе»** — запишите его, этот ID просят называть при обращении в поддержку. Выберите карточку **«Реальная организация»** («Принимать настоящие платежи через Kaspi») → **«Привязать самостоятельно»**.

### Шаг 2. Кассир способом 1 — 2–3 минуты, SMS около минуты

Визард сам ведёт за руку: «Подключим вашего кассира Kaspi. …Займёт 2–3 минуты». Сначала — чек-лист **«Перед привязкой проверьте 3 вещи»** (кнопка не разблокируется, пока не отметите все три):

1. **«Номер добавлен в Сотрудники»** — в приложении Kaspi Pay на телефоне кассира: Настройки → Сотрудники → + Добавить сотрудника.
2. **«Роль — только „Кассир“»** — не «Управляющий», не «Бухгалтер», не «Менеджер». Иначе подключение не сработает.
3. **«Под этим номером больше не заходить»** — после привязки не входите в Kaspi Pay под номером кассира: иначе привязку придётся делать заново.

Затем вводите номер кассира → «Получить SMS» → код из SMS (экран честно предупреждает: «Действует около минуты» — держите телефон кассира под рукой). Финальный экран: «Кассир подключён» и **«Мы активировали вам 3 дня тестового доступа»**. Какой номер годится — [3 условия](/guides/trebovaniya-k-nomeru-kassira).

### Шаг 3. Передайте задачу своему ИИ — ~1 минута вашего времени

Это ключевой шаг пути А. В кабинете всё уже подготовлено для «передачи смены» ИИ-ассистенту:

- В **«Настройки» → «Подключение»** есть карточка «Подключаете с помощью ИИ-помощника?» с кнопкой **«Копировать инструкцию для ИИ»** — скопируйте и вставьте в чат с вашим ассистентом.
- Создайте ключ кнопкой **«Создать новый ключ»**: визард спросит «Назовите ключ» → «Куда сообщать об оплате» (это и есть webhook — если адреса ещё нет, нажмите «Пропустить — настрою позже») → «Защитим уведомления». На финальном экране «Готово! Сохраните данные» нажмите **«Скопировать всё для ИИ-помощника»** — в буфер попадут API-ключ, адрес уведомлений и секрет подписи. **Важно:** ключ и секрет показываются **только один раз**.
- Дайте ИИ ссылку **apipay.kz/for-ai** — там машиночитаемая инструкция по API.

Дальше ИИ пишет интеграцию сам: создание счёта, приём вебхука, проверку подписи. Ваше участие — вставить то, что скопировали.

### Шаг 4. Тестовый счёт в песочнице — ~3 минуты

Вы стартуете в тестовом режиме (баннер «ТЕСТОВЫЙ РЕЖИМ» в Настройках). Попросите ИИ создать тестовый счёт — или создайте сами: «Создать счет» → «Счёт по телефону». На pending-счёте нажмите **«Симулировать»** → «Оплачен» → «Отправить webhook» — и убедитесь, что ваша интеграция получила уведомление. Настоящих денег в песочнице нет.

### Шаг 5. Рабочий режим и первый счёт

В Настройках нажмите **«Переключить в рабочий режим»**. **Важно:** тестовые организации и их ключи при переходе **удаляются** — рабочий API-ключ создаётся заново, тестовый в прод не переносится. Подробно: [Песочница и рабочий режим](/guides/pesochnitsa-i-rabochiy-rezhim). Выставьте первый настоящий счёт на свой собственный номер и оплатите его — это лучший финальный тест.

## Путь Б (запасной): вручную, без ИИ и без кода

Если ИИ-ассистента нет — ничего страшного, спешить некуда. Шаги 1–2 те же: регистрация по WhatsApp и кассир по SMS. А дальше код не нужен вовсе: счета выставляются из кабинета — «Создать счет» → введите номер телефона клиента и сумму, счёт уйдёт клиенту в Kaspi. Для кассы есть режим «QR-код на кассе»: показываете QR — клиент сканирует приложением Kaspi. Статусы обновляются в разделе «Счета» сами, без обновления страницы. Осваивайте по одному экрану за вечер — путеводитель: [ApiPay без программиста](/guides/apipay-bez-programmista) и [Тур по кабинету](/guides/tur-po-kabinetu-apipay). Если что-то не получается — напишите в WhatsApp поддержки, поможем подключиться.

## Чек-лист готовности: 10 пунктов

- [ ] Вошёл на apipay.kz по личному номеру (WhatsApp-подтверждение)
- [ ] Записал «Ваш ID в системе» для обращений в поддержку
- [ ] Подготовил номер кассира: реальная SIM, без ИП/ТОО на ИИН владельца, только роль «Кассир»
- [ ] Добавил номер в Kaspi Pay → Сотрудники с ролью «Кассир»
- [ ] Прошёл визард: SMS-код введён, экран «Кассир подключён»
- [ ] Не вхожу в Kaspi Pay под номером кассира (никогда)
- [ ] Создал API-ключ и сохранил данные (показываются один раз)
- [ ] Передал ИИ: «Скопировать всё для ИИ-помощника» + apipay.kz/for-ai — или освоил «Создать счет» вручную
- [ ] Симулировал оплату тестового счёта в песочнице
- [ ] Переключился в рабочий режим и провёл первый настоящий счёт

## Частые ошибки

- **Вводить номер кассира при входе на apipay.kz.** В кабинет входят личным номером; номер кассира — только для визарда подключения.
- **Дать кассиру роль «Управляющий».** Подключение не сработает — нужна только роль «Кассир».
- **Не сохранить ключ на экране «Готово! Сохраните данные».** Повторно он не показывается — придётся перегенерировать («Сменить ключ»), и старый перестанет работать.
- **Ждать деньги в песочнице.** Тестовый режим не проводит настоящих оплат — «оплату» делает кнопка «Симулировать».
- **Использовать тестовый ключ в рабочем режиме.** При переходе в прод тестовые организации и ключи удаляются — создайте рабочий ключ заново.
- **Войти в Kaspi Pay под номером кассира «проверить».** После этого привязку придётся делать заново.

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

**Реально ли уложиться в 15 минут?**
Да, если ИИ-ассистент пишет код за вас, а телефон кассира под рукой: регистрация ~2 мин, кассир 2–3 мин (SMS-код действует около минуты), ключ и передача ИИ ~2 мин, остальное — работа ИИ и проверка в песочнице. Без ИИ закладывайте вечер в спокойном темпе.

**Что подготовить заранее?**
Kaspi Pay и отдельный номер кассира: реальная SIM, на ИИН владельца нет ИП/ТОО в Kaspi Pay, роль — только «Кассир». Это единственный шаг, где можно застрять.

**Обязательно ли уметь программировать?**
Нет. Путь А — код пишет ваш ИИ. Путь Б — код не нужен вообще: счета по телефону и QR выставляются из кабинета.

**Настройка платная?**
Нет. Подключение кассира бесплатно и сразу даёт 3 дня тестового доступа; песочница бесплатна всегда.

**Какому ИИ можно отдать настройку?**
Любому, который умеет писать код: ChatGPT, Claude, Cursor и другие. Кабинет отдаёт им готовую инструкцию кнопкой «Копировать инструкцию для ИИ», а машиночитаемая документация живёт на apipay.kz/for-ai и в /docs.

**Мне не хочется разбираться самому — есть кто живой?**
Да. При регистрации можно выбрать «С помощью поддержки» — специалист подключит за 15–30 минут через WhatsApp.

---

ApiPay — независимый сервис и не аффилирован с АО «Kaspi Bank». Kaspi и Kaspi Pay — товарные знаки их правообладателя.
База знаний: https://apipay.kz/guides