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

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

**TL;DR.** ApiPay — сервис, через который ваш сайт, 1С, бот или сам кабинет выставляет покупателям счета Kaspi Pay и узнаёт об оплате. Начать так: **регистрация по WhatsApp (~2 минуты) → анкета «Расскажите о вашем бизнесе» (~5 минут, проверка обычно несколько часов) → [мастер подключения кассира](/connect-cashier) по SMS (2–3 минуты) → настоящие счета**. Песочница открывается сразу после регистрации, анкета для неё не нужна — интеграцию можно писать и проверять в тот же день. Код пишет ваш ИИ-ассистент: ИИ в чате (ChatGPT, Claude) — создайте API-ключ, нажмите **«Скопировать инструкцию без ключей»** и дайте ему страницу [apipay.kz/for-ai](/for-ai); ИИ, который работает прямо в проекте с терминалом (Claude Code, Codex), начинает с экрана [«Подключить с ИИ»](/setup/ai) — ключ в проект положит программа ApiPay после вашего подтверждения. Без ИИ и без кода тоже можно: счета выставляются прямо из кабинета.

## Что нужно и сколько времени займёт?

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

## С чего начать — какую задачу вы решаете?

### Как попробовать кабинет без настоящих платежей?

После регистрации выберите **«Попробовать без настоящих платежей»**. Ответьте, подключена ли у вас касса Kaspi (ОФД), прочитайте короткое пояснение и создайте тестовую организацию. На главной нажмите **«Создать пробный счёт»**. Для ручной работы не нужны API-ключ и webhook.

После создания счёт появится в списке. Кнопка **«Проверить оплату»** позволяет проверить изменение статуса. Деньги не перемещаются. Тестовый режим не ограничен по времени и не расходует три бесплатных дня рабочего тарифа.

### Как начать принимать настоящие платежи?

Выберите **«Подключить рабочую организацию»**. Сначала заполните анкету «Расскажите о вашем бизнесе» и дождитесь проверки, затем подключите кассира. Если сейчас неудобно заполнять анкету, выберите тестирование: новая организация для этого не нужна.

Кнопка **«Сохранить и продолжить позже»** сохраняет анкету в этом браузере. Если её вернут на доработку, исправьте данные по комментарию. При отказе обратитесь в поддержку.

После одобрения откройте мастер подключения кассира (как он устроен — на странице [«Подключение кассира»](/connect-cashier)). Мастер попросит отметить чек-лист «Перед привязкой проверьте 3 вещи», затем номер кассира и SMS-код. Не входите в Kaspi Pay под номером кассира после подключения. Если мастер не проходит, напишите в поддержку WhatsApp **77003076512** — это запасной путь, там помогут подключить кассира. Три бесплатных дня начинаются при подключении кассира, если организации доступен пробный тариф; сам факт выдачи будет показан на результате.

На экране результата можно сразу включить рабочий режим. Перед сменой режима кабинет попросит подтвердить удаление тестовых данных. Затем можно создать настоящий счёт. Для приёма платежей должны выполняться действующие требования к организации, кассиру и тарифу.

### Как подключить сайт или программу, в том числе с ИИ?

Если ИИ работает прямо в вашем проекте с терминалом (Claude Code, Codex), ключ здесь создавать не нужно: начните с экрана «Подключить с ИИ» — ключ в проект положит программа ApiPay после вашего подтверждения. На главной откройте **«Подключить сайт или программу»**. Кнопка **«Получить API-ключ»** открывает создание прямо здесь; по умолчанию имя — «Моё подключение». После создания скопируйте одноразовый ключ в защищённые настройки приложения. Ключи не передавайте в чат, ИИ-помощнику или посторонним.

Не закрывая окно, раскройте строку **«Подключаете с помощью ИИ? Готовая инструкция»** и нажмите **«Скопировать инструкцию без ключей»** — это текст задания для вашего ИИ без ключа и секрета. Затем нажмите **«Я сохранил ключ»**: окно закроется. Вместе с инструкцией дайте ассистенту [apipay.kz/for-ai](/for-ai); полный справочник API — в [документации](/docs). Если ваш ИИ-клиент поддерживает MCP, есть и отдельный экран «Подключить с ИИ» — как им пользоваться, описано в [гайде по Setup MCP](/guides/podklyuchenie-apipay-mcp).

Чтобы узнать об оплате, для старта хватит опроса: программа с сервера запрашивает `GET /invoices/{id}` и смотрит статус счёта. Не прекращайте проверку, когда счёт истёк или отменён: ещё 24 часа он может перейти в «Оплачен» — как часто опрашивать, написано в [настройке вебхуков](/guides/nastroyka-webhookov-apipay). Webhook — по желанию, его можно настроить позже, когда будет готов адрес программы: выберите **«Настроить уведомления об оплате»**, нужное подключение, укажите адрес и нажмите **«Проверить уведомление»**.

### Как выставить счёт вручную, без кода?

Откройте **«Создать счет»**, заполните номер покупателя и сумму либо выберите QR. После создания телефонного счёта откроется список счетов. Черновик сохраняется в текущей вкладке при переходе к анкете или кассиру и восстанавливается при возвращении. Перед отправкой проверьте его: автоматически он не отправляется.

Черновики разделены по аккаунту, организации и режиму. После создания, явной отмены и выхода из аккаунта черновик очищается. Тестовые данные не подставляются в настоящий счёт.

## Где искать помощь, если что-то не получается?

Короткие ответы можно раскрыть рядом с действием. Подробные гайды и поддержка остаются в меню помощи. Тур запускается по желанию на компьютере; на телефоне используются обычные пояснения. Ошибки поля показаны рядом с формой, а действующие препятствия — в одном блоке состояния кабинета.

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

**Сколько времени занимает настройка ApiPay?**
Около 15 минут вашей работы, если код пишет ваш ИИ-ассистент: регистрация ~2 минуты, анкета ~5 минут, подключение кассира 2–3 минуты, ключ и передача задания ИИ — несколько минут. Между анкетой и кассиром добавьте ожидание одобрения — обычно несколько часов; песочница всё это время доступна.

**Обязательно ли уметь программировать?**
Нет. Код может написать ваш ИИ-ассистент: кнопка «Скопировать инструкцию без ключей» на экране нового ключа плюс страница apipay.kz/for-ai. А можно работать вообще без кода — счета по телефону и QR выставляются из кабинета.

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

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

**Не проходит мастер подключения кассира — что делать?**
Напишите в поддержку WhatsApp **77003076512** — это запасной путь, там помогут подключить кассира.

---

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