Kaspi Pay интеграция: всё что нужно знать в 2026

TL;DR. Kaspi Pay в 2026 — обязательный платёжный метод для любого онлайн-бизнеса в Казахстане. Через Kaspi проходит около 62% всех онлайн-платежей в KZ. Интеграция занимает 5–14 дней в зависимости от продукта (Kaspi QR, Kaspi Red, рассрочка). Комиссия — 0,95–2,95% в зависимости от тарифа.

Что такое экосистема Kaspi для бизнеса

Kaspi.kz объединяет несколько продуктов, которые часто называют общим «Kaspi Pay»:

• Kaspi QR — оплата через приложение Kaspi.kz сканированием QR-кода. Самый популярный метод (45% всех онлайн-платежей).
• Kaspi Pay — карта с быстрой оплатой (аналог Apple Pay, но для Kaspi-карт).
• Kaspi Red — кредитная карта с лимитом, оплата онлайн с одобрением за 30 секунд.
• Kaspi Рассрочка — 2-3-6-12 месяцев без переплаты, продавец платит комиссию.
• Kaspi Эквайринг — приём карт Visa/MC через Kaspi-процессинг.

Многие клиенты используют все 4–5 методов одновременно для максимального охвата.

Что нужно для интеграции

1. Юридическая часть

• ТОО или ИП с действующим БИН
• Расчётный счёт в любом банке (необязательно в Kaspi)
• Подписанный договор-оферта с Kaspi.kz
• Налоговое резидентство в РК

2. Технические требования

• HTTPS на сайте (обязательно, иначе Kaspi не подключит)
• Возможность принимать webhook на ваш бэкенд (HTTP POST)
• Стабильный uptime > 99,5%

3. Документация и подписание

Заявка на сайте Kaspi.kz → проверка юрлица (1–3 дня) → подписание договора через ЭЦП → получение мерчант-аккаунта и API-ключей.

Технические нюансы интеграции

Kaspi QR / Kaspi Pay (Pay API)

Стандартный flow:

1. Клиент оформляет заказ, нажимает «Оплатить через Kaspi»
2. Ваш бэкенд через REST API создаёт «invoice» в Kaspi
3. Kaspi возвращает payment_url или QR-код
4. Клиент видит QR-код на странице или открывает приложение Kaspi.kz
5. После оплаты Kaspi присылает webhook на ваш URL
6. Вы проверяете подпись webhook (HMAC-SHA256) и подтверждаете заказ

Подпись проверять обязательно — иначе любой может подделать webhook «оплачено» и получить товар бесплатно. В нашей практике 2 из 12 проектов миграции от прошлых подрядчиков имели такую уязвимость.

Kaspi Рассрочка

Отдельный API. Особенности:

• Период рассрочки задаёт продавец (2, 3, 6, 12 мес)
• Комиссия выше: 4–8% против 0,95% базового тарифа
• Минимальная сумма заказа — ₸ 5 000
• Решение об одобрении принимает Kaspi за 30–60 секунд
• Оплата клиенту приходит полностью на ваш счёт сразу — Kaspi сам забирает рассрочку у клиента

Тарифы Kaspi (актуально на 2026)

• Kaspi QR / Kaspi Pay: 0,95% от суммы транзакции
• Kaspi Эквайринг (Visa/MC): 1,95–2,45%
• Kaspi Red: 1,45%
• Kaspi Рассрочка 2-3 мес: 4%
• Kaspi Рассрочка 6 мес: 6%
• Kaspi Рассрочка 12 мес: 8–10%

Для оборота свыше ₸ 50 млн / мес возможно индивидуальное обсуждение тарифов.

Сколько стоит интеграция

Цена зависит от платформы сайта и количества методов оплаты:

• WordPress / WooCommerce с готовым плагином: ₸ 80 000 – 150 000
• 1С-Битрикс через готовый модуль: ₸ 120 000 – 220 000
• OpenCart через плагин: ₸ 100 000 – 180 000
• Custom (Laravel, Next.js, Symfony): ₸ 180 000 – 350 000
• Все 4 метода Kaspi + интеграция с 1С: ₸ 350 000 – 650 000

Сколько времени занимает

• Подача документов + проверка Kaspi: 1–5 рабочих дней
• Разработка интеграции: 3–10 рабочих дней
• Тестирование (Kaspi sandbox): 2–4 дня
• Production-релиз: 1 день

Итого: от 1 до 3 недель от старта до приёма платежей.

Частые подводные камни

1. Webhook не доходит

Kaspi отправляет webhook на ваш URL. Если ваш сервер в этот момент перегружен или вернул 5xx — Kaspi повторит 3 раза с интервалом 15 минут, потом перестанет пытаться. Решение: idempotent webhook handler + повторный сбор статусов через GET /payment/{id}.

2. Игнорирование сверки

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

3. Курс и комиссии в чеке

Если вы продаёте в USD/EUR, Kaspi конвертирует в KZT по своему курсу с маржой. Учитывайте это в ценообразовании.

4. Отмена и возврат

Возврат через Kaspi API доступен только в течение 14 дней. Дальше — только через бухгалтерию вручную.

5. Лимиты на оплату

Одноразовый лимит Kaspi QR — ₸ 1 000 000. Для крупных B2B-заказов нужно разбивать оплату или использовать счёт на оплату через Kaspi B2B.

Тестирование

Kaspi предоставляет sandbox-окружение с тестовыми картами. Обязательно протестируйте:

• Успешную оплату
• Отклонение оплаты
• Прерванную оплату (клиент закрыл приложение)
• Webhook с задержкой 5+ минут
• Полный и частичный возврат
• Идемпотентность (повторный webhook с тем же payment_id)

Резюме

Kaspi Pay в Казахстане — это не «один из методов», а основной канал онлайн-оплат. Без него ваш интернет-магазин или сервис теряет 50–70% потенциальных клиентов. Интеграция занимает 1–3 недели и стоит от ₸ 80 000 до ₸ 650 000 в зависимости от сложности.

Если хотите — мы делаем интеграцию Kaspi Pay под ключ на любой платформе. Включая сверку, обработку возвратов и интеграцию с 1С / CRM.