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

Путь А (главный): вы + ваш ИИ — ~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 условия.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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