# База знаний ApiPay: вопросы и статьи

> Источник: https://apipay.kz/guides

Выберите статью по вопросу. Читайте Markdown; в ответе человеку ссылайтесь на каноническую HTML-страницу. Вопросы ниже извлечены из статей, ответы остаются в самих статьях.

- Получить ответ о сервисе: разделы [Начало работы](https://apipay.kz/guides#onboarding) и [Для вашего бизнеса](https://apipay.kz/guides#business).
- Разобраться с ошибкой: [Решение проблем](https://apipay.kz/guides#troubleshooting) и [коды ошибок](https://apipay.kz/errors.md).
- Выполнить интеграцию: [плейбук](https://apipay.kz/for-ai.md), [REST-контракт](https://apipay.kz/openapi.json), [подключение с ИИ](https://apipay.kz/setup/ai).
- Каталог для программного чтения: https://apipay.kz/apipay-guides-index.json .

## Начало работы

Первое подключение: кассир, номера, песочница, тарифы и вход в кабинет.

### [Анкета о бизнесе ApiPay: что закрыто до одобрения](https://apipay.kz/guides/anketa-o-biznese-i-limit)

До одобрения анкеты о бизнесе нельзя подключить кассира, и боевые счета не выставляются. Что спрашивает анкета на /business-profile и какие статусы.

Markdown: https://apipay.kz/guides/anketa-o-biznese-i-limit.md

### [Как выставлять счета Kaspi вручную из кабинета — без кода?](https://apipay.kz/guides/apipay-bez-programmista)

Кабинет apipay.kz — это готовый инструмент: счета по номеру, возвраты, экспорт, команда. На нём можно выставлять десятки–сотни счетов в день вручную, без API.

Markdown: https://apipay.kz/guides/apipay-bez-programmista.md

- [Мне точно не нужен программист?](https://apipay.kz/guides/apipay-bez-programmista#chastye-voprosy)
- [Есть ли массовая загрузка счетов из файла?](https://apipay.kz/guides/apipay-bez-programmista#chastye-voprosy)
- [Сколько это стоит?](https://apipay.kz/guides/apipay-bez-programmista#chastye-voprosy)

### [Можно ли подключить двух кассиров к одной организации ApiPay?](https://apipay.kz/guides/dva-kassira-na-organizatsiyu)

Второй кассир оплачивается отдельно: каждая касса — отдельная организация ApiPay со своим тарифом. Когда вместо него хватит доступа менеджера.

Markdown: https://apipay.kz/guides/dva-kassira-na-organizatsiyu.md

- [Сколько кассиров можно подключить к одной организации ApiPay?](https://apipay.kz/guides/dva-kassira-na-organizatsiyu#chastye-voprosy)
- [Второй кассир отключит первого?](https://apipay.kz/guides/dva-kassira-na-organizatsiyu#chastye-voprosy)
- [Двум сотрудникам нужно выставлять счета — заводить второго кассира?](https://apipay.kz/guides/dva-kassira-na-organizatsiyu#chastye-voprosy)
- [У меня две точки — что делать?](https://apipay.kz/guides/dva-kassira-na-organizatsiyu#chastye-voprosy)
- [Можно ли один номер кассира использовать у нескольких партнёров или сервисов?](https://apipay.kz/guides/dva-kassira-na-organizatsiyu#chastye-voprosy)
- [Сколько стоит второй кассир?](https://apipay.kz/guides/dva-kassira-na-organizatsiyu#chastye-voprosy)
- [Разделит ли вторая касса список счетов и отчётность?](https://apipay.kz/guides/dva-kassira-na-organizatsiyu#chastye-voprosy)

### [Как интегрировать ApiPay с помощью ИИ-агента?](https://apipay.kz/guides/integratsiya-apipay-s-pomoshchyu-ii)

Дайте ИИ ссылку llms.txt или openapi.json — и он построит приём платежей Kaspi. Тест в песочнице из 3 шагов: счёт → simulate-status → проверка статуса.

Markdown: https://apipay.kz/guides/integratsiya-apipay-s-pomoshchyu-ii.md

- [Работает ли simulate-status в рабочем режиме?](https://apipay.kz/guides/integratsiya-apipay-s-pomoshchyu-ii#chastye-voprosy)
- [Почему POST /invoices вернул 201, но статус processing?](https://apipay.kz/guides/integratsiya-apipay-s-pomoshchyu-ii#chastye-voprosy)
- [Как отличить X-API-Key от X-Partner-Key?](https://apipay.kz/guides/integratsiya-apipay-s-pomoshchyu-ii#chastye-voprosy)

### [Кассир Kaspi не подключается — почему и что делать?](https://apipay.kz/guides/kassir-ne-podklyuchaetsya)

Почему кассир Kaspi не подключается к ApiPay: лишние роли номера, номер не в «Сотрудниках», код из SMS не успели ввести. Что делать с каждой причиной.

Markdown: https://apipay.kz/guides/kassir-ne-podklyuchaetsya.md

- [Почему Kaspi просит пароль или видеоверификацию при подключении кассира?](https://apipay.kz/guides/kassir-ne-podklyuchaetsya#chastye-voprosy)
- [Kaspi просит ввести ИИН — что это значит?](https://apipay.kz/guides/kassir-ne-podklyuchaetsya#chastye-voprosy)
- [Код из SMS не приходит или не успеваю ввести — что делать?](https://apipay.kz/guides/kassir-ne-podklyuchaetsya#chastye-voprosy)
- [Можно ли один номер кассира подключить к нескольким сервисам?](https://apipay.kz/guides/kassir-ne-podklyuchaetsya#chastye-voprosy)
- [Как сменить номер кассира на другой?](https://apipay.kz/guides/kassir-ne-podklyuchaetsya#chastye-voprosy)

### [KYC клиента через Partner API: ссылка на анкету](https://apipay.kz/guides/kyc-klienta-cherez-partner-api)

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

Markdown: https://apipay.kz/guides/kyc-klienta-cherez-partner-api.md

### [Лимит счетов по тарифу: когда включается ограничение](https://apipay.kz/guides/limit-schetov-po-tarifu)

Сколько счетов в сутки даёт тариф, почему разовое превышение не блокирует, что значит 429 tariff_limit_reached и как снять ограничение.

Markdown: https://apipay.kz/guides/limit-schetov-po-tarifu.md

- [Входят ли в лимит неоплаченные и истёкшие счета?](https://apipay.kz/guides/limit-schetov-po-tarifu#chastye-voprosy)
- [Входит ли в лимит статический QR?](https://apipay.kz/guides/limit-schetov-po-tarifu#chastye-voprosy)
- [Что будет, если я один раз превышу лимит?](https://apipay.kz/guides/limit-schetov-po-tarifu#chastye-voprosy)
- [Как снять ограничение?](https://apipay.kz/guides/limit-schetov-po-tarifu#chastye-voprosy)
- [Влияет ли ограничение на подписки?](https://apipay.kz/guides/limit-schetov-po-tarifu#chastye-voprosy)

### [Как настроить ApiPay за 15 минут — с ИИ или вручную](https://apipay.kz/guides/nastroyka-apipay-za-15-minut)

Настройка ApiPay за ~15 минут: регистрация по WhatsApp, анкета, кассир за 2–3 минуты по SMS, интеграцию пишет ваш ИИ-ассистент. Можно и без кода.

Markdown: https://apipay.kz/guides/nastroyka-apipay-za-15-minut.md

- [Сколько времени занимает настройка ApiPay?](https://apipay.kz/guides/nastroyka-apipay-za-15-minut#voprosy-i-otvety)
- [Обязательно ли уметь программировать?](https://apipay.kz/guides/nastroyka-apipay-za-15-minut#voprosy-i-otvety)
- [Что нужно подготовить до настройки ApiPay?](https://apipay.kz/guides/nastroyka-apipay-za-15-minut#voprosy-i-otvety)
- [Настройка платная?](https://apipay.kz/guides/nastroyka-apipay-za-15-minut#voprosy-i-otvety)
- [Не проходит мастер подключения кассира — что делать?](https://apipay.kz/guides/nastroyka-apipay-za-15-minut#voprosy-i-otvety)

### [Оплатил тариф ApiPay, а он не активировался](https://apipay.kz/guides/oplatil-tarif-ne-aktivirovalsya)

Что делать, если тариф не включился после оплаты: подождать 1–2 минуты, нажать «Проверить статус» в разделе «Мой тариф», посмотреть Историю платежей.

Markdown: https://apipay.kz/guides/oplatil-tarif-ne-aktivirovalsya.md

- [Оплатил тариф ApiPay, а он не активировался — что делать?](https://apipay.kz/guides/oplatil-tarif-ne-aktivirovalsya#chastye-voprosy)
- [Кабинет не находит подтверждённых платежей за тариф — деньги списались?](https://apipay.kz/guides/oplatil-tarif-ne-aktivirovalsya#chastye-voprosy)
- [Оплатил, но тариф не появился — можно оплатить ещё раз?](https://apipay.kz/guides/oplatil-tarif-ne-aktivirovalsya#chastye-voprosy)
- [Оплатил тариф по счёту на организацию — почему он не включился сам?](https://apipay.kz/guides/oplatil-tarif-ne-aktivirovalsya#chastye-voprosy)

### [Чем песочница отличается от рабочего режима в ApiPay?](https://apipay.kz/guides/pesochnitsa-i-rabochiy-rezhim)

Песочница ApiPay бесплатна: счета не уходят в Kaspi, оплату имитируете сами. Как включить рабочий режим, что стирается при переходе и что проверить.

Markdown: https://apipay.kz/guides/pesochnitsa-i-rabochiy-rezhim.md

- [Оплатил тариф, а счета всё ещё SANDBOX-.](https://apipay.kz/guides/pesochnitsa-i-rabochiy-rezhim#voprosy-i-otvety)
- [Идёт ли триал, пока я в песочнице?](https://apipay.kz/guides/pesochnitsa-i-rabochiy-rezhim#voprosy-i-otvety)
- [Нужен ли отдельный API-ключ для песочницы?](https://apipay.kz/guides/pesochnitsa-i-rabochiy-rezhim#voprosy-i-otvety)

### [Как сделать свой сервис на оплатах Kaspi с ИИ: ApiPay и MCP](https://apipay.kz/guides/podklyuchenie-apipay-mcp)

Свой сервис на оплатах Kaspi с ИИ-помощником: дайте ему apipay.kz/for-ai, он напишет код. Счета, статусы, возвраты — через API ApiPay.

Markdown: https://apipay.kz/guides/podklyuchenie-apipay-mcp.md

- [Можно ли на вайбкоде сделать свой сервис аналитики по Kaspi?](https://apipay.kz/guides/podklyuchenie-apipay-mcp#chastye-voprosy)
- [Обязательно ли подключать MCP?](https://apipay.kz/guides/podklyuchenie-apipay-mcp#chastye-voprosy)
- [Нужен ли кассир, чтобы начать?](https://apipay.kz/guides/podklyuchenie-apipay-mcp#chastye-voprosy)
- [Где взять полный справочник API?](https://apipay.kz/guides/podklyuchenie-apipay-mcp#chastye-voprosy)

### [Как подключить свою Kaspi-кассу к ApiPay?](https://apipay.kz/guides/podklyuchenie-kassira-kaspi)

Пошагово: мастер подключения кассира за 2–3 минуты, код из SMS живёт около минуты, 3 правила и что делать при каждой ошибке.

Markdown: https://apipay.kz/guides/podklyuchenie-kassira-kaspi.md

- [У меня несколько точек — можно подключить несколько касс?](https://apipay.kz/guides/podklyuchenie-kassira-kaspi#chastye-voprosy)
- [Можно ли один номер кассира подключить к нескольким партнёрам или сервисам?](https://apipay.kz/guides/podklyuchenie-kassira-kaspi#chastye-voprosy)
- [Почему подключение не проходит — Kaspi просит пароль, видео или ИИН?](https://apipay.kz/guides/podklyuchenie-kassira-kaspi#chastye-voprosy)

### [Перешёл в рабочий режим — не работает: что проверить?](https://apipay.kz/guides/posle-prod-ne-rabotaet)

После перехода в прод счета не уходят, покупателю ничего не приходит, API отвечает 401 или 403? Порядок проверки и решения за 5 минут.

Markdown: https://apipay.kz/guides/posle-prod-ne-rabotaet.md

- [Почему после перехода в рабочий режим оплата всё равно не приходит?](https://apipay.kz/guides/posle-prod-ne-rabotaet#chastye-voprosy)
- [Почему после включения прода перестал работать API-ключ?](https://apipay.kz/guides/posle-prod-ne-rabotaet#chastye-voprosy)
- [Оплатил тариф, а кабинет остался в тестовом режиме — почему?](https://apipay.kz/guides/posle-prod-ne-rabotaet#chastye-voprosy)
- [Ссылка на оплату после перехода в рабочий режим пишет «Тестовый лист» — почему?](https://apipay.kz/guides/posle-prod-ne-rabotaet#chastye-voprosy)
- [Что делать, если переключатель режима не срабатывает?](https://apipay.kz/guides/posle-prod-ne-rabotaet#chastye-voprosy)

### [Кассир уволился или сменился номер — что делать в ApiPay](https://apipay.kz/guides/smena-kassira-nomera-vladeltsa)

Кассир уволился и замены нет, сменился его номер или владелец бизнеса: что нажать в кабинете ApiPay, что сделать в Kaspi Pay и что будет с возвратами.

Markdown: https://apipay.kz/guides/smena-kassira-nomera-vladeltsa.md

- [Кассир уволился — как сменить кассира в ApiPay?](https://apipay.kz/guides/smena-kassira-nomera-vladeltsa#voprosy-i-otvety)
- [Кассир уволился, а замены нет — можно ли работать без кассира?](https://apipay.kz/guides/smena-kassira-nomera-vladeltsa#voprosy-i-otvety)
- [Как убрать уволенного кассира из Kaspi Pay?](https://apipay.kz/guides/smena-kassira-nomera-vladeltsa#voprosy-i-otvety)
- [Что будет с возвратами при смене или отключении кассира?](https://apipay.kz/guides/smena-kassira-nomera-vladeltsa#voprosy-i-otvety)
- [Пропадут ли счета и история при смене кассира?](https://apipay.kz/guides/smena-kassira-nomera-vladeltsa#voprosy-i-otvety)
- [Кассира переподключили тем же номером — нужно что-то выставлять заново?](https://apipay.kz/guides/smena-kassira-nomera-vladeltsa#voprosy-i-otvety)
- [«Сменить кассира» и «Отключить» — в чём разница?](https://apipay.kz/guides/smena-kassira-nomera-vladeltsa#voprosy-i-otvety)
- [Что делать, если сменился личный номер входа в кабинет?](https://apipay.kz/guides/smena-kassira-nomera-vladeltsa#voprosy-i-otvety)
- [Я продал бизнес — как передать аккаунт новому владельцу?](https://apipay.kz/guides/smena-kassira-nomera-vladeltsa#voprosy-i-otvety)

### [Сколько стоит ApiPay и берёт ли он комиссию с платежей?](https://apipay.kz/guides/tarify-i-komissiya-apipay)

Тарифы ApiPay: Старт 10 000 ₸ (30 счетов/день), Бизнес 25 000 ₸ (100), Про 60 000 ₸ (300), Про Макс 90 000 ₸ (600). Фикс, 0% с оборота.

Markdown: https://apipay.kz/guides/tarify-i-komissiya-apipay.md

- [Есть ли скрытые комиссии?](https://apipay.kz/guides/tarify-i-komissiya-apipay#voprosy-i-otvety)
- [Можно ли платить процент с транзакции вместо подписки?](https://apipay.kz/guides/tarify-i-komissiya-apipay#voprosy-i-otvety)
- [У меня несколько организаций — тариф один на всех?](https://apipay.kz/guides/tarify-i-komissiya-apipay#voprosy-i-otvety)
- [Второй кассир входит в тариф?](https://apipay.kz/guides/tarify-i-komissiya-apipay#voprosy-i-otvety)
- [Можно ли сначала попробовать бесплатно?](https://apipay.kz/guides/tarify-i-komissiya-apipay#voprosy-i-otvety)

### [Какой тестовый период у ApiPay и что в него входит?](https://apipay.kz/guides/testovyy-period)

3 бесплатных дня рабочего режима включаются при подключении кассира. До одобрения анкеты боевые счета не выставляются. Песочница бесплатна всегда.

Markdown: https://apipay.kz/guides/testovyy-period.md

- [Нужна ли карта или предоплата для теста?](https://apipay.kz/guides/testovyy-period#voprosy-i-otvety)
- [«Всё настроил, а оплата не приходит»?](https://apipay.kz/guides/testovyy-period#voprosy-i-otvety)
- [Тест даётся один раз?](https://apipay.kz/guides/testovyy-period#voprosy-i-otvety)
- [Если я оплачу тариф на второй день теста, я потеряю день?](https://apipay.kz/guides/testovyy-period#voprosy-i-otvety)

### [Какой номер подходит для кассира Kaspi и почему ваш не прошёл](https://apipay.kz/guides/trebovaniya-k-nomeru-kassira)

Номер кассира для ApiPay — отдельная SIM: один номер у нескольких сервисов не работает. Три условия годного номера и почему Kaspi просит пароль.

Markdown: https://apipay.kz/guides/trebovaniya-k-nomeru-kassira.md

- [Можно ли сделать кассиром номер самого ИП (владельца)?](https://apipay.kz/guides/trebovaniya-k-nomeru-kassira#voprosy-i-otvety)
- [Можно ли номер кассира ApiPay подключить ещё к одному сервису или партнёру?](https://apipay.kz/guides/trebovaniya-k-nomeru-kassira#voprosy-i-otvety)
- [Нужен ли кассиру смартфон?](https://apipay.kz/guides/trebovaniya-k-nomeru-kassira#voprosy-i-otvety)
- [Номер не проходит, хотя условия соблюдены.](https://apipay.kz/guides/trebovaniya-k-nomeru-kassira#voprosy-i-otvety)

## Решение проблем

Что проверить, когда что-то не работает: оплата, кассир, вебхуки, возвраты, счета.

### [Как принимать Kaspi на сайте без Kaspi-магазина?](https://apipay.kz/guides/apipay-dlya-internet-magazina)

Интернет-магазин принимает Kaspi без Магазина на Kaspi.kz: API поверх Kaspi Pay — счёт по номеру или ссылка, статус опросом или вебхуком. Tilda, WordPress.

Markdown: https://apipay.kz/guides/apipay-dlya-internet-magazina.md

- [Нужен ли Kaspi-магазин или регистрация в Kaspi Merchant?](https://apipay.kz/guides/apipay-dlya-internet-magazina#chastye-voprosy)
- [Нужно ли что-то отдельно оформлять под ApiPay — это официальный API Kaspi?](https://apipay.kz/guides/apipay-dlya-internet-magazina#chastye-voprosy)
- [Сколько идёт подтверждение оплаты?](https://apipay.kz/guides/apipay-dlya-internet-magazina#chastye-voprosy)
- [Есть ли плагин Kaspi для Tilda или WordPress?](https://apipay.kz/guides/apipay-dlya-internet-magazina#chastye-voprosy)
- [Что с чеками ОФД?](https://apipay.kz/guides/apipay-dlya-internet-magazina#chastye-voprosy)

### [Как связать свою CRM с Kaspi-оплатами?](https://apipay.kz/guides/apipay-dlya-svoey-crm)

Минимальный контракт: создать счёт по номеру, принять вебхук paid, двигать карточку сделки. Идемпотентность против дублей, отдельные токены на каждую CRM.

Markdown: https://apipay.kz/guides/apipay-dlya-svoey-crm.md

- [У нас нет своего API — CRM только «умеет ходить наружу». Хватит?](https://apipay.kz/guides/apipay-dlya-svoey-crm#chastye-voprosy)

### [Как продавать через Telegram-бота с оплатой Kaspi?](https://apipay.kz/guides/apipay-dlya-telegram-bota-biznes)

Бот выставляет счёт Kaspi через ApiPay — по номеру или ссылкой-кнопкой, выдаёт товар по вебхуку paid. Деньги напрямую на ваш Kaspi-счёт, защита от спама счетов.

Markdown: https://apipay.kz/guides/apipay-dlya-telegram-bota-biznes.md

- [Пользователь должен выходить из Telegram, чтобы оплатить?](https://apipay.kz/guides/apipay-dlya-telegram-bota-biznes#chastye-voprosy)
- [Что если пользователь не оплатил счёт?](https://apipay.kz/guides/apipay-dlya-telegram-bota-biznes#chastye-voprosy)
- [Можно принять оплату без номера телефона покупателя?](https://apipay.kz/guides/apipay-dlya-telegram-bota-biznes#chastye-voprosy)
- [Можно принимать и в Telegram-боте, и в WhatsApp-боте одновременно?](https://apipay.kz/guides/apipay-dlya-telegram-bota-biznes#chastye-voprosy)
- [Сколько это стоит?](https://apipay.kz/guides/apipay-dlya-telegram-bota-biznes#chastye-voprosy)
- [Возвраты бот может делать сам?](https://apipay.kz/guides/apipay-dlya-telegram-bota-biznes#chastye-voprosy)

### [Как вендинговому автомату принимать оплату Kaspi без терминала?](https://apipay.kz/guides/apipay-dlya-vendinga)

Покупатель вводит номер на автомате → счёт в Kaspi → оплата → вебхук → выдача товара. Рабочая схема для сетей вендинговых автоматов с собственным ПО.

Markdown: https://apipay.kz/guides/apipay-dlya-vendinga.md

- [Почему не QR на экране автомата?](https://apipay.kz/guides/apipay-dlya-vendinga#chastye-voprosy)
- [Что если покупатель ввёл чужой/несуществующий номер?](https://apipay.kz/guides/apipay-dlya-vendinga#chastye-voprosy)
- [У меня 5 автоматов на 2 ИП — сколько подключений нужно?](https://apipay.kz/guides/apipay-dlya-vendinga#chastye-voprosy)
- [Можно ли принимать и наличные, и Kaspi?](https://apipay.kz/guides/apipay-dlya-vendinga#chastye-voprosy)

### [Как выставлять Kaspi-счета из 1С через API ApiPay?](https://apipay.kz/guides/integraciya-apipay-s-1c)

Kaspi-счёт из 1С через ApiPay: документ шлёт POST /invoices, оплату 1С узнаёт опросом GET /invoices/{id} (до 1000 в минуту), вебхук — по желанию.

Markdown: https://apipay.kz/guides/integraciya-apipay-s-1c.md

- [Как выставить счёт Kaspi из 1С?](https://apipay.kz/guides/integraciya-apipay-s-1c#chastye-voprosy)
- [Нужен ли вебхук, чтобы 1С узнала об оплате?](https://apipay.kz/guides/integraciya-apipay-s-1c#chastye-voprosy)
- [Есть готовый модуль/обработка для 1С?](https://apipay.kz/guides/integraciya-apipay-s-1c#chastye-voprosy)
- [Почему счёт долго висит в processing?](https://apipay.kz/guides/integraciya-apipay-s-1c#chastye-voprosy)

### [Как принять оплату Kaspi на сайте: виджет или свой код?](https://apipay.kz/guides/kaspi-oplata-na-sayte)

Оплата Kaspi на сайте через ApiPay: виджет widget.js (кнопка + QR) или свой бэкенд со счётом по номеру; статус — опросом или вебхуком. Код Node/Express, Tilda.

Markdown: https://apipay.kz/guides/kaspi-oplata-na-sayte.md

- [Как принять оплату Kaspi на сайте?](https://apipay.kz/guides/kaspi-oplata-na-sayte#voprosy-i-otvety)
- [Что выбрать: виджет или свой бэкенд?](https://apipay.kz/guides/kaspi-oplata-na-sayte#voprosy-i-otvety)
- [Обязателен ли вебхук?](https://apipay.kz/guides/kaspi-oplata-na-sayte#voprosy-i-otvety)
- [Можно ли подключить оплату Kaspi без сервера?](https://apipay.kz/guides/kaspi-oplata-na-sayte#voprosy-i-otvety)
- [Есть ли готовый плагин ApiPay для Tilda или WordPress?](https://apipay.kz/guides/kaspi-oplata-na-sayte#voprosy-i-otvety)

### [Как принимать оплату Kaspi в Telegram-боте?](https://apipay.kz/guides/kaspi-oplata-v-telegram-bote)

Рабочий рецепт: бот выставляет счёт через ApiPay, покупатель платит по push в Kaspi, вебхук подтверждает оплату в чат. Полный код на Python (aiogram) и Node.

Markdown: https://apipay.kz/guides/kaspi-oplata-v-telegram-bote.md

- [Нужен ли собственный сервер?](https://apipay.kz/guides/kaspi-oplata-v-telegram-bote#voprosy-i-otvety)
- [Можно ли не ждать вебхук, а опрашивать статус?](https://apipay.kz/guides/kaspi-oplata-v-telegram-bote#voprosy-i-otvety)
- [Как принимать разные суммы?](https://apipay.kz/guides/kaspi-oplata-v-telegram-bote#voprosy-i-otvety)
- [Подходит ли рецепт для Telegram Mini App?](https://apipay.kz/guides/kaspi-oplata-v-telegram-bote#voprosy-i-otvety)

### [Лимиты и квоты ApiPay: полный справочник](https://apipay.kz/guides/limity-i-kvoty-apipay)

Лимиты ApiPay: запросы, счета, QR, возвраты, тарифы и попытки доставки вебхуков. Что означает HTTP 429 и когда повторять запрос.

Markdown: https://apipay.kz/guides/limity-i-kvoty-apipay.md

- [Какой лимит запросов в минуту у ApiPay?](https://apipay.kz/guides/limity-i-kvoty-apipay#chastye-voprosy)
- [Что значит HTTP 429 и что делать?](https://apipay.kz/guides/limity-i-kvoty-apipay#chastye-voprosy)
- [Сколько попыток даётся вебхуку?](https://apipay.kz/guides/limity-i-kvoty-apipay#chastye-voprosy)

### [Пачка счетов Kaspi массово отменяется или падает — почему?](https://apipay.kz/guides/massovye-otmeny-schetov)

Счета пачкой уходят в error с kaspi_throttled: Kaspi ограничил частоту запросов кассира, автоповторов нет. Паузы, перевыставление, режим накопления.

Markdown: https://apipay.kz/guides/massovye-otmeny-schetov.md

- [Можно ли выставлять большое количество счетов в день?](https://apipay.kz/guides/massovye-otmeny-schetov#chastye-voprosy)
- [Какая частота выставления безопасна?](https://apipay.kz/guides/massovye-otmeny-schetov#chastye-voprosy)

### [Оплата Kaspi не приходит покупателю — что делать?](https://apipay.kz/guides/oplata-ne-prihodit-kaspi)

Продавцу на ApiPay: счёт создан, а покупателю в Kaspi не пришёл. Чаще всего включён тестовый режим или оборвалась авторизация кассира.

Markdown: https://apipay.kz/guides/oplata-ne-prihodit-kaspi.md

- [У меня как у покупателя не списалась оплата в Kaspi — куда обращаться?](https://apipay.kz/guides/oplata-ne-prihodit-kaspi#chastye-voprosy)
- [Счёт создался (ответ 201), но покупателю не пришёл push — почему?](https://apipay.kz/guides/oplata-ne-prihodit-kaspi#chastye-voprosy)
- [Что значит «абонент не найден» при выставлении счёта Kaspi?](https://apipay.kz/guides/oplata-ne-prihodit-kaspi#chastye-voprosy)
- [Не пересоздавать счёт в processing — почему?](https://apipay.kz/guides/oplata-ne-prihodit-kaspi#chastye-voprosy)
- [Как понять, что ошибка временная?](https://apipay.kz/guides/oplata-ne-prihodit-kaspi#chastye-voprosy)

### [Привязка кассира разорвалась — как переподключить за минуту](https://apipay.kz/guides/pochemu-sletala-sessiya-kassira)

Привязка кассира рвётся, если под его номером вошли в Kaspi Pay. Переподключение в кабинете ApiPay — около минуты. Как отвязать кассира и не повторять.

Markdown: https://apipay.kz/guides/pochemu-sletala-sessiya-kassira.md

- [Как понять, что сессия оборвалась?](https://apipay.kz/guides/pochemu-sletala-sessiya-kassira#voprosy-i-otvety)
- [Узнаю ли я об обрыве, или замечу по недовольным клиентам?](https://apipay.kz/guides/pochemu-sletala-sessiya-kassira#voprosy-i-otvety)
- [После переподключения кассира нужно перевыставлять счета?](https://apipay.kz/guides/pochemu-sletala-sessiya-kassira#voprosy-i-otvety)
- [Нужно ли удалять приложение Kaspi с телефона кассира?](https://apipay.kz/guides/pochemu-sletala-sessiya-kassira#voprosy-i-otvety)
- [Как в Kaspi отвязать кассира?](https://apipay.kz/guides/pochemu-sletala-sessiya-kassira#voprosy-i-otvety)

### [Не проходят оплаты: проблема у вас или у Kaspi?](https://apipay.kz/guides/problema-u-vas-ili-u-kaspi)

Для продавцов на ApiPay: три вопроса за 2 минуты — дело в вашей настройке, в сбое на стороне Kaspi или в плановых работах ApiPay.

Markdown: https://apipay.kz/guides/problema-u-vas-ili-u-kaspi.md

- [Как понять, что оплаты не проходят из-за сбоя Kaspi, а не из-за меня?](https://apipay.kz/guides/problema-u-vas-ili-u-kaspi#voprosy-i-otvety)
- [У меня как покупателя не списалась оплата Kaspi — что делать?](https://apipay.kz/guides/problema-u-vas-ili-u-kaspi#voprosy-i-otvety)
- [Потеряются ли оплаты, пока у Kaspi сбой?](https://apipay.kz/guides/problema-u-vas-ili-u-kaspi#voprosy-i-otvety)
- [Что делать прямо сейчас, если у Kaspi сбой?](https://apipay.kz/guides/problema-u-vas-ili-u-kaspi#voprosy-i-otvety)
- [ApiPay предупреждает о плановых работах?](https://apipay.kz/guides/problema-u-vas-ili-u-kaspi#voprosy-i-otvety)

### [Фискальный чек Kaspi для наличных и чужого POS: выбить через API](https://apipay.kz/guides/vybit-fiskalnyy-chek-kaspi)

Наличные и POS другого банка идут мимо Kaspi QR, чек сам не создаётся. Как выбить его в Kaspi OFD через ApiPay и где искать уже пробитый чек.

Markdown: https://apipay.kz/guides/vybit-fiskalnyy-chek-kaspi.md

- [Как выбить чек Kaspi, если платили наличными?](https://apipay.kz/guides/vybit-fiskalnyy-chek-kaspi#chastye-voprosy)
- [Как отбить чек, если оплата была картой другого банка?](https://apipay.kz/guides/vybit-fiskalnyy-chek-kaspi#chastye-voprosy)
- [Как повторно вытащить или распечатать старый чек Kaspi?](https://apipay.kz/guides/vybit-fiskalnyy-chek-kaspi#chastye-voprosy)
- [Как выбить чек в Kaspi для ТОО и ИП?](https://apipay.kz/guides/vybit-fiskalnyy-chek-kaspi#chastye-voprosy)
- [Можно ли отменить или переделать чек?](https://apipay.kz/guides/vybit-fiskalnyy-chek-kaspi#chastye-voprosy)

## Для вашего бизнеса

Как приём Kaspi устроен под ваш сценарий: платформа, бот, сайт, точка, автопарк, школа.

### [Как SaaS-платформе принимать оплату Kaspi за клиентов?](https://apipay.kz/guides/apipay-dlya-platform-i-saas)

Плейбук для платформ и агрегаторов: каждый клиент получает деньги на свой Kaspi-счёт, платформа хранит API-ключи и выставляет счета от их имени.

Markdown: https://apipay.kz/guides/apipay-dlya-platform-i-saas.md

- [Проходят ли деньги через платформу?](https://apipay.kz/guides/apipay-dlya-platform-i-saas#chastye-voprosy)
- [Можно ли использовать номер кассира ApiPay в других сервисах или у других партнёров?](https://apipay.kz/guides/apipay-dlya-platform-i-saas#chastye-voprosy)
- [Сколько это стоит клиентам платформы?](https://apipay.kz/guides/apipay-dlya-platform-i-saas#chastye-voprosy)
- [Что если клиент уйдёт с платформы?](https://apipay.kz/guides/apipay-dlya-platform-i-saas#chastye-voprosy)

### [Как настроить полностью автоматический приём Kaspi для клиентов?](https://apipay.kz/guides/besshovnyy-priyom-kaspi-dlya-klientov-partnyora)

Партнёр ведёт всё через Partner API: клиент только заполняет анкету по ссылке и диктует код из Kaspi-SMS. Счета, тариф и вебхуки — без кабинета ApiPay.

Markdown: https://apipay.kz/guides/besshovnyy-priyom-kaspi-dlya-klientov-partnyora.md

- [Заходит ли клиент в кабинет ApiPay?](https://apipay.kz/guides/besshovnyy-priyom-kaspi-dlya-klientov-partnyora#chastye-voprosy)
- [Как узнать, что тариф по счёту активирован?](https://apipay.kz/guides/besshovnyy-priyom-kaspi-dlya-klientov-partnyora#chastye-voprosy)
- [Куда приходят вебхуки об оплате счетов клиента?](https://apipay.kz/guides/besshovnyy-priyom-kaspi-dlya-klientov-partnyora#chastye-voprosy)

### [Безопасно ли подключать ApiPay и как он устроен?](https://apipay.kz/guides/bezopasnost-i-kak-rabotaet-apipay)

ApiPay — независимый сервис поверх вашего Kaspi Pay: роль «Кассир» без доступа к деньгам, оплата идёт напрямую на ваш Kaspi-счёт. Права кассира, отключение.

Markdown: https://apipay.kz/guides/bezopasnost-i-kak-rabotaet-apipay.md

- [Что за сообщение «хочет дать вам лимит к своему счёту Kaspi Pay»?](https://apipay.kz/guides/bezopasnost-i-kak-rabotaet-apipay#voprosy-i-otvety)
- [Могу ли я сначала попробовать, не подключая реальные деньги?](https://apipay.kz/guides/bezopasnost-i-kak-rabotaet-apipay#voprosy-i-otvety)

### [Интеграция ApiPay с МоимСкладом: гайд для разработчика](https://apipay.kz/guides/integraciya-apipay-s-moyskladom)

Платформа подключает клиентов к приёму Kaspi и держит их подписку актуальной одним PUT. Подпись входящих, инварианты тарифа, журнал, анкета клиента.

Markdown: https://apipay.kz/guides/integraciya-apipay-s-moyskladom.md

### [Как выбрать способ приёма Kaspi из 1С или сайта?](https://apipay.kz/guides/kak-vybrat-sposob-priyoma-kaspi)

Три способа связать Kaspi Pay с 1С или сайтом: вручную, готовый модуль или API-сервис. Таблица сравнения и вопросы, которые задать до подключения.

Markdown: https://apipay.kz/guides/kak-vybrat-sposob-priyoma-kaspi.md

- [Как интегрировать оплату Kaspi и выставление счетов через API?](https://apipay.kz/guides/kak-vybrat-sposob-priyoma-kaspi#chastye-voprosy)
- [Можно ли совмещать ручные счета и API?](https://apipay.kz/guides/kak-vybrat-sposob-priyoma-kaspi#chastye-voprosy)
- [Есть ли у ApiPay готовый модуль для 1С или сайта?](https://apipay.kz/guides/kak-vybrat-sposob-priyoma-kaspi#chastye-voprosy)
- [Берёт ли ApiPay процент с платежей?](https://apipay.kz/guides/kak-vybrat-sposob-priyoma-kaspi#chastye-voprosy)
- [Как сравнить готовый модуль с API-сервисом?](https://apipay.kz/guides/kak-vybrat-sposob-priyoma-kaspi#chastye-voprosy)

### [Kaspi API: заказы магазина или приём оплаты](https://apipay.kz/guides/kaspi-api-zakazy-ili-oplata)

Заказы, товары и остатки Kaspi Магазина отдаёт API самого Kaspi. Приём оплаты Kaspi Pay из сайта, CRM или 1С — это ApiPay. Чем они различаются.

Markdown: https://apipay.kz/guides/kaspi-api-zakazy-ili-oplata.md

- [Есть ли у Kaspi API для получения заказов?](https://apipay.kz/guides/kaspi-api-zakazy-ili-oplata#chastye-voprosy)
- [Kaspi Pay API — это то же самое, что Kaspi Merchant API?](https://apipay.kz/guides/kaspi-api-zakazy-ili-oplata#chastye-voprosy)
- [Как принимать оплату Kaspi на своём сайте, если я не продавец Kaspi Магазина?](https://apipay.kz/guides/kaspi-api-zakazy-ili-oplata#chastye-voprosy)
- [Может ли продавец Kaspi Магазина пользоваться ApiPay?](https://apipay.kz/guides/kaspi-api-zakazy-ili-oplata#chastye-voprosy)

### [Можно ли несколько организаций на один аккаунт ApiPay?](https://apipay.kz/guides/multiorganizatsii-i-partnyoram)

Да: в одном аккаунте несколько организаций, у каждой свой кассир, ключи и тариф. Номер кассира работает только в одной организации. Платформам — Partner API.

Markdown: https://apipay.kz/guides/multiorganizatsii-i-partnyoram.md

- [Можно ли несколько организаций на один аккаунт ApiPay?](https://apipay.kz/guides/multiorganizatsii-i-partnyoram#voprosy-i-otvety)
- [Можно ли один номер кассира на несколько организаций?](https://apipay.kz/guides/multiorganizatsii-i-partnyoram#voprosy-i-otvety)
- [Когда нужна вторая организация, а когда второй кассир?](https://apipay.kz/guides/multiorganizatsii-i-partnyoram#voprosy-i-otvety)
- [Мои клиенты-продавцы должны сами регистрироваться в ApiPay?](https://apipay.kz/guides/multiorganizatsii-i-partnyoram#voprosy-i-otvety)

### [Не могу войти в ApiPay: код не приходит или кабинет пустой?](https://apipay.kz/guides/ne-mogu-voyti-apipay)

Не пускает в кабинет apipay.kz или кабинет пустой? Вход — личным номером регистрации, а не номером кассира. Разбор сообщений экрана входа.

Markdown: https://apipay.kz/guides/ne-mogu-voyti-apipay.md

- [Подтверждение не приходит совсем — что делать?](https://apipay.kz/guides/ne-mogu-voyti-apipay#chastye-voprosy)
- [Меня добавили в организацию, но я её не вижу — почему?](https://apipay.kz/guides/ne-mogu-voyti-apipay#chastye-voprosy)
- [Можно сменить номер входа на другой?](https://apipay.kz/guides/ne-mogu-voyti-apipay#chastye-voprosy)

### [Отчёт по кассовой смене Kaspi: получить в кабинете и по API](https://apipay.kz/guides/otchet-po-kassovoy-smene-kaspi)

Где найти итоги кассовой смены Kaspi: вручную в Kaspi Pay, PDF-отчёт в кабинете ApiPay и по API. Как забирать отчёт за вчера автоматически.

Markdown: https://apipay.kz/guides/otchet-po-kassovoy-smene-kaspi.md

- [Можно получить отчёт по открытой смене?](https://apipay.kz/guides/otchet-po-kassovoy-smene-kaspi#chastye-voprosy)
- [Ссылка перестала открываться — что делать?](https://apipay.kz/guides/otchet-po-kassovoy-smene-kaspi#chastye-voprosy)
- [Нужен ли для отчёта подключённый кассир?](https://apipay.kz/guides/otchet-po-kassovoy-smene-kaspi#chastye-voprosy)
- [Как посмотреть чеки, пробитые в Kaspi Pos?](https://apipay.kz/guides/otchet-po-kassovoy-smene-kaspi#chastye-voprosy)

### [Как встроить приём Kaspi в свой продукт через Partner API?](https://apipay.kz/guides/partner-api-white-label)

ApiPay Partner API — не API Kaspi: платформа подключает клиентов к приёму Kaspi Pay. Ключ X-Partner-Key держит их организации, деньги идут на их Kaspi-счёт.

Markdown: https://apipay.kz/guides/partner-api-white-label.md

- [Kaspi partner API и ApiPay Partner API — одно и то же?](https://apipay.kz/guides/partner-api-white-label#chastye-voprosy)
- [Куда идут деньги покупателей при встройке через Partner API?](https://apipay.kz/guides/partner-api-white-label#chastye-voprosy)
- [Нужен ли мерчанту свой аккаунт ApiPay?](https://apipay.kz/guides/partner-api-white-label#chastye-voprosy)
- [Каким секретом проверять подпись вебхука?](https://apipay.kz/guides/partner-api-white-label#chastye-voprosy)

### [Как партнёру подключить организацию мерчанта к ApiPay?](https://apipay.kz/guides/partner-connect-organization)

Partner API: создать организацию клиента, выдать ссылку на анкету, подключить кассира по SMS-коду, выдать X-API-Key. Что нужно от мерчанта, песочница.

Markdown: https://apipay.kz/guides/partner-connect-organization.md

- [Что нужно от мерчанта, чтобы подключить его через Partner API?](https://apipay.kz/guides/partner-connect-organization#chastye-voprosy)
- [Может ли партнёр заполнить анкету о бизнесе за клиента?](https://apipay.kz/guides/partner-connect-organization#chastye-voprosy)
- [Можно ли один номер кассира дать нескольким партнёрам или сервисам?](https://apipay.kz/guides/partner-connect-organization#chastye-voprosy)
- [Куда идут деньги покупателей мерчанта?](https://apipay.kz/guides/partner-connect-organization#chastye-voprosy)
- [Чем X-Partner-Key отличается от X-API-Key?](https://apipay.kz/guides/partner-connect-organization#chastye-voprosy)

### [Словарь ApiPay: термины простыми словами](https://apipay.kz/guides/slovar-apipay)

Что такое кассир, API-ключ, вебхук, песочница, счёт по номеру, оплата по ссылке и статический QR — 22 термина ApiPay простыми словами, с примерами.

Markdown: https://apipay.kz/guides/slovar-apipay.md

- [Что такое кассир в Kaspi Pay?](https://apipay.kz/guides/slovar-apipay#chastye-voprosy)
- [Чем кассир отличается от менеджера?](https://apipay.kz/guides/slovar-apipay#chastye-voprosy)
- [Чем API-ключ отличается от вебхук-секрета?](https://apipay.kz/guides/slovar-apipay#chastye-voprosy)

### [Что где находится в кабинете ApiPay](https://apipay.kz/guides/tur-po-kabinetu-apipay)

Экскурсия по кабинету ApiPay: Счета с экспортом и фильтрами, Настройки с ключами и логом уведомлений, Мой тариф, переключатель организаций, встроенные гид-туры.

Markdown: https://apipay.kz/guides/tur-po-kabinetu-apipay.md

- [Почему я не вижу вкладку «Лог уведомлений»?](https://apipay.kz/guides/tur-po-kabinetu-apipay#voprosy-i-otvety)
- [Где взять API-ключ?](https://apipay.kz/guides/tur-po-kabinetu-apipay#voprosy-i-otvety)
- [Можно ли вести несколько бизнесов в одном кабинете?](https://apipay.kz/guides/tur-po-kabinetu-apipay#voprosy-i-otvety)

### [Как войти в кабинет ApiPay, если нет логина и пароля?](https://apipay.kz/guides/vhod-v-kabinet-apipay)

Вход на apipay.kz — по личному номеру через WhatsApp: кнопка «Подтвердить» или код на 5 минут. Чек-лист «код не пришёл», лимиты запросов и доступ для команды.

Markdown: https://apipay.kz/guides/vhod-v-kabinet-apipay.md

- [Сообщение пришло от «BayPay» — это точно вы?](https://apipay.kz/guides/vhod-v-kabinet-apipay#voprosy-i-otvety)
- [Как дать доступ бухгалтеру или разработчику?](https://apipay.kz/guides/vhod-v-kabinet-apipay#voprosy-i-otvety)
- [Я сменил номер телефона — как попасть в кабинет?](https://apipay.kz/guides/vhod-v-kabinet-apipay#voprosy-i-otvety)

## Справочник

Технические детали для разработчиков: счета, вебхуки, возвраты, подписки, лимиты, термины.

### [API-ключ и вебхук-секрет ApiPay: в чём разница?](https://apipay.kz/guides/api-klyuch-i-webhook-secret)

API-ключ (X-API-Key) авторизует ваши запросы; вебхук-секрет только проверяет подпись входящих вебхуков. Где взять, когда перегенерируются, почему «пропадают».

Markdown: https://apipay.kz/guides/api-klyuch-i-webhook-secret.md

- [Обязателен ли вебхук-секрет?](https://apipay.kz/guides/api-klyuch-i-webhook-secret#voprosy-i-otvety)
- [Можно ли иметь несколько API-ключей?](https://apipay.kz/guides/api-klyuch-i-webhook-secret#voprosy-i-otvety)
- [Чем отличается партнёрский ключ?](https://apipay.kz/guides/api-klyuch-i-webhook-secret#voprosy-i-otvety)

### [Как автошколе или онлайн-школе принимать оплату Kaspi?](https://apipay.kz/guides/apipay-dlya-avtoshkoly-i-obrazovaniya)

Плейбук для автошкол и курсов: счета из кабинета без кода, подписки как авто-выставление (не автосписание), статический QR под сделку.

Markdown: https://apipay.kz/guides/apipay-dlya-avtoshkoly-i-obrazovaniya.md

- [Нужен ли программист, чтобы начать?](https://apipay.kz/guides/apipay-dlya-avtoshkoly-i-obrazovaniya#chastye-voprosy)
- [Сколько стоит для школы на 100–300 учеников?](https://apipay.kz/guides/apipay-dlya-avtoshkoly-i-obrazovaniya#chastye-voprosy)
- [Можно ли настроить автоплатёж Kaspi для учеников или B2B-клиентов?](https://apipay.kz/guides/apipay-dlya-avtoshkoly-i-obrazovaniya#chastye-voprosy)

### [Как принимать Kaspi QR на офлайн-точке через ApiPay?](https://apipay.kz/guides/apipay-dlya-oflayn-tochki-qr)

Кассир показывает динамический QR на экране, покупатель сканирует и платит. Окно на скан — меньше трёх минут. Когда QR, а когда счёт по номеру.

Markdown: https://apipay.kz/guides/apipay-dlya-oflayn-tochki-qr.md

- [Можно ли распечатать QR и повесить у кассы?](https://apipay.kz/guides/apipay-dlya-oflayn-tochki-qr#chastye-voprosy)
- [Нужен ли точке сайт или онлайн-касса?](https://apipay.kz/guides/apipay-dlya-oflayn-tochki-qr#chastye-voprosy)
- [Как понять, что покупатель оплатил?](https://apipay.kz/guides/apipay-dlya-oflayn-tochki-qr#chastye-voprosy)
- [Что если покупатель отсканировал, но передумал?](https://apipay.kz/guides/apipay-dlya-oflayn-tochki-qr#chastye-voprosy)
- [Берёт ли ApiPay процент с оплат на точке?](https://apipay.kz/guides/apipay-dlya-oflayn-tochki-qr#chastye-voprosy)

### [Как таксопарку выставлять сотни счетов Kaspi водителям?](https://apipay.kz/guides/apipay-dlya-taksoparka-i-billinga)

Плейбук массового биллинга: счета водителям по спискам, идемпотентность против дублей, контракт bulk-выставления и разбор ошибок по позициям.

Markdown: https://apipay.kz/guides/apipay-dlya-taksoparka-i-billinga.md

- [Можно ли спокойно выставлять сотни счетов в день?](https://apipay.kz/guides/apipay-dlya-taksoparka-i-billinga#chastye-voprosy)
- [Нужна ли заявка на официальное партнёрство Kaspi?](https://apipay.kz/guides/apipay-dlya-taksoparka-i-billinga#chastye-voprosy)
- [Водители без Kaspi есть — что с ними?](https://apipay.kz/guides/apipay-dlya-taksoparka-i-billinga#chastye-voprosy)

### [Автозакрытие кассовой смены Kaspi: как включить](https://apipay.kz/guides/avtozakrytie-kassovoy-smeny-kaspi)

Тумблер автозакрытия смены в кабинете ApiPay, закрытие через API с поллингом операции и вебхуки cashbox.shift_closed и cashbox.shift_close_failed.

Markdown: https://apipay.kz/guides/avtozakrytie-kassovoy-smeny-kaspi.md

- [Автозакрытие заменяет ручное закрытие полностью?](https://apipay.kz/guides/avtozakrytie-kassovoy-smeny-kaspi#chastye-voprosy)
- [Повлияет ли автозакрытие на фискальные чеки?](https://apipay.kz/guides/avtozakrytie-kassovoy-smeny-kaspi#chastye-voprosy)
- [Почему тумблер показывает «Значение из Kaspi ещё не получено»?](https://apipay.kz/guides/avtozakrytie-kassovoy-smeny-kaspi#chastye-voprosy)
- [Смена закрылась — где найти её итоги и отчёт?](https://apipay.kz/guides/avtozakrytie-kassovoy-smeny-kaspi#chastye-voprosy)

### [Чек-лист безопасности интеграции ApiPay: 12 пунктов](https://apipay.kz/guides/bezopasnost-integratsii-cheklist)

12 проверок безопасности интеграции ApiPay: API-ключ только на сервере, подпись вебхука по raw body, что делать при утечке ключа, ротация секретов.

Markdown: https://apipay.kz/guides/bezopasnost-integratsii-cheklist.md

- [Смена API-ключа меняет секрет подписи вебхука?](https://apipay.kz/guides/bezopasnost-integratsii-cheklist#voprosy-i-otvety)
- [Можно ли восстановить потерянный ключ или секрет?](https://apipay.kz/guides/bezopasnost-integratsii-cheklist#voprosy-i-otvety)

### [Что видит покупатель при оплате счёта через ApiPay?](https://apipay.kz/guides/chto-vidit-pokupatel)

Путь покупателя: счёт приходит в приложение Kaspi, оплата в пару касаний. Счёт живёт 24 часа, окно на скан QR — меньше трёх минут.

Markdown: https://apipay.kz/guides/chto-vidit-pokupatel.md

- [Что если у клиента нет Kaspi?](https://apipay.kz/guides/chto-vidit-pokupatel#voprosy-i-otvety)
- [Клиент говорит «мне ничего не пришло». Что делать?](https://apipay.kz/guides/chto-vidit-pokupatel#voprosy-i-otvety)
- [Может ли клиент оплатить частично или поторговаться в приложении?](https://apipay.kz/guides/chto-vidit-pokupatel#voprosy-i-otvety)

### [Как импортировать платежи Kaspi Pay в 1С](https://apipay.kz/guides/import-platezhey-kaspi-pay-v-1c)

Ручная выгрузка операций Kaspi Pay в 1С — и путь без файлов: счёт из 1С через POST /invoices, статус оплаты 1С забирает опросом GET /invoices/{id} или вебхуком.

Markdown: https://apipay.kz/guides/import-platezhey-kaspi-pay-v-1c.md

- [Как импортировать платежи из Kaspi Pay в 1С?](https://apipay.kz/guides/import-platezhey-kaspi-pay-v-1c#chastye-voprosy)
- [Есть готовый файл импорта платежей Kaspi для 1С?](https://apipay.kz/guides/import-platezhey-kaspi-pay-v-1c#chastye-voprosy)
- [Можно ли получать оплату в 1С сразу, без выгрузки файла?](https://apipay.kz/guides/import-platezhey-kaspi-pay-v-1c#chastye-voprosy)
- [Как понять, к какому заказу относится платёж?](https://apipay.kz/guides/import-platezhey-kaspi-pay-v-1c#chastye-voprosy)

### [Как создать счёт Kaspi по номеру телефона через API?](https://apipay.kz/guides/kak-sozdat-schet-kaspi-po-nomeru)

Один POST-запрос — и покупатель получает push в Kaspi. Счёт живёт 24 часа, оплата видна за 10–30 секунд. Статусы, идемпотентность, «странные» переходы.

Markdown: https://apipay.kz/guides/kak-sozdat-schet-kaspi-po-nomeru.md

- [Что будет, если у покупателя нет Kaspi?](https://apipay.kz/guides/kak-sozdat-schet-kaspi-po-nomeru#voprosy-i-otvety)
- [Можно ли отменить выставленный счёт?](https://apipay.kz/guides/kak-sozdat-schet-kaspi-po-nomeru#voprosy-i-otvety)
- [Почему сумма с копейками не проходит?](https://apipay.kz/guides/kak-sozdat-schet-kaspi-po-nomeru#voprosy-i-otvety)
- [Оплата не приходит — что проверить?](https://apipay.kz/guides/kak-sozdat-schet-kaspi-po-nomeru#voprosy-i-otvety)

### [Как выбить фискальный чек Kaspi из кабинета ApiPay](https://apipay.kz/guides/kak-vybit-chek-v-kabinete-apipay)

Пошагово для продавца: как выбить фискальный чек Kaspi OFD из кабинета ApiPay при оплате наличными или через POS другого банка. Без кода, простыми словами.

Markdown: https://apipay.kz/guides/kak-vybit-chek-v-kabinete-apipay.md

### [Какой QR выбрать: QR-счёт или статический QR](https://apipay.kz/guides/kakoy-qr-vybrat-qr-schet-ili-staticheskiy)

QR-счёт — только когда клиент платит сразу. Заплатит позже — статический QR или ссылка на оплату: счёт появится, только когда клиент нажмёт «Оплатить».

Markdown: https://apipay.kz/guides/kakoy-qr-vybrat-qr-schet-ili-staticheskiy.md

- [Клиент не успел оплатить QR-счёт. Создать новый?](https://apipay.kz/guides/kakoy-qr-vybrat-qr-schet-ili-staticheskiy#chastye-voprosy)
- [Входит ли истёкший QR-счёт в лимит тарифа?](https://apipay.kz/guides/kakoy-qr-vybrat-qr-schet-ili-staticheskiy#chastye-voprosy)
- [Тратит ли статический QR лимит, пока лежит у клиента?](https://apipay.kz/guides/kakoy-qr-vybrat-qr-schet-ili-staticheskiy#chastye-voprosy)
- [Статический QR создан через API. Сколько мест в лимите он займёт?](https://apipay.kz/guides/kakoy-qr-vybrat-qr-schet-ili-staticheskiy#chastye-voprosy)
- [Чем ссылка на оплату отличается от статического QR?](https://apipay.kz/guides/kakoy-qr-vybrat-qr-schet-ili-staticheskiy#chastye-voprosy)
- [Открытие ссылки в мессенджере создаёт счёт?](https://apipay.kz/guides/kakoy-qr-vybrat-qr-schet-ili-staticheskiy#chastye-voprosy)

### [Каталог для 1С в ApiPay: синхронизация без дублей](https://apipay.kz/guides/katalog-dlya-integratorov-1c)

Плейбук синка каталога из 1С в ApiPay: external_ref как ключ маппинга, match-and-merge, идемпотентность, подтверждение вебхуком и чтением, полная синхронизация.

Markdown: https://apipay.kz/guides/katalog-dlya-integratorov-1c.md

- [По какому полю маппить товары между 1С и ApiPay?](https://apipay.kz/guides/katalog-dlya-integratorov-1c#chastye-voprosy)
- [Пришёл matched_existing: true с name_differs: true — что делать?](https://apipay.kz/guides/katalog-dlya-integratorov-1c#chastye-voprosy)
- [Как отметить у себя, что заливка закончилась?](https://apipay.kz/guides/katalog-dlya-integratorov-1c#chastye-voprosy)
- [Да.](https://apipay.kz/guides/katalog-dlya-integratorov-1c#chastye-voprosy)
- [А вот status: failed с operation: create — нет:](https://apipay.kz/guides/katalog-dlya-integratorov-1c#chastye-voprosy)

### [Каталог, корзина и Нацкаталог (ntin/gtin) в ApiPay](https://apipay.kz/guides/katalog-korzina-nackatalog)

Товары через POST /catalog (пачка 1–100), продажа корзиной cart_items, скан штрихкода в Нацкаталоге (ntin/gtin), чтение каталога в 4 режимах для синхронизации.

Markdown: https://apipay.kz/guides/katalog-korzina-nackatalog.md

- [Как привязать НТИН к товару для чека Kaspi?](https://apipay.kz/guides/katalog-korzina-nackatalog#chastye-voprosy)
- [Где взять catalog_item_id для корзины?](https://apipay.kz/guides/katalog-korzina-nackatalog#chastye-voprosy)

### [Массовая заливка каталога 1С в ApiPay: очередь, ETA, ошибки](https://apipay.kz/guides/massovaya-zagruzka-kataloga-iz-1c)

Плейбук массовой заливки каталога из 1С: пачки по 100 с Idempotency-Key, остаток очереди с ETA, сверка по external_ref и разбор отказов.

Markdown: https://apipay.kz/guides/massovaya-zagruzka-kataloga-iz-1c.md

- [Зачем нужен Idempotency-Key, если каталог и так идемпотентен?](https://apipay.kz/guides/massovaya-zagruzka-kataloga-iz-1c#chastye-voprosy)
- [Придёт ли вебхук catalog.item_processed при массовой заливке?](https://apipay.kz/guides/massovaya-zagruzka-kataloga-iz-1c#chastye-voprosy)
- [Как узнать, что заливка закончилась?](https://apipay.kz/guides/massovaya-zagruzka-kataloga-iz-1c#chastye-voprosy)

### [Как настроить вебхуки ApiPay и проверить подпись?](https://apipay.kz/guides/nastroyka-webhookov-apipay)

Уведомления об оплате Kaspi Pay на ваш сервер: адрес, секрет, проверка HMAC по raw body (X-Webhook-Signature), повторы доставки и когда хватит опроса.

Markdown: https://apipay.kz/guides/nastroyka-webhookov-apipay.md

- [Как проверить подпись вебхука ApiPay?](https://apipay.kz/guides/nastroyka-webhookov-apipay#voprosy-i-otvety)
- [Почему подпись вебхука не сходится?](https://apipay.kz/guides/nastroyka-webhookov-apipay#voprosy-i-otvety)
- [Куда приходят вебхуки, если ключей несколько?](https://apipay.kz/guides/nastroyka-webhookov-apipay#voprosy-i-otvety)
- [Как проверить, дошёл ли вебхук?](https://apipay.kz/guides/nastroyka-webhookov-apipay#voprosy-i-otvety)

### [Оплата Kaspi по ссылке: как отправить покупателю ссылку](https://apipay.kz/guides/oplata-po-ssylke-kaspi)

Ссылка на оплату Kaspi через ApiPay — поле payment_url: отправьте в WhatsApp, счёт появится по кнопке «Оплатить». Платит сейчас — хватит QR-счёта.

Markdown: https://apipay.kz/guides/oplata-po-ssylke-kaspi.md

- [Как дать ссылку на оплату Kaspi?](https://apipay.kz/guides/oplata-po-ssylke-kaspi#voprosy-i-otvety)
- [Можно ли отправить ссылку на оплату Kaspi в WhatsApp?](https://apipay.kz/guides/oplata-po-ssylke-kaspi#voprosy-i-otvety)
- [Сколько живёт ссылка на оплату?](https://apipay.kz/guides/oplata-po-ssylke-kaspi#voprosy-i-otvety)
- [Чем ссылка на оплату отличается от QR-счёта?](https://apipay.kz/guides/oplata-po-ssylke-kaspi#voprosy-i-otvety)
- [Ссылку создали в песочнице — заработает ли она после перехода в рабочий режим?](https://apipay.kz/guides/oplata-po-ssylke-kaspi#voprosy-i-otvety)
- [Нужен ли номер телефона покупателя?](https://apipay.kz/guides/oplata-po-ssylke-kaspi#voprosy-i-otvety)
- [Как понять, что по ссылке заплатили?](https://apipay.kz/guides/oplata-po-ssylke-kaspi#voprosy-i-otvety)
- [Можно ли отменить ссылку, если покупатель передумал?](https://apipay.kz/guides/oplata-po-ssylke-kaspi#voprosy-i-otvety)

### [Ошибка 422 cart_items — как исправить счёт с корзиной?](https://apipay.kz/guides/oshibka-422-cart-items)

422 requires cart items или has no price set? QR-счёт у организации с каталогом принимается только с корзиной. Что делать по каждой ошибке.

Markdown: https://apipay.kz/guides/oshibka-422-cart-items.md

- [Обязательно заводить все товары в каталог?](https://apipay.kz/guides/oshibka-422-cart-items#chastye-voprosy)
- [Можно ли дать на QR-счёте скидку 7,5 %?](https://apipay.kz/guides/oshibka-422-cart-items#chastye-voprosy)

### [Статический QR для оплаты по счёту или сделке](https://apipay.kz/guides/pechatnyy-qr-dlya-oplaty-po-sdelke)

Статический QR ApiPay под сделку: покупатель наводит камеру и платит в Kaspi. Лист работает до оплаты или отключения, print_url можно отправить в мессенджер.

Markdown: https://apipay.kz/guides/pechatnyy-qr-dlya-oplaty-po-sdelke.md

- [Сколько живёт напечатанный лист?](https://apipay.kz/guides/pechatnyy-qr-dlya-oplaty-po-sdelke#chastye-voprosy)
- [Что если камера совсем не берёт код?](https://apipay.kz/guides/pechatnyy-qr-dlya-oplaty-po-sdelke#chastye-voprosy)
- [Что если кассир отключился?](https://apipay.kz/guides/pechatnyy-qr-dlya-oplaty-po-sdelke#chastye-voprosy)
- [Как я узнаю, что по листу заплатили?](https://apipay.kz/guides/pechatnyy-qr-dlya-oplaty-po-sdelke#chastye-voprosy)
- [Можно ли сделать скидку на листе?](https://apipay.kz/guides/pechatnyy-qr-dlya-oplaty-po-sdelke#chastye-voprosy)
- [Работает ли лист без интернета у покупателя?](https://apipay.kz/guides/pechatnyy-qr-dlya-oplaty-po-sdelke#chastye-voprosy)

### [Переход на каталог товаров в ApiPay: порядок и что поменять](https://apipay.kz/guides/perehod-na-katalog-tovarov)

Что меняется при включении каталога: состав покупки в чеке, cart_items на QR-счетах, статические QR. Порядок: сначала интеграция, потом включение.

Markdown: https://apipay.kz/guides/perehod-na-katalog-tovarov.md

- [Мои счета на номер телефона перестанут работать?](https://apipay.kz/guides/perehod-na-katalog-tovarov#chastye-voprosy)
- [Можно включить каталог самому в кабинете?](https://apipay.kz/guides/perehod-na-katalog-tovarov#chastye-voprosy)
- [Как отличить эти отказы в коде?](https://apipay.kz/guides/perehod-na-katalog-tovarov#chastye-voprosy)
- [Что с суммами и копейками?](https://apipay.kz/guides/perehod-na-katalog-tovarov#chastye-voprosy)
- [Товара нет в каталоге, что делать?](https://apipay.kz/guides/perehod-na-katalog-tovarov#chastye-voprosy)

### [Подписки ApiPay: есть ли автосписание с покупателя?](https://apipay.kz/guides/podpiski-apipay)

Нет: подписка ApiPay — авто-выставление счёта Kaspi по расписанию, оплату покупатель подтверждает сам. Два режима неоплаты, grace, события subscription.*.

Markdown: https://apipay.kz/guides/podpiski-apipay.md

- [Почему в подписке нет автосписания?](https://apipay.kz/guides/podpiski-apipay#voprosy-i-otvety)
- [Можно ли изменить сумму действующей подписки?](https://apipay.kz/guides/podpiski-apipay#voprosy-i-otvety)
- [Во сколько покупателю приходит счёт по подписке?](https://apipay.kz/guides/podpiski-apipay#voprosy-i-otvety)
- [Можно ли подставить в описание счёта дату или месяц?](https://apipay.kz/guides/podpiski-apipay#voprosy-i-otvety)
- [Подписка истекла (expired) — я потеряю историю?](https://apipay.kz/guides/podpiski-apipay#voprosy-i-otvety)
- [Покупатель заплатил наличными — как не выставлять ему счёт за этот период?](https://apipay.kz/guides/podpiski-apipay#voprosy-i-otvety)

### [QR Kaspi показывает «Попробуйте позже» — что делать?](https://apipay.kz/guides/qr-poprobuyte-pozzhe)

Продавцу на ApiPay: «Попробуйте позже» на QR-счёте почти всегда значит, что QR истёк — окно на скан меньше трёх минут. Создайте новый QR перед оплатой.

Markdown: https://apipay.kz/guides/qr-poprobuyte-pozzhe.md

- [Почему покупатель видит «Попробуйте позже» при сканировании QR Kaspi?](https://apipay.kz/guides/qr-poprobuyte-pozzhe#chastye-voprosy)
- [Покупатель увидел «Попробуйте позже» — счёт пропал?](https://apipay.kz/guides/qr-poprobuyte-pozzhe#chastye-voprosy)
- [Почему не создаётся QR-счёт?](https://apipay.kz/guides/qr-poprobuyte-pozzhe#chastye-voprosy)
- [QR отменился сам — это сбой?](https://apipay.kz/guides/qr-poprobuyte-pozzhe#chastye-voprosy)

### [Сколько живёт QR-счёт Kaspi и что это меняет?](https://apipay.kz/guides/qr-schet-ttl-i-limity)

QR-счёт Kaspi через ApiPay живёт меньше трёх минут (qr_expires_at), продления нет. Только для оплаты сразу: QR на кассе или ссылка qr_token_url.

Markdown: https://apipay.kz/guides/qr-schet-ttl-i-limity.md

- [Сколько действует QR-счёт Kaspi?](https://apipay.kz/guides/qr-schet-ttl-i-limity#voprosy-i-otvety)
- [Как дать покупателю ссылку на оплату Kaspi?](https://apipay.kz/guides/qr-schet-ttl-i-limity#voprosy-i-otvety)
- [Как создать QR-счёт, если у организации подключён каталог?](https://apipay.kz/guides/qr-schet-ttl-i-limity#voprosy-i-otvety)

### [Как разделить счета по точкам в одной организации ApiPay?](https://apipay.kz/guides/razdelnaya-otchetnost-po-tochkam)

Метка точки в номере заказа или заметке и поиск по ней: список, сводка и выгрузка по точке. Свой API-ключ — свои вебхуки. Деньги и тариф — общие.

Markdown: https://apipay.kz/guides/razdelnaya-otchetnost-po-tochkam.md

- [Как посмотреть оборот одной точки за месяц?](https://apipay.kz/guides/razdelnaya-otchetnost-po-tochkam#chastye-voprosy)
- [Можно ли выгрузить в Excel счета одной точки?](https://apipay.kz/guides/razdelnaya-otchetnost-po-tochkam#chastye-voprosy)
- [Нужен ли отдельный API-ключ на каждую точку?](https://apipay.kz/guides/razdelnaya-otchetnost-po-tochkam#chastye-voprosy)
- [Можно ли разделить деньги по точкам?](https://apipay.kz/guides/razdelnaya-otchetnost-po-tochkam#chastye-voprosy)

### [Счета дублируются или создаются сами — как остановить?](https://apipay.kz/guides/scheta-dubliruyutsya)

Покупатель получил два счёта, CRM льёт счета потоком? Экстренная остановка: удалите API-ключи — интеграция отключится мгновенно. Затем идемпотентность.

Markdown: https://apipay.kz/guides/scheta-dubliruyutsya.md

- [Покупатель оплатил оба дубля — что делать?](https://apipay.kz/guides/scheta-dubliruyutsya#chastye-voprosy)
- [Мой order_id длиннее 191 символа — как быть?](https://apipay.kz/guides/scheta-dubliruyutsya#chastye-voprosy)

### [Счета с корзиной (cart_items): как исправить ошибку 422?](https://apipay.kz/guides/scheta-s-korzinoy-cart-items-ofd)

Ошибка 422 про cart_items: каталог требует корзину или организация без каталога её не принимает. Схема корзины, цена позиции, скидка и чек-лист.

Markdown: https://apipay.kz/guides/scheta-s-korzinoy-cart-items-ofd.md

- [Влияет ли корзина на возвраты?](https://apipay.kz/guides/scheta-s-korzinoy-cart-items-ofd#voprosy-i-otvety)
- [Почему на QR-счёте скидка больше заявленной?](https://apipay.kz/guides/scheta-s-korzinoy-cart-items-ofd#voprosy-i-otvety)

### [Сверка кассы Kaspi со счетами ApiPay: что показывают обе цифры](https://apipay.kz/guides/sverka-kassy-so-schetami-apipay)

GET /cashbox/reconciliation по смене: наши оплаченные счета рядом с итогом кассы Kaspi и структурные причины, по которым цифры не обязаны совпадать.

Markdown: https://apipay.kz/guides/sverka-kassy-so-schetami-apipay.md

- [Почему сверка не говорит «всё сошлось»?](https://apipay.kz/guides/sverka-kassy-so-schetami-apipay#chastye-voprosy)
- [Можно сверить сразу за день, а не за смену?](https://apipay.kz/guides/sverka-kassy-so-schetami-apipay#chastye-voprosy)
- [Где посмотреть итоги по кассовой смене?](https://apipay.kz/guides/sverka-kassy-so-schetami-apipay#chastye-voprosy)
- [Возвраты попадают в сверку?](https://apipay.kz/guides/sverka-kassy-so-schetami-apipay#chastye-voprosy)

### [Как выставить удалённый счёт в Kaspi Pay](https://apipay.kz/guides/udalyonnyy-schet-kaspi-pay)

Удалённый счёт — это счёт по номеру телефона покупателя. Руками его выставляют в приложении Kaspi Pay, автоматически — запросом POST /invoices в ApiPay.

Markdown: https://apipay.kz/guides/udalyonnyy-schet-kaspi-pay.md

- [Что такое удалённый счёт в Kaspi Pay?](https://apipay.kz/guides/udalyonnyy-schet-kaspi-pay#chastye-voprosy)
- [Сколько ждёт удалённый счёт, если покупатель не оплатил?](https://apipay.kz/guides/udalyonnyy-schet-kaspi-pay#chastye-voprosy)
- [Как дать покупателю ссылку на оплату Kaspi?](https://apipay.kz/guides/udalyonnyy-schet-kaspi-pay#chastye-voprosy)
- [Можно ли выставлять удалённые счета автоматически из CRM или с сайта?](https://apipay.kz/guides/udalyonnyy-schet-kaspi-pay#chastye-voprosy)

### [Возврат Kaspi не проходит — в чём причина?](https://apipay.kz/guides/vozvrat-ne-prohodit)

Для продавца: возврат покупателю в Kaspi Pay не проходит. Чаще всего на Kaspi-счёте не хватает денег или прошёл срок возврата. Что проверить и что делать.

Markdown: https://apipay.kz/guides/vozvrat-ne-prohodit.md

- [Почему не проходит возврат в Kaspi Pay?](https://apipay.kz/guides/vozvrat-ne-prohodit#voprosy-i-otvety)
- [Как сделать возврат клиенту, если он платил через Kaspi Pay (ТОО или ИП)?](https://apipay.kz/guides/vozvrat-ne-prohodit#voprosy-i-otvety)
- [Какой срок возврата у Kaspi?](https://apipay.kz/guides/vozvrat-ne-prohodit#voprosy-i-otvety)
- [Возврат создан, но деньги не вернулись — что делать?](https://apipay.kz/guides/vozvrat-ne-prohodit#voprosy-i-otvety)
- [Я покупатель — как вернуть деньги после покупки в Kaspi?](https://apipay.kz/guides/vozvrat-ne-prohodit#voprosy-i-otvety)

### [Возврат по QR: покупатель подтверждает возврат в Kaspi](https://apipay.kz/guides/vozvrat-po-qr-cherez-api)

Возврат с подтверждением покупателя: ссылка ждёт его 24 часа, он подтверждает возврат в своём Kaspi, вы возвращаете покупку. Ссылка под счёт, коды, песочница.

Markdown: https://apipay.kz/guides/vozvrat-po-qr-cherez-api.md

- [Как в Kaspi сделать возврат, если покупатель платил удалённо?](https://apipay.kz/guides/vozvrat-po-qr-cherez-api#chastye-voprosy)
- [Можно вернуть несколько покупок за одну сессию?](https://apipay.kz/guides/vozvrat-po-qr-cherez-api#chastye-voprosy)
- [Что делать, если execute ответил 202?](https://apipay.kz/guides/vozvrat-po-qr-cherez-api#chastye-voprosy)
- [Приходят ли вебхуки?](https://apipay.kz/guides/vozvrat-po-qr-cherez-api#chastye-voprosy)

### [Как сделать возврат Kaspi через API и почему он не проходит?](https://apipay.kz/guides/vozvraty-kaspi-cherez-api)

Возврат клиенту по оплате Kaspi Pay: кабинет ApiPay или POST /invoices/{id}/refund, итог — вебхук invoice.refunded. Частичный возврат, отказы, ссылка-возврат.

Markdown: https://apipay.kz/guides/vozvraty-kaspi-cherez-api.md

- [Я покупатель и хочу вернуть деньги за покупку в Kaspi Магазине или после экспертизы — это сюда?](https://apipay.kz/guides/vozvraty-kaspi-cherez-api#voprosy-i-otvety)
- [Можно ли сделать частичный возврат Kaspi?](https://apipay.kz/guides/vozvraty-kaspi-cherez-api#voprosy-i-otvety)
- [Повторяет ли система возврат автоматически?](https://apipay.kz/guides/vozvraty-kaspi-cherez-api#voprosy-i-otvety)
- [Можно ли запретить возвраты совсем?](https://apipay.kz/guides/vozvraty-kaspi-cherez-api#voprosy-i-otvety)
- [Кто напишет интеграцию возвратов?](https://apipay.kz/guides/vozvraty-kaspi-cherez-api#voprosy-i-otvety)

### [Вебхук ApiPay не приходит — как найти причину?](https://apipay.kz/guides/webhook-ne-prihodit)

Вебхук молчит: пусто в webhook-логах, недоступный URL, редирект 301/302, подпись не сходится или circuit breaker. Диагностика по шагам.

Markdown: https://apipay.kz/guides/webhook-ne-prihodit.md

### [Как заполнить каталог товаров в ApiPay: поля, штрихкод, НТИН](https://apipay.kz/guides/zapolnenie-kataloga-apipay)

Инструкция по каталогу ApiPay: какие поля заполнять и на что влияют, правило «один штрихкод = один товар», когда НТИН попадает в чек Kaspi.

Markdown: https://apipay.kz/guides/zapolnenie-kataloga-apipay.md

- [Добавил товар, а в каталоге появилась не новая карточка, а старая с прежним названием. Почему?](https://apipay.kz/guides/zapolnenie-kataloga-apipay#chastye-voprosy)
- [Я не вижу в каталоге товары со статусом «Ошибка» или «Ожидает». Куда они делись?](https://apipay.kz/guides/zapolnenie-kataloga-apipay#chastye-voprosy)

### [Жизненный цикл счёта: от создания до денег](https://apipay.kz/guides/zhiznennyy-tsikl-scheta)

Счёт ApiPay: processing → pending → paid/cancelled/expired. Тайминги, легитимный cancelled→paid, когда приходят деньги и какой вебхук на шаге.

Markdown: https://apipay.kz/guides/zhiznennyy-tsikl-scheta.md

- [Счёт был cancelled, а стал paid — это ошибка?](https://apipay.kz/guides/zhiznennyy-tsikl-scheta#chastye-voprosy)
- [Есть ли статус refunded?](https://apipay.kz/guides/zhiznennyy-tsikl-scheta#chastye-voprosy)
