ApiPay: счета Kaspi

Решение для МоегоСклада: выставляет счета Kaspi покупателям по номеру телефона из заказа.

Работает через ApiPay (apipay.kz) — сервис автоматизации вашего Kaspi Pay

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

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

Счёт по номеру телефона действует 24 часа. Если покупатель не оплатил за это время, счёт истекает — заказ останется в статусе-триггере, а счёт выставляется заново повторным переводом статуса.

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

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

Подключение

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

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

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

Подробный разбор, чей номер подойдёт и почему ваш может не пройти — в статье «Требования к номеру кассира».

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

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

Первые дни — лимит на счета. Пока не одобрена анкета «Расскажите о вашем бизнесе» в кабинете ApiPay, организация выставляет 1 реальный счёт в сутки. Анкета заполняется один раз, занимает около 5 минут, одобрение обычно занимает 1 рабочий день — после него лимит снимается автоматически. Подробнее — «Зачем анкета о бизнесе и что за лимит».

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

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

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

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

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

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

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

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

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

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

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

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

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

Не получилось настроить?

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

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

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

Публичная оферта · Согласие на обработку данных · Политика конфиденциальности · Соглашение о доступе