Руководства → Интернет-магазин и телеграм-бот
Интернет-магазин и телеграм-бот: приём оплаты без эквайринга
Обычный путь для онлайн-продаж — интернет-эквайринг: договор с банком, проверка сайта, комиссия с каждой продажи. KazPayment позволяет обойтись кассой Kaspi Pay, которая у вас, скорее всего, уже есть.
Эта статья — про то, как это устроено с точки зрения владельца. Техническая часть для разработчика: Подключить интернет-магазин или телеграм-бот.
Как это работает для покупателя
- Покупатель оформляет заказ у вас на сайте или в боте.
- Он попадает на страницу оплаты с суммой заказа.
- С телефона нажимает «Оплатить в Kaspi» — открывается Kaspi уже с суммой, остаётся подтвердить; номер вводить не нужно. С компьютера сканирует QR камерой телефона и платит из приложения своего банка — Kaspi, Halyk и других казахстанских (это Единый QR).
- Ваш сайт узнаёт об оплате сам и закрывает заказ.
Приложение Kaspi покупателю не обязательно: на телефоне под главной кнопкой есть «Показать QR-код» для другого банка. Если он оставил телефон, ему дополнительно придёт счёт прямо в Kaspi.
Два способа подключить
Через API (правильный). Ваш сайт или бот создаёт заказ программно и получает ссылку на оплату; об оплате приходит уведомление на ваш сервер. Нужен программист на несколько часов — или ИИ-ассистент с готовым промптом, который напишет это по нашей документации. API и уведомления работают на любом тарифе, включая бесплатный Free (на нём — до 500 заказов через API за 30 дней). В песочнице предела нет.
Вручную (для начала). Пока заказов немного, счета можно выставлять из кабинета: ручное начисление с суммой и поводом, ссылку отправляете покупателю в мессенджер. Способ рабочий, но не масштабируется — на десятом заказе в день станет тяжело.
Что настроить в кабинете
- Тариф «Разовый» — например, «Заказ в магазине». Сумма у каждого заказа своя, в тарифе она не важна.
- Клиента (раздел «Клиенты»): если покупатель оставил телефон, заведите его — тогда работают напоминания о неоплаченном заказе. Через API телефон передаётся в заказе, и клиент заводится сам.
- Для API — ключ интеграции: «Подключения» → «Интеграция» → «Выпустить ключ». Работает на любом тарифе; на Free — до 500 заказов через API за 30 дней.
Про сроки и что говорить покупателю
Покупатель видит «Оплачено» на странице оплаты сразу — страница спрашивает кассу напрямую.
А вот статус заказа в API и уведомление вашему сайту подтверждаются сверкой с выпиской кассы: обычно в пределах часа. Причина в том, что у Kaspi нет мгновенного уведомления даже для нас, и мы честно об этом пишем, а не делаем вид, что знаем раньше.
Практический вывод: не показывайте покупателю «ожидаем оплату» после того, как он заплатил. Показывайте «оплата принята, заказ подтверждён» — и закрывайте заказ у себя, когда придёт наше уведомление.
Возврат покупателю
Отказ, брак, не оказалось на складе — возврат делается из кабинета кнопкой
«Возврат» у оплаченного начисления, целиком или частично. Ваш сайт может
вернуть деньги и сам, запросом POST /api/v1/orders/<номер>/refund — см.
документацию API. Подробно: Вернуть деньги клиенту.
КНП для бухгалтерии
В разделе «О компании» выберите КНП 710 — платежи за товары, за исключением недвижимости, если вы продаёте товары. Если продаёте услуги (подписка на сервис, консультации, доступ к материалам) — код будет другим: например, 851 для компьютерных услуг или 859 для профессиональных. Формулировка из вашего договора решает; сомнение разрешает бухгалтер.
Чего сервис не делает
Он не заменяет магазин: нет корзины, склада и статусов доставки. Он про деньги — счёт, оплата, уведомление вашей системе, сверка и возврат. Заказы остаются в вашей системе, к нам уходит только сумма. Раздел «Товары» в кабинете — это постоянные QR и ссылки на оплату для товаров с одной ценой (QR на товар), а не витрина с корзиной.
Ещё честная граница: деньги идут напрямую на счёт вашего бизнеса в Kaspi, мы их не держим и не переводим. Мы не платёжный агент — мы выставляем требование через вашу же кассу и читаем её выписку.
Не помогло? Напишите на support@kazpayment.kz — отвечает разработчик сервиса.