Как подключить оплату Kaspi на сайт или в интернет-магазин
Кнопка «Оплатить в Kaspi» для Тильды, модули WooCommerce и OpenCart, API для своего магазина: что выбрать и как сайт узнаёт, что заказ оплачен.
Короткий ответ. Принимать оплату через Kaspi на своём сайте можно без интернет-эквайринга: KazPayment работает через кассу Kaspi Pay, которая у вас уже есть, и деньги идут прямо на счёт вашего бизнеса. Если цена у товара фиксированная, хватит кнопки «Оплатить в Kaspi»: это одна строка кода, её вставляют в блок «HTML» на Тильде, Wix или Taplink. Для WooCommerce и OpenCart есть готовые модули. Самописный магазин подключается через API, для этого нужен программист.
Как это выглядит для покупателя
Покупатель нажимает «Оплатить» у вас на сайте и дальше всё зависит от устройства.
С телефона открывается приложение Kaspi уже с суммой. Остаётся подтвердить, номер вводить не нужно.
С компьютера открывается страница с QR-кодом. Его сканируют камерой телефона и платят из приложения Kaspi или другого банка: это Единый QR, мы проверяли живой оплатой через Halyk.
Сам QR живёт около трёх минут, так устроено у Kaspi. Поэтому код выпускается в момент нажатия, а не заранее. Если покупатель не успел, страница выпустит новый.
Нет программиста: кнопка или ссылка
Кнопка «Оплатить в Kaspi». Подходит, когда цена одна: курс, билет, букет, консультация. Заведите товар в разделе «Товары», откройте «Действия» → «Кнопка для сайта» и скопируйте строку вида:
<script src="https://kazpayment.kz/widget.js" data-product="Ab3dEfGh" async></script>
Вставьте её туда, где должна стоять кнопка. В конструкторах сайтов это блок
«HTML» или «Код». Подпись можно сделать казахской (data-lang="kk") или
своей (data-label="Купить букет").
Цена берётся из кабинета. Поменяли цену, и кнопку на сайте трогать не нужно. Каждое нажатие заводит отдельный заказ, так что десять покупателей не мешают друг другу. Подробно: QR на товар.
Ссылка на оплату. Подходит, когда сумма каждый раз своя: заказ с
доставкой, индивидуальный расчёт. Вы выставляете начисление в кабинете,
нажимаете «Ссылка на оплату» и отправляете её покупателю в мессенджер или
письмом. Страницу оплаты можно и встроить в свой сайт через iframe.
Подробно: Оплата по ссылке и QR.
Ссылки удобны для начала. На десятом заказе в день выставлять счета руками станет тяжело, и тогда пора подключать API.
Про Тильду отдельно
Готового модуля для Тильды у нас пока нет. Что работает уже сейчас:
- кнопка «Оплатить в Kaspi» в блоке «HTML» для товаров с одной ценой;
- ссылка на оплату, которую вы отправляете покупателю после заказа;
- API, если у сайта есть программист и свой обработчик заказов.
Корзину Тильды с разной суммой заказа кнопка не заменит: кнопка привязана к товару из кабинета с его ценой.
Есть WordPress или OpenCart: готовый модуль
Для WooCommerce есть плагин, для OpenCart 3 и ocStore 3 есть модуль. Оба добавляют в магазин способ оплаты «Kaspi QR или любой банк».
Установка короткая: скачать архив, загрузить его в админке, выпустить в кабинете KazPayment ключ интеграции («Подключения» → «Интеграция» → «Выпустить ключ») и вставить его в настройки. Галочка там же сама сообщит нам адрес вашего магазина для уведомлений.
Номер заказа в KazPayment совпадает с номером заказа в магазине. Как только деньги пришли, заказ сам становится оплаченным. Возврат в WooCommerce делается кнопкой «Возврат» в самом заказе. Валюта магазина должна быть тенге, иначе способ оплаты не показывается.
Пошагово: WooCommerce, OpenCart и ocStore.
Есть свой разработчик: API и вебхук
Схема такая: ваш сайт создаёт заказ запросом POST /api/v1/orders с номером
заказа и суммой и получает в ответ ссылку на оплату. Покупателя вы
отправляете на эту ссылку редиректом или показываете её в iframe. Об оплате
мы сообщаем вашему серверу вебхуком payment.received.
Пара вещей, которые экономят время:
- ваш номер заказа служит ключом повтора: если запрос оборвался и вы его повторили, второй заказ не создастся;
- если передать телефон покупателя, ему дополнительно придёт счёт в приложение Kaspi;
- есть готовые SDK для Node.js, Python и PHP, проверка подписи вебхука уже внутри;
- отменить заказ и вернуть деньги тоже можно через API.
Отлаживать удобно в песочнице: это копия бизнеса без денег, оплату там нажимаете вы сами. Маршрут по шагам: Подключить интернет-магазин, полный контракт: документация API.
Как магазин узнаёт, что заказ оплачен
У самого Kaspi нет мгновенного уведомления даже для нас, поэтому оплату мы узнаём, спрашивая кассу.
Пока покупатель на странице оплаты, она спрашивает кассу каждые несколько секунд. Увидела деньги, сразу показывает «Оплачено», отмечает заказ и отправляет вебхук. Обычно это секунды.
Если покупатель закрыл страницу раньше, оплату подхватит сверка с выпиской кассы. Она идёт раз в час, так что в худшем случае статус приходит в пределах часа.
Вебхук может прийти дважды, это нормально: закрывайте заказ один раз по
event_id. И не делайте вебхук единственным источником правды, статус всегда
можно спросить запросом GET /api/v1/orders/<номер>. Модули для WooCommerce
и OpenCart делают такую проверку сами.
Где видно оплаты
Все оплаты видны в кабинете, в разделах «Начисления» и «Поступления». По товарам в таблице есть столбец «Оплачено»: сколько раз каждый оплатили и на какую сумму. Если сайт передал через API телефон покупателя, тот сам заводится в «Клиентах», и ему работают напоминания о неоплаченном заказе.
Деньги мы не держим и не переводим. Счёт выставляется через вашу же кассу Kaspi Pay, и оплата сразу ложится на счёт вашего бизнеса.
С чего начать
- Зарегистрируйтесь на kazpayment.kz. Бизнес сразу работает на бесплатном тарифе Free.
- Подключите кассу: в Kaspi Pay добавляется роль «Кассир». Инструкция: Подключить кассу.
- Выберите способ: кнопка, ссылка, модуль или API.
- Проведите одну маленькую оплату самому себе и верните её из кабинета. Так проще всего убедиться, что всё сходится.
Частые вопросы
Можно ли принимать оплату через Kaspi на сайте без программиста?
Да, если цена у товара фиксированная. Заведите товар в кабинете, возьмите в «Действия» → «Кнопка для сайта» одну строку кода и вставьте её в блок «HTML» на Тильде, Wix или Taplink. С телефона кнопка сразу открывает Kaspi с суммой, с компьютера показывает QR. Для разных сумм подойдёт ссылка на оплату из кабинета.
Есть ли модуль KazPayment для Тильды?
Пока нет. На Тильде сейчас работают кнопка «Оплатить в Kaspi» в блоке «HTML» для товаров с одной ценой, ссылка на оплату и подключение через API. Готовые модули есть для WooCommerce и для OpenCart 3 или ocStore 3.
Сколько стоит приём оплаты на сайте?
Комиссию за приём, 0,95%, удерживает сам Kaspi. Своей комиссии с оборота KazPayment не берёт. API, вебхуки и модули работают на любом тарифе, включая бесплатный Free: на нём до 100 оплат и до 500 заказов через API за 30 дней.
Нужно ли покупателю приложение Kaspi?
Нет. На странице оплаты есть QR-код, это Единый QR, и его понимают приложения других казахстанских банков. Мы проверяли оплату через Halyk. На телефоне под кнопкой «Оплатить в Kaspi» есть «Показать QR-код» как раз для этого случая.
Как быстро сайт узнаёт об оплате?
Обычно за секунды, пока покупатель остаётся на странице оплаты. Если он закрыл страницу раньше, оплату подхватит ежечасная сверка с выпиской кассы, поэтому в худшем случае статус и вебхук приходят в пределах часа.
Как вернуть деньги покупателю?
Кнопкой «Возврат» у оплаченного начисления в кабинете, целиком или частично. Магазин может вернуть деньги и сам через API, а в WooCommerce возврат делается прямо из заказа. Деньги уходят на ту карту, с которой пришли. Подробно: Вернуть деньги клиенту.
Попробуйте KazPayment бесплатно
Тестовый режим без ограничения по времени: заведите тарифы, товары и счета и посмотрите, как это работает, до того как подключать настоящую кассу.
Начать бесплатно