Инструкция по подключению магазина

Как подключить Kaspi API и где взять токен магазина

Один токен из кабинета продавца — и заказы, товары, остатки и цены подтягиваются автоматически. Ниже пять шагов и разбор ошибок, на которых обычно спотыкаются.

Подключить магазин

Пять шагов

1

Создайте аккаунт в Quanta

Почта и пароль. Банковская карта не нужна, оплата не запрашивается — базовые функции бесплатны навсегда.

2

Откройте кабинет продавца Kaspi

В другой вкладке зайдите в свой кабинет и найдите настройки магазина — там есть блок с интеграциями и API. Нужны права администратора магазина.

3

Сгенерируйте токен Shop API

Создайте токен и скопируйте его целиком. Это не пароль от кабинета: токен открывает доступ только к товарам, заказам, остаткам и ценам, и отзывается одной кнопкой.

4

Вставьте токен в Quanta

Поле подключения магазина — на экране после регистрации. Вставьте значение без пробелов по краям и сохраните. Токен сразу шифруется.

5

Дождитесь первой синхронизации

Товары и заказы подтянутся сами. На большом каталоге это несколько минут — прогресс виден, вкладку закрывать не нужно.

Что даёт токен, а что нет

Токен даёт

  • Читать заказы и их статусы
  • Видеть товары и остатки
  • Обновлять цены в рамках ваших правил

Токен не даёт

  • Входа в ваш кабинет Kaspi
  • Доступа к деньгам и выплатам
  • Возможности менять реквизиты магазина

Токен хранится в зашифрованном виде и отзывается в кабинете Kaspi в любой момент — после отзыва сервис сразу теряет доступ.

Если что-то пошло не так

Где в кабинете Kaspi взять токен для API?

Токен Shop API выдаётся в личном кабинете продавца Kaspi — в разделе настроек магазина, в блоке, посвящённом интеграциям и API. Токен генерируется вами и принадлежит вашему магазину: это не пароль от кабинета и не доступ к вашему счёту. Если раздел не отображается, значит у вашей учётной записи нет прав администратора магазина — попросите владельца выдать их или сгенерировать токен за вас.

Это безопасно? Что именно получает сервис?

Токен Shop API даёт доступ к товарам, заказам, остаткам и ценам вашего магазина — то есть ровно к тому, что нужно для синхронизации и переоценки. Он не даёт входа в кабинет, не даёт доступа к деньгам и не позволяет менять реквизиты. В Quanta токен хранится в зашифрованном виде, а отозвать его можно в любой момент из кабинета Kaspi — после этого сервис немедленно теряет доступ.

Токен не принимается — что делать?

Чаще всего дело в трёх вещах. Первое: при копировании прихватились пробелы или перенос строки — вставьте токен ещё раз, целиком и без лишних символов. Второе: токен сгенерирован для другого магазина, а вы подключаете этот — проверьте, тот ли кабинет открыт. Третье: токен был перевыпущен, и старое значение перестало работать — сгенерируйте новый и вставьте его. Если ни одно не подходит, напишите нам в WhatsApp, мы посмотрим вместе.

Сколько ждать после подключения?

Товары и заказы начинают подтягиваться сразу после проверки токена. Первая полная синхронизация магазина с большим каталогом может занять несколько минут — прогресс виден на экране, закрывать вкладку не нужно. После этого заказы обновляются автоматически, вручную ничего запускать не требуется.

Нужен ли отдельный доступ для автоматических цен?

Да. Синхронизация заказов и товаров работает через Shop API по токену, а автоматическая переоценка требует подключения кабинета продавца — это отдельный шаг в настройках. Мы рекомендуем сначала подключить токен и убедиться, что заказы и товары на месте, а уже потом включать автоматические цены.

Застряли на подключении?

Напишите нам — поможем найти токен и подключить магазин. Это бесплатно и не требует оплаты тарифа.