Kaspi Pay для интернет-магазина: подключение, виджет, чекаут — 2026

Если у вас интернет-магазин в Казахстане, вопрос приёма оплаты сводится к одному выбору: банковский эквайринг с комиссией 2–3% или Kaspi Pay с 0%. Учитывая, что 4 из 5 безналичных платежей в KZ-B2C идут через Kaspi, выбор фактически предопределён. Эта статья — практическое руководство, как подключить Kaspi Pay к интернет-магазину в 2026 году, какие варианты интеграции существуют и сколько это стоит.

Что вам нужно для приёма Kaspi-платежей

Минимум:

Юридическое лицо — ИП, ТОО или зарегистрированный самозанятый.
Kaspi Business аккаунт — открывается бесплатно в приложении Kaspi за 1 рабочий день.
Отдельный номер телефона для роли «Кассир» в Kaspi Business — желательно SIM-карту не использовать на личном устройстве.
Сайт — на любой платформе (WordPress, Tilda, OpenCart, Bitrix, Shopify, кастомный код).
Способ интегрировать оплату — три варианта, см. ниже.

Три варианта подключения

Вариант 1: вручную через приложение Kaspi Business

Базовый сценарий, который работает у 90% мелких магазинов:

Клиент оформляет заказ на сайте.
Менеджер видит заказ в админке.
Менеджер открывает Kaspi Business → выставляет счёт на телефон клиента.
Клиент платит в Kaspi.
Менеджер вручную меняет статус заказа в админке.

Когда подходит: до 20–30 заказов в день, владелец бизнеса работает один или с напарником.

Минусы:

Тратится 30–60 секунд менеджерского времени на каждый заказ.
Ошибки в сумме при ручном вводе.
Нет автообновления статусов — задержки между оплатой и отправкой заказа.
Нельзя дать клиенту QR-код прямо на странице чекаута — он получает счёт в Kaspi-приложение и должен переключаться между окнами.

Вариант 2: Kaspi Pay через API (рекомендуемый для растущих магазинов)

Магазин общается с Kaspi через REST API. Когда клиент жмёт «Оплатить», сайт делает запрос → получает QR-код или ссылку → показывает клиенту → ждёт webhook с подтверждением → автоматически обновляет статус заказа.

Технически это выглядит так (пример на Python):

import requests, uuid

# 1. Создать платёж
resp = requests.post(
    "https://api.paybot.kz/v1/qr/create",
    headers={
        "X-API-Key": "kp_live_yourkey",
        "Idempotency-Key": str(order.id),
    },
    json={"amount": order.total},
)
qr_url = resp.json()["qr_url"]

# 2. Показать клиенту QR / deep-link
# 3. Ждать webhook "payment.completed"

# В webhook-обработчике:
def handle_kaspi_webhook(event):
    if event["event"] == "payment.completed":
        order = Order.get(metadata["order_id"])
        order.mark_paid()
        send_confirmation_email(order)

Когда подходит: от 30 заказов в день, есть программист или внешний подрядчик. Окупается за 1–2 месяца за счёт экономии на менеджерах.

Плюсы:

0% комиссии с платежей.
Автоматическое обновление статусов.
QR прямо на странице оплаты — клиент сканирует с другого устройства или жмёт «Открыть Kaspi» на мобильном.
Возвраты делаются через тот же API.
Можно интегрировать с CRM (1С, amoCRM, Bitrix24) через те же webhook'и.

Минусы:

Нужно писать код (или нанимать подрядчика).
Подписка на API-сервис от 10 000 ₸/мес.

Подробное руководство по подключению Kaspi Pay API.

Вариант 3: Hosted Checkout (для тех, кто не хочет программировать)

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

Ваш логотип, ваш бренд-цвет (настраивается в кабинете).
Сумма и описание заказа.
QR-код Kaspi + кнопка «Открыть в Kaspi».
Авто-редирект на ваш success_url после оплаты.

# Один POST — и готова страница оплаты
resp = requests.post(
    "https://api.paybot.kz/v2/payment-links",
    headers={"Authorization": f"Bearer {jwt}"},
    json={
        "amount": 15000,
        "description": "Заказ #1234",
        "success_url": "https://yourshop.kz/order/1234/done",
    },
)
checkout_url = resp.json()["url"]
# Отправили клиенту: WhatsApp, Telegram, SMS, email — где удобно.

