Kaspi Pay стал неотъемлемой частью электронной коммерции в Казахстане. Более 90% онлайн-покупок совершаются через эту платежную систему. Если вы ведете бизнес в Казахстане, интеграция Kaspi Pay - это не опция, а необходимость.
Почему Kaspi Pay критически важен:
- • 13.5 млн активных пользователей Kaspi.kz
- • 92% взрослого населения городов имеют Kaspi Gold
- • Мгновенные платежи через QR-код
- • Комиссия для бизнеса от 0.01% до 30%
⚠️ВАЖНО: Первый шаг - подача заявки на партнерство
Прежде чем начать техническую интеграцию, компания должна подать заявку и заключить договор с Kaspi Bank. Без официального партнерства доступ к API невозможен.
Подать заявку на партнерствоТребования к бизнесу для подключения
Юридические требования
- Зарегистрированное ИП или ТОО в Казахстане
- Действующий расчетный счет в банке РК
- Электронная цифровая подпись (ЭЦП)
- Документы о деятельности компании
Технические требования
- HTTPS сайт с SSL сертификатом
- Возможность установки IPSec VPN туннеля
- Backend для обработки webhook запросов
- Поддержка JSON и RESTful API
Процесс подключения (6-15 рабочих дней):
- 1
Подача заявки через kaspi.kz/webpay/partnership
Заполнение онлайн-формы с информацией о компании
- 2
Рассмотрение заявки (3-5 дней)
Проверка компании и оценка бизнеса
- 3
Заключение договора об участии
Подписание договора и предоставление документов
- 4
Получение доступа к тестовой среде
Тестовые API ключи и документация
- 5
Техническая интеграция и тестирование
Разработка, тестирование платежей
- 6
Настройка VPN и запуск в production
Получение production ключей и запуск
Типы QR-кодов в Kaspi Pay
Dynamic QR
Динамический QR-код для одной конкретной транзакции. Создается при каждом платеже с предзаполненными данными о товаре и сумме.
Использование:
- • Интернет-магазины
- • Оплата заказов
- • Выставление счетов
Static QR
Статический QR-код, привязанный к продавцу. Сумма вводится покупателем вручную при сканировании.
Использование:
- • Кассы в магазинах
- • Благотворительность
- • Услуги на месте
Custom QR
Кастомный QR-код с предзаполненными данными, но с возможностью изменения суммы. Требует метод checkout для расчета итоговой суммы.
Использование:
- • Сложные заказы
- • Расчет доставки
- • Дополнительные услуги
Refund QR
QR-код для возврата денежных средств. Используется при отмене заказа или частичном возврате.
Использование:
- • Отмена заказов
- • Возврат товара
- • Компенсации
| Параметр | Dynamic | Static | Custom | Refund |
|---|---|---|---|---|
| Сумма фиксирована | ||||
| Уникальный для каждой транзакции | ||||
| Можно повесить на витрине / распечатать | ||||
| Требует backend-генерации | ||||
| Webhook о платеже | ||||
| Подходит для e-com | ||||
| Подходит для офлайн-кассы | ||||
| Метод checkout (сложные суммы) |
Что внутри: интерфейс продукта
Это реальные скриншоты работающего интерфейса POS-автоматизации в mock-режиме. Имена клиентов фиктивные. Готовая платформа, в которую мы интегрируем вашу CRM/1С — не «нарисованные мокапы» из питча.
Дашборд. Три KPI-карточки, форма быстрого выставления счёта, sparkline трафика и последние 10 операций.
Выставление счёта
Форма с автодополнением контактов из CRM. Сумма, описание, источник — счёт уходит клиенту в WhatsApp/SMS за 5 секунд.
Счёт выставлен
Чип «Ожидает оплаты», ссылка на QR. После оплаты webhook возвращает статус в CRM автоматически.
QR-приёмник
Большой QR на экране кассы или планшета. Таймер 3:00, реактивный статус. Удобно для офлайн-точек.
Аналитика продаж
График за 7/30/90 дней, фильтры по точкам и менеджерам, экспорт. Сверка с бухгалтерией без ручного труда.
Работает с мобильного — менеджер выставляет счёт прямо со смартфона
Полнофункциональный мобильный интерфейс. Касса в кармане у менеджера или собственника бизнеса.
Дашборд
Форма счёта
QR-таб
Продажи
Поток платежа Kaspi Pay
Так выглядит классический сценарий «клиент → QR → деньги на счёт → webhook в CRM» при онлайн-эквайринге.
Методы интеграции Kaspi Pay
Для веб-сайтов
- ✓ JavaScript виджет Kaspi Pay
- ✓ REST API интеграция
- ✓ Готовые плагины для CMS
- ✓ QR-код генерация
Для мобильных приложений
- ✓ Native SDK для iOS/Android
- ✓ React Native модуль
- ✓ Flutter пакет
- ✓ Deep linking в Kaspi.kz
Готовые решения для популярных платформ:
1C-Битрикс
Модуль KPAY для CRM
WordPress/WooCommerce
Официальный плагин
InSales
Встроенная поддержка
Техническая реализация API
Базовые параметры API:
- Формат: RESTful API с JSON (кодировка UTF-8)
- Протокол: HTTPS с IPSec VPN туннелем
- Авторизация: Bearer token (получение через /auth/token)
- Идемпотентность: Обязательна для операций платежей
Основные API методы:
1. scan - Сканирование QR-кода
Метод для получения информации о платеже при сканировании QR-кода покупателем. Возвращает детали платежа и информацию о продавце.
POST /qr/v1/scan
Authorization: Bearer {token}
Content-Type: application/json
{
"qrData": "kaspi.kz/pay?id=ABC123XYZ",
"latitude": 43.238293,
"longitude": 76.945465
}
// Response
{
"code": "OK",
"message": "Success",
"data": {
"merchantId": "12345",
"merchantName": "Магазин Электроники",
"amount": 25000,
"currency": "KZT",
"orderId": "ORD-2025-0001",
"description": "Оплата заказа",
"qrType": "DYNAMIC"
}
}2. checkout - Расчет суммы платежа
Используется для Custom QR-кодов. Позволяет продавцу пересчитать сумму платежа с учетом доставки, скидок или дополнительных услуг.
POST /qr/v1/checkout
Authorization: Bearer {token}
Content-Type: application/json
{
"orderId": "ORD-2025-0001",
"items": [
{
"name": "Ноутбук HP",
"quantity": 1,
"price": 350000
}
],
"deliveryAmount": 5000,
"discountAmount": 15000
}
// Response
{
"code": "OK",
"totalAmount": 340000,
"breakdown": {
"subtotal": 350000,
"delivery": 5000,
"discount": -15000
}
}3. notifyPayment - Уведомление о платеже
Продавец уведомляет Kaspi Pay о результате обработки платежа (успех или отказ). Критично для завершения транзакции.
POST /qr/v1/notifyPayment
Authorization: Bearer {token}
Content-Type: application/json
{
"paymentId": "PAY-2025-ABC123",
"orderId": "ORD-2025-0001",
"status": "SUCCESS",
"amount": 340000,
"timestamp": "2025-10-10T12:30:00Z"
}
// Возможные статусы:
// SUCCESS - платеж подтвержден
// FAILED - платеж отклонен
// PENDING - в обработке
// Response
{
"code": "OK",
"message": "Payment processed successfully"
}4. refund - Возврат средств
API для возврата средств покупателю. Поддерживает полный и частичный возврат. Возврат бесплатен для продавца.
POST /payment/v1/refund
Authorization: Bearer {token}
Content-Type: application/json
{
"paymentId": "PAY-2025-ABC123",
"refundAmount": 170000, // Частичный возврат (50%)
"reason": "Возврат одного товара",
"refundId": "REF-2025-001" // Уникальный ID возврата
}
// Response
{
"code": "OK",
"refundId": "REF-2025-001",
"status": "PROCESSED",
"refundedAmount": 170000,
"remainingAmount": 170000,
"processedAt": "2025-10-10T14:00:00Z"
}Процесс авторизации и получения токена:
// 1. Получение токена авторизации
POST https://api.kaspi.kz/auth/token
Content-Type: application/x-www-form-urlencoded
grant_type=client_credentials
&client_id=YOUR_CLIENT_ID
&client_secret=YOUR_CLIENT_SECRET
// Response
{
"access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
"token_type": "Bearer",
"expires_in": 3600
}
// 2. Использование токена в запросах
GET https://api.kaspi.kz/qr/v1/payments
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...⚠️ Важно: Токены действительны 1 час. Реализуйте автоматическое обновление токена перед истечением срока действия для бесперебойной работы.
Настройка IPSec VPN туннеля
Для production среды требуется установка IPSec VPN соединения между вашим сервером и процессингом Kaspi. Это обеспечивает дополнительную безопасность.
Параметры VPN предоставляет Kaspi:
- • IP-адрес VPN шлюза
- • Pre-shared key (PSK)
- • Encryption algorithm (обычно AES-256)
- • Authentication method
Требования к вашей инфраструктуре:
- • Статический IP-адрес сервера
- • Firewall с поддержкой IPSec
- • Открыты порты UDP 500 и 4500
- • Доступ для настройки сетевого оборудования
Процесс оплаты через QR:
- 1Генерация уникального QR-кода продавцом
- 2Сканирование QR через приложение Kaspi.kz
- 3Вызов API scan для получения деталей
- 4Подтверждение платежа покупателем в приложении
- 5Обработка платежа продавцом
- 6notifyPayment с результатом обработки
- 7Зачисление средств на счет продавца (1-2 дня)
Требования безопасности:
- HTTPS обязателен для всех API запросов
- IPSec VPN туннель для production
- Электронная цифровая подпись (ЭЦП) для договоров
- Токены с ограниченным сроком (1 час)
- Идемпотентность операций (защита от дублирования)
- IP whitelist для production API
Возвраты и отмены платежей
Типы возвратов:
1. Полный возврат
Возврат всей суммы платежа. Используется при полной отмене заказа или возврате всех товаров.
Срок обработки: мгновенно (деньги возвращаются на счет покупателя в течение 1-3 дней)
2. Частичный возврат
Возврат части суммы. Применяется при возврате отдельных позиций из заказа или компенсации.
Можно делать несколько частичных возвратов до полной суммы платежа
⚠️ Важные правила по возвратам:
- • Возврат средств бесплатен для продавца (без комиссии)
- • Срок для возврата - до 30 календарных дней с момента платежа
- • После возврата комиссия Kaspi возвращается продавцу
- • Каждый возврат должен иметь уникальный refundId (идемпотентность)
- • Невозможно вернуть больше, чем было оплачено
Процедура разрешения споров:
Согласно правилам платежной системы Kaspi, предусмотрено 6 типов спорных ситуаций:
1. Несанкционированная операция
Операция совершена без согласия владельца карты/счета. Срок рассмотрения: 30 дней.
2. Товар/услуга не предоставлены
Покупатель оплатил, но не получил товар или услугу.
3. Неверная сумма списания
Списана сумма, отличающаяся от согласованной.
4. Товар не соответствует описанию
Полученный товар отличается от заявленного в описании.
5. Дублирование операции
Один платеж был списан несколько раз по ошибке.
6. Возврат не обработан
Продавец не вернул средства в установленный срок.
Порядок разрешения: Покупатель подает заявку через приложение Kaspi → Kaspi запрашивает информацию у продавца (3 рабочих дня на ответ) → Рассмотрение спора (до 30 дней) → Решение и возврат средств при необходимости
Стоимость интеграции и обслуживания
Комиссии Kaspi Pay для бизнеса:
Согласно официальным тарифам, комиссия зависит от типа бизнеса, объема транзакций и индивидуальных договоренностей с банком.
💳Процентная ставка
💰Фиксированная оплата
10,000 ₸
за одну операцию
Применяется для некоторых типов транзакций по согласованию
💡 Важно: Точная комиссия определяется индивидуально при заключении договора и зависит от отрасли, среднего чека, объема операций и типа бизнеса. Для крупных компаний с большим оборотом возможны специальные условия.
✅ Бесплатно: Возврат средств покупателю (refund) не облагается комиссией. При возврате комиссия, уплаченная за изначальную транзакцию, возвращается продавцу.
Стоимость технической интеграции (услуги OSN.KZ):
Базовая интеграция
- Kaspi Merchant API
- scan / notifyPayment
- Базовая обработка платежей
- Тестирование sandbox
- Документация
Профессиональная
- Всё из «Базовой»
- Все типы QR-кодов
- checkout / refund
- Кастомный UI/UX
- Интеграция CRM
- Аналитика платежей
POS-автоматизация
- CRM / 1С → автосчёт Kaspi
- Триггер по статусу заказа
- Webhook → CRM (статус оплаты)
- Привязка к карточке клиента
- Без терминала и кассира
- Bitrix24 / amoCRM / Salesforce
Enterprise
- Всё из «Профессиональной»
- IPSec VPN
- Multi-точечность
- Интеграция с 1С/ERP
- SLA 24/7
- Dedicated менеджер
| Возможность | Базовая | Проф. | POS-авто | Enterprise |
|---|---|---|---|---|
| Merchant API + scan/notifyPayment | ||||
| Все типы QR (B2C/B2B/PostPay) | ||||
| Refund / checkout | ||||
| Триггерное выставление счёта из CRM/1С | ||||
| Webhook возврата статуса оплаты | ||||
| Интеграция с Bitrix24 / amoCRM | +опция | |||
| Интеграция с 1С / ERP | +опция | |||
| IPSec VPN | ||||
| Мульти-точечность (5+ точек) | ||||
| SLA 24/7 + dedicated менеджер | ||||
| Срок запуска | 3–5 дн | 7–10 дн | 7–14 дн | от 14 дн |
Когда нужна POS-автоматизация?
Если ваш бизнес выставляет счета клиентам не через кассу/терминал, а из CRM/1С/ERP по триггеру — POS-автоматизация снимает с менеджера ручную работу и обнуляет потери из-за человеческого фактора.
Услуги по подписке
Автосчёт каждый месяц по статусу «продлить» в CRM. Без напоминаний менеджерам.
Оптовые продажи
1С формирует счёт → автоотправка QR клиенту в WhatsApp/SMS. Оплата = создание отгрузки.
Триггер по сделке
Bitrix24 переводит сделку в «выставить счёт» → автосчёт. Оплата = «закрыто успешно».
Дополнительные услуги:
Частые проблемы и решения
🔴 Проблема: API не возвращает данные о складских остатках
На момент 2025 года в Kaspi API отсутствует метод для изменения остатков на складе.
✅ Решение: Использовать feed-файл с обновлением раз в час или webhook для синхронизации.
🔴 Проблема: Долгая модерация магазина
Процесс модерации может занимать до 10 рабочих дней.
✅ Решение: Подготовить все документы заранее, использовать тестовый режим для разработки.
🔴 Проблема: Отмены заказов со стороны продавца
Kaspi имеет строгие правила по отменам - штрафы до 10% от суммы заказа.
✅ Решение: Автоматическая проверка наличия товара перед подтверждением заказа.
Почему интеграция Kaspi Pay увеличит продажи
Статистика конверсий:
+47% конверсия
При наличии Kaspi Pay vs только карты
+23% средний чек
Kaspi Red бонусы стимулируют покупки
-65% отказов
Снижение abandoned cart
Дополнительные возможности:
Kaspi Рассрочка 0-0-3
Платеж на 3 месяца без процентов
Kaspi Red бонусы
До 30% кэшбэк для покупателей
Kaspi Delivery
Интеграция с логистикой
Мгновенные выплаты
Деньги на счёт в течение 1 дня
Сценарии POS-автоматизации
Реальные клиентские сценарии. Имена не раскрываем (NDA), показываем профиль ниши.
HoReCaКофейня / бистро
Бариста выставляет счёт с планшета за 10 секунд, клиент платит по QR. Без терминала, без бумажных чеков. Касса в облаке.
B2B / УслугиМенеджер по продажам с CRM
Сделка в Bitrix24 переходит в статус «выставить счёт» → автосчёт уходит клиенту в WhatsApp. Менеджер не участвует.
РесторанРесторан премиум-сегмента
Официант показывает планшет со счётом гостю прямо за столом. Гость сканирует QR — оплата сразу в кассу.
E-commerceМагазин одежды с складом
Фаундер видит продажи и остатки со смартфона. Каждый заказ из 1С триггерит автосчёт. Сверка с бухгалтерией в один клик.
Запустим Kaspi Pay у вас
за 5 рабочих дней
50+ внедрений · средний срок 7 дней · поддержка после запуска включена
Бесплатная консультация 30 минут — без обязательств
Рассчитать стоимость интеграции
Опишите задачу — за 1 рабочий день вернёмся со схемой интеграции, точной стоимостью и сроками. Если задача типовая, дадим оценку в чате в течение часа.
- Оценка стоимости и сроков под вашу задачу
- Схема интеграции с вашей CRM/1С/ERP
- Чек-лист подготовки документов для Kaspi
- Бесплатно, без обязательств
Часто задаваемые вопросы
Сколько времени занимает интеграция Kaspi Pay?
Базовая интеграция (приём платежей через QR) — 3–5 рабочих дней. Профессиональная с кастомным UI и CRM — 7–10 дней. POS-автоматизация (триггер из CRM/1С → автосчёт) — 7–14 дней. Enterprise с IPSec VPN и 1С — от 14 дней. При срочной задаче можем закрыть базовую интеграцию за 1–2 дня (+50% к стоимости).
Чем POS-автоматизация отличается от обычного онлайн-эквайринга?
Онлайн-эквайринг — это форма оплаты на сайте/в приложении, инициированная клиентом. POS-автоматизация — это когда счёт генерируется по триггеру из вашей CRM/1С (например, статус сделки «выставить счёт») и автоматически отправляется клиенту через WhatsApp/SMS. После оплаты статус возвращается обратно в CRM. Менеджер не участвует в выставлении и проверке.
Нужна ли лицензия для работы с Kaspi Pay?
Нет, специальная лицензия не требуется. Достаточно зарегистрированного ИП или ТОО и договора с Kaspi Bank. Мы помогаем с подачей заявки и подготовкой документов — отдельная услуга 15 000 ₸.
Можно ли принимать платежи из-за рубежа?
Kaspi Pay работает только с картами и счетами казахстанских резидентов. Для международных платежей потребуется дополнительный платёжный шлюз — Stripe, Wayforpay, ePayments. Подключим параллельно по запросу.
Как тестировать интеграцию?
Kaspi предоставляет sandbox с тестовыми картами и QR-кодами. Все транзакции в тестовом режиме бесплатны. Мы поднимаем sandbox-окружение клиенту на отдельной ветке, проверяем все сценарии (оплата/отмена/возврат/частичный возврат) и только после этого выкатываем в прод.
Какие CRM и ERP вы поддерживаете для POS-автоматизации?
Готовые интеграции с Bitrix24, amoCRM, Kommo, Salesforce, HubSpot, Pipedrive, Zoho CRM, 1С (8.3, УТ, УНФ, ERP). Если вашей системы нет в списке — подключаем через Webhooks и API. Срок добавления новой CRM — обычно 3–5 дней дополнительно.
Что если в Kaspi API нет нужного метода (например, изменение остатков)?
Действительно, на 2025 год в Kaspi API нет метода обновления остатков. Решаем через feed-файл с обновлением раз в час или webhook-синхронизацию из вашей системы учёта. Это стандартное решение, не блокирующее.
Сколько Kaspi берёт комиссии и кто её платит?
Комиссия от 0.01% до 30% — зависит от ниши, оборота и переговоров с Kaspi. Стандарт для большинства бизнесов — около 1.95%. Маркетплейсы — 2.5–3.5%. Для крупных оборотов есть индивидуальные ставки. Refund (возврат покупателю) — бесплатно. Платит продавец.
Что вы делаете, если сайт уже работает с другим платёжным шлюзом?
Делаем миграцию: подключаем Kaspi параллельно (не отключая текущий), переключаем трафик постепенно, переносим историю транзакций и подписок. Минимальный простой 0–30 минут. Стоимость миграции — от 80 000 ₸ в зависимости от сложности.
Что если Kaspi заблокирует магазин — будут ли потери?
Все интеграции делаем с учётом возможности быстрого переключения на резервный шлюз (Wayforpay, Quickpay). Идемпотентность операций обязательна. Webhook-обработчики хранят все события, не теряются при downtime. При блокировке восстанавливаем поток за 1–2 часа на резервном шлюзе.
Есть ли поддержка после запуска?
Гарантия 30 дней включена в любой тариф. Дальше — техподдержка 50 000 ₸/мес: мониторинг 24/7, реакция на инциденты за 1 час, регулярные обновления под изменения Kaspi API. Для Enterprise — SLA 24/7 и dedicated менеджер.
Можно ли заказать только консультацию, без интеграции?
Да. Консультация — бесплатно. По итогам встречи получите чек-лист подготовки документов, схему интеграции под вашу архитектуру и оценку сроков/стоимости. Если решите делать своими силами — поможем советами без обязательств.
