> Источник: https://apipay.kz/moysklad · apipay.kz
> ApiPay — независимый сервис приёма платежей поверх вашего Kaspi Pay.

# МойСклад и Kaspi Pay — счета покупателям из заказов

**TL;DR.** Решение ApiPay ставится из каталога МоегоСклада и выставляет счета Kaspi покупателям по номеру телефона прямо из заказов. Перевели заказ в выбранный статус — покупателю приходит счёт в приложение Kaspi; после оплаты решение само создаёт «Счёт покупателю» и «Входящий платёж» (или «Приходный ордер») и переводит заказ в статус «Оплачен». Программист не нужен: всё настраивается в окне решения внутри МоегоСклада.

## Что делает решение

Покупатель получает обычный счёт по номеру телефона в своём приложении Kaspi и платит в пару касаний — деньги идут на ваш Kaspi-счёт. Счёт действует **24 часа**: если покупатель не оплатил, счёт истекает, заказ остаётся в статусе-триггере, а новый счёт выставляется повторным переводом статуса.

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

## Что нужно для работы

- Kaspi Pay вашего бизнеса в Казахстане (ИП, ТОО и другие формы): счета приходят покупателям от имени вашей организации.
- Отдельная SIM-карта для «кассира» — см. раздел «Подключение».
- Платный или пробный тариф МоегоСклада: на бесплатном МойСклад не присылает решению уведомления о смене статусов.
- Решение оплачивается в самом МоемСкладе как платное приложение аккаунта — отдельно в ApiPay платить не нужно. Условия и стоимость — в карточке решения в каталоге МоегоСклада.

## Подключение: шаги

Счета выставляет «кассир» — отдельный сотрудник в вашем Kaspi Pay. Это штатная роль самого Kaspi Pay, её описание есть в справке Kaspi: кассир выставляет счета, но доступа к деньгам не имеет. Ему нужен **отдельный номер телефона** — не тот, с которым вы работаете в Kaspi Pay сами.

Требования к номеру кассира:

- Настоящая SIM-карта, не виртуальный номер: подойдёт номер супруга, родственника или купленная отдельно SIM.
- На ИИН владельца этой SIM не должно быть ИП или ТОО в Kaspi Pay.
- Номер добавляется в **вашем** Kaspi Pay → Настройки → Сотрудники → «+ Добавить сотрудника» с ролью «Кассир», и только с ней.

Порядок настройки:

1. Установите решение из каталога МоегоСклада и откройте его.
2. На вкладке «Подключение» создайте аккаунт ApiPay (один клик).
3. Подтвердите готовность номера кассира, введите его и код из SMS (код живёт около минуты).
4. Выберите статусы заказа на вкладке «Настройки» и переведите заказ в статус-триггер: покупателю придёт счёт в Kaspi.

**Сначала анкета, потом кассир.** До одобрения анкеты «Расскажите о вашем бизнесе» в кабинете ApiPay кассир не подключается, SMS ему не отправляется и реальных счетов нет вовсе. Анкета заполняется один раз за 5 минут, одобрение обычно занимает несколько часов — после него реальные платежи открываются автоматически.

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

**После подключения не входите в Kaspi Pay с номера кассира.** Kaspi Pay работает с одной активной сессией на номер: вход разорвёт подключение, счета перестанут уходить до повторной привязки.

Телефон покупателя берётся из заказа, из поля контрагента. Если телефона нет или номер не зарегистрирован в Kaspi — причина появится в комментарии заказа.

## Что создаётся в МоемСкладе

| Событие | Что происходит в МоемСкладе |
|---|---|
| Заказ переведён в статус-триггер | Покупателю уходит счёт Kaspi по номеру из заказа |
| Счёт оплачен | Создаются «Счёт покупателю» и «Входящий платёж» (или «Приходный ордер»), заказ — в статусе «Оплачен» |
| Счёт выставить не удалось | Причина пишется в комментарий заказа, заказ уходит в отдельный статус |
| Счёт не оплачен за 24 часа | Счёт истекает, заказ остаётся в статусе-триггере |
| Возврат прошёл | Документ оплаты удаляется, итог пишется в комментарий заказа |

## Товары в фискальном чеке (НТИН)

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

Решение выгружает номенклатуру в каталог Kaspi списком, коды НТИН заполняются в таблице товаров прямо в окне решения.

**Услуги и комплекты.** Штатное поле «НТИН» в МоемСкладе есть только у товаров, хотя в чеке нужны и услуги с комплектами. Поэтому решение добавляет своё поле «НТИН для Kaspi (ApiPay)», видное у всей номенклатуры. Если коды уже лежат в другом поле, укажите его в настройке «Откуда брать код НТИН» — переносить ничего не нужно.

