Перейти к содержимому

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

37

Общее

Что такое Bankemes?

Bankemes — интеграционный сервис для приёма платежей на сайте или в приложении через подключённую кассу продавца. Деньги поступают непосредственно в банк продавца.

Какие способы оплаты доступны?

Kaspi Pay через кассу продавца. Halyk ePay отображается только в режиме, который включён для конкретной кассы; другие банки не рекламируются как поддерживаемый способ без подтверждённой совместимости.

Kaspi

Bankemes — официальный партнёр Kaspi?

Нет. Bankemes работает с вашей кассой Kaspi Pay через вход по номеру кассира и коду из SMS — так же, как вы входите в кассу сами. Официальным API Kaspi Bank это не является.

Куда поступают деньги?

На счёт вашей кассы Kaspi. Bankemes не принимает и не хранит деньги покупателей.

Что если Kaspi завершит сессию кассы?

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

Счета, подключение и API

Что нужно для подключения сайта?

Подключённая касса, активная подписка, ресурс (адрес сайта) и API-токен. Подробно — в разделе для разработчиков.

Нужен ли программист?

Для Merchant API нужен доступ к серверной части сайта. Если у вас есть ИИ-агент с разрешённым доступом к проекту, он может помочь с настройкой; готовые плагины также требуют проверки вашей конфигурации.

Можно ли выставить счёт на телефон покупателя?

Да. Создайте удалённый счёт Kaspi Pay через кабинет или Merchant API. Это банковская операция: проверьте номер и сумму, а статус сверяйте через Bankemes.

Как узнать, что заказ оплачен?

По webhook payment.paid или запросом статуса через API. Переход покупателя на страницу «спасибо» оплату не подтверждает.

Что такое Idempotency-Key?

Ключ запроса на создание: повтор запроса с тем же ключом вернёт тот же платёж, а не создаст второй.

Чем удалённый счёт отличается от ссылки?

Удалённый счёт Kaspi Pay создаётся на номер покупателя в банке; ссылку Bankemes покупатель открывает сам. Создание remote invoice — настоящая банковская операция, тестового режима для неё нет.

Кто отправляет уведомление о счёте?

Для банковского удалённого счёта уведомление покупателю отправляет Kaspi, если банк подтвердил создание. Bankemes не отправляет SMS или WhatsApp-ссылку вместо банковского счёта.

Есть ли Halyk?

Адаптер Halyk ePay работает в тестовом режиме. Боевой режим будет включён только после интеграционной проверки с банком.

MCP и ИИ-агенты

Как подключить Bankemes к ИИ-агенту?

В совместимом MCP-клиенте добавьте сервер Bankemes через OAuth или используйте разрешённый ключ настройки. Агент сможет читать инструкции и с вашего разрешения настраивать ресурс и интеграцию. Создание реальных счетов требует отдельного подтверждения владельца.

Нужно ли сообщать агенту пароль или SMS-код?

Нет. Пароли Kaspi, SMS-коды и сессии вводятся только на странице Bankemes или банка. Агент не должен получать эти секреты.

Может ли ИИ настроить регулярные счета покупателям?

Да. MCP-агент может помочь создать расписание, приостановить его, возобновить или отменить. Создание расписания выпускает реальные счета и выполняется только после подтверждения владельца в кабинете.

Подписка и счета

Это подписка Bankemes или подписка для моих покупателей?

Подписка Bankemes — плата продавца за использование платформы. Для покупателей можно настраивать расписания счетов непосредственно в Bankemes либо управлять подписками в собственном приложении через Merchant API и webhooks. Каждый счёт покупатель оплачивает самостоятельно.

Когда начинается пробный период?

Пробный период начинается после завершения регистрации и подтверждения номера и длится 48 часов. Он предоставляется один раз на номер телефона и покрывает только первую кассу. Выпуск API-ключа не меняет даты пробного периода.

Как продлевается подписка Bankemes?

При включённых регулярных счетах Bankemes выставляет счёт за 24 часа до конца оплаченного периода на сохранённый номер Kaspi. Продавец оплачивает его сам; автоматического списания нет. После окончания периода действует трёхдневный льготный срок.

