Руководства → Интернет-магазин и телеграм-бот

Интернет-магазин и телеграм-бот: приём оплаты без эквайринга

Обычный путь для онлайн-продаж — интернет-эквайринг: договор с банком, проверка сайта, комиссия с каждой продажи. KazPayment позволяет обойтись кассой Kaspi Pay, которая у вас, скорее всего, уже есть.

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

Как это работает для покупателя

  1. Покупатель оформляет заказ у вас на сайте или в боте.
  2. Он попадает на страницу оплаты с суммой заказа.
  3. С телефона нажимает «Оплатить в Kaspi» — открывается Kaspi уже с суммой, остаётся подтвердить; номер вводить не нужно. С компьютера сканирует QR камерой телефона и платит из приложения своего банка — Kaspi, Halyk и других казахстанских (это Единый QR).
  4. Ваш сайт узнаёт об оплате сам и закрывает заказ.

Приложение Kaspi покупателю не обязательно: на телефоне под главной кнопкой есть «Показать QR-код» для другого банка. Если он оставил телефон, ему дополнительно придёт счёт прямо в Kaspi.

Два способа подключить

Через API (правильный). Ваш сайт или бот создаёт заказ программно и получает ссылку на оплату; об оплате приходит уведомление на ваш сервер. Нужен программист на несколько часов — или ИИ-ассистент с готовым промптом, который напишет это по нашей документации. API и уведомления работают на любом тарифе, включая бесплатный Free (на нём — до 500 заказов через API за 30 дней). В песочнице предела нет.

Вручную (для начала). Пока заказов немного, счета можно выставлять из кабинета: ручное начисление с суммой и поводом, ссылку отправляете покупателю в мессенджер. Способ рабочий, но не масштабируется — на десятом заказе в день станет тяжело.

Что настроить в кабинете

  1. Тариф «Разовый» — например, «Заказ в магазине». Сумма у каждого заказа своя, в тарифе она не важна.
  2. Клиента (раздел «Клиенты»): если покупатель оставил телефон, заведите его — тогда работают напоминания о неоплаченном заказе. Через API телефон передаётся в заказе, и клиент заводится сам.
  3. Для API — ключ интеграции: «Подключения» → «Интеграция» → «Выпустить ключ». Работает на любом тарифе; на Free — до 500 заказов через API за 30 дней.

Про сроки и что говорить покупателю

Покупатель видит «Оплачено» на странице оплаты сразу — страница спрашивает кассу напрямую.

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

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

Возврат покупателю

Отказ, брак, не оказалось на складе — возврат делается из кабинета кнопкой «Возврат» у оплаченного начисления, целиком или частично. Ваш сайт может вернуть деньги и сам, запросом POST /api/v1/orders/<номер>/refund — см. документацию API. Подробно: Вернуть деньги клиенту.

КНП для бухгалтерии

В разделе «О компании» выберите КНП 710 — платежи за товары, за исключением недвижимости, если вы продаёте товары. Если продаёте услуги (подписка на сервис, консультации, доступ к материалам) — код будет другим: например, 851 для компьютерных услуг или 859 для профессиональных. Формулировка из вашего договора решает; сомнение разрешает бухгалтер.

Чего сервис не делает

Он не заменяет магазин: нет корзины, склада и статусов доставки. Он про деньги — счёт, оплата, уведомление вашей системе, сверка и возврат. Заказы остаются в вашей системе, к нам уходит только сумма. Раздел «Товары» в кабинете — это постоянные QR и ссылки на оплату для товаров с одной ценой (QR на товар), а не витрина с корзиной.

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


Не помогло? Напишите на support@kazpayment.kz — отвечает разработчик сервиса.