После выгрузки включите в настройках «Счёт по товарам заказа» — НТИН каждой позиции попадёт в фискальный чек сам, без ручного набора на кассе.

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

## Отмена и возврат

**Отмена счёта.** Выберите в настройках статусы отмены: при переводе заказа в такой статус решение отправит в Kaspi отмену неоплаченного счёта. Отмена выполняется не мгновенно: если покупатель успел оплатить, счёт останется оплаченным — деньги тогда возвращают возвратом.

**Возврат оплаты.** Переведите заказ в статус возврата (настраивается) — решение отправит в Kaspi возврат всей суммы. Возврат обрабатывается не мгновенно, и Kaspi может его отклонить: частая причина — на Kaspi-счёте не хватает денег. Kaspi удерживает свою обычную комиссию за приём платежа по вашим условиям Kaspi Pay — она не связана с ApiPay, а возврат уходит на полную сумму, поэтому держите запас. Итог решение пишет в комментарий заказа. Окно возврата ограничено — ориентир около двух недель с оплаты, точную границу определяет Kaspi.

Возвраты, сделанные кассиром в приложении Kaspi, решение тоже видит и отражает автоматически. Частичные возвраты оно не трогает: документы остаются как есть.

Если кассир отключён, ApiPay не проведёт возврат по ранее оплаченным счетам — их делают вручную в приложении Kaspi Pay. Отключайте кассира после того, как окно возврата по последним счетам закрыто.

## Если счета нужны не только из МоегоСклада

Если счета нужны ещё и из своей программы, с сайта или из бота, есть REST API ApiPay — те же счета Kaspi запросом из вашей системы.

## Если не получается

Напишите нам — поможем разобраться и настроить.

- WhatsApp: +7 700 307 65 12
- Почта: support@apipay.kz

## Частые вопросы

**Как принимать оплату Kaspi Pay из МоегоСклада?**
Установите решение из каталога МоегоСклада, создайте в нём аккаунт ApiPay, подключите кассира по коду из SMS и выберите статусы заказа. Перевели заказ в статус-триггер — покупателю приходит счёт в Kaspi, оплата возвращается документами.

**Нужен ли программист?**
Нет. Кассир, статусы заказа и товары настраиваются в окне решения внутри МоегоСклада.

**Как счёт попадает в МойСклад после оплаты?**
Решение само создаёт «Счёт покупателю» и «Входящий платёж» (или «Приходный ордер»), заказ переходит в «Оплачен».

**Сколько времени у покупателя на оплату?**
24 часа. Затем счёт истекает, новый выставляется повторным переводом статуса.

**Нужна ли отдельная SIM-карта?**
Да, для сотрудника с ролью «Кассир» — не тот номер, с которым вы работаете сами. На ИИН владельца SIM не должно быть ИП или ТОО в Kaspi Pay, а после подключения входить в Kaspi Pay под номером кассира нельзя.

**Можно ли вернуть оплату из МоегоСклада?**
Да, переводом заказа в статус возврата — решение отправит в Kaspi возврат всей суммы. Kaspi может его отклонить (частая причина — не хватает денег на счёте), итог пишется в комментарий заказа. Ориентир окна возврата — около двух недель с оплаты.

## Куда дальше

- Номер кассира: https://apipay.kz/guides/trebovaniya-k-nomeru-kassira.md
- Анкета о бизнесе: https://apipay.kz/guides/anketa-o-biznese-i-limit.md
- Каталог и коды НТИН: https://apipay.kz/guides/zapolnenie-kataloga-apipay.md
- Возвраты Kaspi: https://apipay.kz/guides/vozvraty-kaspi-cherez-api.md
- Подключение кассира: https://apipay.kz/connect-cashier.md
- Kaspi на сайте и в своей программе: https://apipay.kz/kaspi-pay-integration.md
- REST API: https://apipay.kz/apipay-api-docs.md · ошибки: https://apipay.kz/errors.md
- Разработчику платформы: https://apipay.kz/guides/integraciya-apipay-s-moyskladom.md
- Все материалы: https://apipay.kz/index.md

---

ApiPay — независимый сервис поверх вашего Kaspi Pay: не партнёр Kaspi и не официальная интеграция Kaspi. Мы не банк и не платёжная система, деньги покупателей идут напрямую на ваш Kaspi-счёт. ApiPay не аффилирован с АО «Kaspi Bank»; Kaspi и Kaspi Pay — товарные знаки их правообладателя.