Интеграции

Есть ли готовые модули для сайта?

В репозитории проекта есть плагины WooCommerce и OpenCart. Совместимость с конкретной конфигурацией и реальную оплату нужно проверить до публикации сайта.

Можно ли связать Bankemes с CRM или automation-сервисом?

В кодовой базе есть адаптеры и примеры сценариев. Подключение требует настройки учётных данных и проверки тестового потока.

Безопасность и проверка платежей

Когда платёж считается оплаченным?

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

Как хранятся секреты?

Сессии касс, секреты webhooks и реквизиты Halyk хранятся в зашифрованном виде; API-токены — только в виде хеша.

Видит ли Bankemes данные карт?

Нет. Оплата проходит в приложении банка; Bankemes не запрашивает данные карт и пароли.

Ошибки подключения

Касса показывает reconnect_required. Что делать?

Войдите в кабинет и переподключите кассу вручную. Не отправляйте пароль и SMS-код оператору или ИИ-агенту.

Что делать, если ответ о создании счёта неизвестен?

Не отправляйте запрос повторно автоматически. Сначала проверьте историю операции в Bankemes и Kaspi: банк мог создать счёт, даже если ответ потерялся.

Вопросы о подписке

Есть ли бесплатный период?

Да: 2 дня бесплатно, затем 4 990 ₸ / месяц. Пробный период начинается после завершения регистрации и подтверждения номера, длится 48 часов и покрывает только первую кассу. Он предоставляется один раз на номер телефона. Первая оплата начинает оплаченный месяц с подтверждения банка и завершает оставшийся пробный период.

За что платить — за аккаунт или за кассу?

За кассу. Каждая подключённая касса Kaspi — отдельная подписка со своим сроком.

Что значит календарный месяц?

Подписка продлевается ежемесячно по дате начала оплаченного периода, а не каждые 30 дней. Если такой даты в следующем месяце нет, используется его последний день; исходный день продления сохраняется.

Какие комиссии удерживает Bankemes?

Комиссия Bankemes с оборота — 0%. Вы платите фиксированную подписку за кассу; отдельной платы за каждый платёж нет. Комиссии банка и платные услуги внешних сервисов оплачиваются по их условиям.

Как оплатить подписку?

В кабинете Bankemes сохраните номер Kaspi для счетов и согласитесь получать их. Bankemes выставит счёт от своей кассы, а вы подтвердите оплату в Kaspi. Доступ продлится после банковского подтверждения.

Что будет, когда подписка закончится?

После оплаченного периода действует 3 дня льготного доступа. Затем новые платежи через кассу приостанавливаются до оплаты. Уже созданные платежи продолжают проверяться, история сохраняется.

Как работает льготный период?

После окончания оплаченного периода действует 3 дня льготного доступа. Если оплату не подтвердили, новые платежи через кассу приостанавливаются; уже созданные продолжают сверяться.

Как выставляется ежемесячный счёт?

При сохранении номера Kaspi и согласия первый счёт приходит сразу. Следующий счёт выставляется за 24 часа до конца оплаченного календарного месяца. Каждый счёт оплачивается вручную; автоматического списания нет.

Можно отключить будущие счета?

Да. Отключите регулярные счета в кабинете: это действует для всех касс аккаунта. Уже оплаченный доступ сохраняется до конца периода, а уже выставленный счёт не отменяется автоматически.

Что делать, если счёт не оплачен?

Доступ сохраняется в течение 3 дней льготного периода. Затем новые платежи через кассу останавливаются. Проверьте статус счёта в кабинете; неизвестный статус нужно сверить, не создавая дубликат.

Есть ли месячная квота платежей?

Месячной квоты на количество платежей нет. В подписку входят доступные функции: страница оплаты, QR, удалённые счета, ссылки, регулярные и массовые счета, клиенты, API, SDK, webhooks, MCP, отчёты и интеграции. Технические ограничения частоты запросов, защита от злоупотреблений и ограничения банка сохраняются.