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-код для возврата денежных средств. Используется при отмене заказа или частичном возврате.
Использование:
- • Отмена заказов
- • Возврат товара
- • Компенсации
Методы интеграции 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 Pay API
- ✓ Реализация scan/notifyPayment
- ✓ Базовая обработка платежей
- ✓ Тестирование в sandbox
- ✓ Документация интеграции
- ✓ Срок: 3-5 дней
Профессиональная
- ✓ Все из Базовой
- ✓ Все типы QR-кодов
- ✓ API checkout/refund
- ✓ Кастомный UI/UX
- ✓ Интеграция с вашей CRM
- ✓ Аналитика платежей
- ✓ Обработка споров
- ✓ Срок: 7-10 дней
Enterprise
- ✓ Все из Профессиональной
- ✓ Настройка IPSec VPN
- ✓ Мультиточечная интеграция
- ✓ Интеграция с 1С/ERP
- ✓ Автоматизация процессов
- ✓ SLA и поддержка 24/7
- ✓ Выделенный менеджер
- ✓ Срок: от 14 дней
Дополнительные услуги:
Частые проблемы и решения
🔴 Проблема: 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 дня
Готовы подключить Kaspi Pay?
Наша команда имеет опыт интеграции Kaspi Pay для 50+ проектов. Мы знаем все нюансы и поможем избежать типичных ошибок.
Часто задаваемые вопросы
Сколько времени занимает интеграция Kaspi Pay?
Базовая интеграция занимает 3-5 рабочих дней. Сложные кастомные решения с интеграцией в ERP системы могут занять до 3 недель.
Нужна ли лицензия для работы с Kaspi Pay?
Нет, специальная лицензия не требуется. Необходимо зарегистрировать ИП или ТОО и заключить договор с Kaspi Bank.
Можно ли принимать платежи из-за рубежа?
Kaspi Pay работает только с картами и счетами казахстанских резидентов. Для международных платежей потребуется дополнительный платежный шлюз.
Как тестировать интеграцию?
Kaspi предоставляет тестовую среду (sandbox) с тестовыми картами и QR-кодами. Все транзакции в тестовом режиме бесплатны.