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

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

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

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

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

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

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

Какой номер годится — 3 условия. Разбор шагов визарда — Подключение кассира; если привязка не проходит — Кассир не подключается.

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

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

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

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

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

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

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

В Настройках нажмите «Переключить в рабочий режим». Ключ в личном кабинете один на оба режима — после переключения тот же ключ начнёт выставлять реальные счета реальным покупателям, поэтому заранее разведите тестовые и боевые данные (Песочница и рабочий режим). Выставьте первый настоящий счёт на свой собственный номер и оплатите его — это лучший финальный тест.

Боевая проверка здесь ровно одна: пока не одобрена анкета о бизнесе на /business-profile, организация выставляет 1 реальный счёт в сутки — Анкета о бизнесе и лимит. Всю отладку держите в песочнице: суточного лимита там нет.

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

Шаги 1–2 те же: регистрация по WhatsApp и кассир по SMS. А дальше код не нужен вовсе: счета выставляются из кабинета — «Создать счет» → номер телефона клиента и сумма, счёт уйдёт клиенту в Kaspi. Для кассы есть режим «QR-код на кассе»: показываете QR — клиент сканирует приложением Kaspi. Осваивайте по одному экрану за вечер — путеводитель: ApiPay без программиста и Тур по кабинету.

Чек-лист готовности

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

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