Когда подходит: маленький магазин без полноценного бэкенда. Шаблон для платежей в Telegram-боте. Бизнес на маркетплейсе, который выставляет счета вручную, но хочет красивый чекаут.

Готовые виджеты и плагины

Для CMS существуют разные пути:

WordPress / WooCommerce

PayBot выпускает WooCommerce-плагин в формате Webhook Gateway — встраивается за 5 минут. Заказ из WooCommerce создаёт платёж в PayBot, статус обновляется автоматически. На момент апреля 2026 плагин в бете — пишите нам, если хотите потестировать.

Tilda

Есть готовая интеграция — публичная страница оплаты PayBot встраивается как iframe или редирект из Tilda-блока «Корзина». Подключается за 10 минут без программиста.

OpenCart / Bitrix / 1С-Битрикс

Здесь сценарий через webhook: пишется небольшой модуль, который при создании заказа делает POST на PayBot API, получает QR/ссылку и сохраняет статус. Готового плагина пока нет, но мы предоставляем код-снипет под конкретную CMS — оставьте заявку.

Кастомные сайты (Next.js, NestJS, Laravel, Django)

Базовый pattern — встроить виджет PayBot одной строкой:

<script src="https://paybot.kz/widget.js" data-key="kp_live_yourkey" data-amount="15000"></script>

Или использовать API напрямую, как в Варианте 2.

Стоимость для интернет-магазина

Пример: магазин на 500 заказов в месяц, средний чек 8 000 ₸ = оборот 4 000 000 ₸.

| Решение | Подписка | Комиссия | Итого расходов | |---|---|---|---| | Банковский эквайринг (2.5%) | 0 | 100 000 ₸ | 100 000 ₸/мес | | Kaspi вручную | 0 | 0 | 0 ₸, но 40 часов менеджера = 100 000–150 000 ₸ скрытых расходов | | Kaspi через PayBot Professional | 30 000 ₸ | 0 | 30 000 ₸/мес |

Разница на оборотах 4 млн ₸/мес — 70 000+ ₸ в пользу PayBot. На годовом обороте 48 млн ₸ — 840 000 ₸. Это покрывает половину зарплаты разработчика, которому вы заплатили за интеграцию.

Что важно знать про возвраты

Покупатель имеет право вернуть товар в течение 14 дней. Возврат через Kaspi:

Делается по тому же platежу (один API-вызов).
Деньги возвращаются на ту же карту Kaspi за 1–3 минуты.
Возможен частичный возврат — например, при возврате одного товара из заказа.
Ограничение Kaspi: возврат возможен в течение 90 дней с момента платежа.

Подробности — в статье о возвратах через Kaspi Pay API.

Чек-лист запуска интернет-магазина с Kaspi-оплатой

[ ] Открыт Kaspi Business на ИП/ТОО.
[ ] Заведён отдельный номер для роли «Кассир».
[ ] Выбран один из трёх вариантов интеграции (ручной / API / Hosted Checkout).
[ ] Зарегистрирован аккаунт в PayBot (если вариант 2 или 3).
[ ] Прошли SMS-онбординг (привязали Kaspi к аккаунту PayBot).
[ ] Сделан первый тестовый платёж в Sandbox.
[ ] Настроены webhook'и: статус заказа обновляется автоматически.
[ ] Настроена страница оплаты на сайте: QR + кнопка «Открыть Kaspi».
[ ] Логирование платежей в CRM или Google Sheets.
[ ] Описана процедура возвратов для менеджеров и клиентов.

Дальше

Если у вас уже работает интернет-магазин, и заказы выставляются вручную — посчитайте, сколько часов в месяц уходит на платежи. Если больше 20–30, автоматизация окупится за месяц.
Если только запускаете магазин — заранее закладывайте API-интеграцию. Перепрошить позже сложнее, чем сразу сделать правильно.
Если не уверены, какой вариант выбрать — оставьте заявку, менеджер посмотрит ваш сайт и подскажет, что подойдёт.

Если решили попробовать API самостоятельно — Sandbox-ключ доступен сразу после регистрации, без обязательств.