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

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

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

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

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

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

Приложение Kaspi покупателю не обязательно. Если он оставил телефон, ему дополнительно придёт счёт прямо в Kaspi — тогда платить ещё быстрее.

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

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

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

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

  1. Тариф «Разовый» — например, «Заказ в магазине». Сумма у каждого заказа своя, в тарифе она не важна.
  2. Плательщика: если покупатель оставил телефон, заведите его — тогда работают напоминания о неоплаченном заказе. Через API телефон передаётся в заказе, и плательщик заводится сам.
  3. Для API — ключ интеграции: напишите на support@kazpayment.kz с адресом сайта или именем бота.

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

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

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

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

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

Отказ, брак, не оказалось на складе — возврат делается из кабинета кнопкой «Возврат» у оплаченного начисления, целиком или частично. Программного возврата в API нет намеренно: операция редкая и заслуживает человеческого решения. Подробно: Вернуть деньги клиенту.

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

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

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

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

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

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