Интеграция Kaspi Pay: полное руководство для бизнеса 2025

Kaspi.kz — крупнейший банк Казахстана с 13+ млн активных пользователей. Подключим Kaspi Pay к сайту, CRM или 1С: онлайн-эквайринг, POS-автоматизация, миграция с других шлюзов.

Kaspi Pay стал неотъемлемой частью электронной коммерции в Казахстане. Более 90% онлайн-покупок совершаются через эту платежную систему. Если вы ведете бизнес в Казахстане, интеграция Kaspi Pay - это не опция, а необходимость.

Требования к бизнесу для подключения

Процесс подключения (6-15 рабочих дней):

1. Подача заявки через kaspi.kz/webpay/partnership

   Заполнение онлайн-формы с информацией о компании

2. Рассмотрение заявки 3-5 дней

   Проверка компании и оценка бизнеса

3. Заключение договора об участии

   Подписание договора и предоставление документов

4. Получение доступа к тестовой среде

   Тестовые API ключи и документация

5. Техническая интеграция и тестирование

   Разработка, тестирование платежей

6. Настройка VPN и запуск в production

   Получение production ключей и запуск

Типы QR-кодов в Kaspi Pay

Что внутри: интерфейс продукта

Это реальные скриншоты работающего интерфейса POS-автоматизации в mock-режиме. Имена клиентов фиктивные. Готовая платформа, в которую мы интегрируем вашу CRM/1С — не «нарисованные мокапы» из питча.

Дашборд. Три KPI-карточки, форма быстрого выставления счёта, sparkline трафика и последние 10 операций.

Работает с мобильного — менеджер выставляет счёт прямо со смартфона

Полнофункциональный мобильный интерфейс. Касса в кармане у менеджера или собственника бизнеса.

Поток платежа Kaspi Pay

Так выглядит классический сценарий «клиент → QR → деньги на счёт → webhook в CRM» при онлайн-эквайринге.

1. Клиент

   мобильник

2. Ваш сайт / CRM

   выставляет QR

3. Kaspi Merchant API

   scan / checkout

4. Kaspi.kz приложение

   подтверждение

5. Расчёт Kaspi

   списание / зачисление

notifyPayment webhook → создание сделки / отгрузки / закрытие в CRM

Методы интеграции Kaspi Pay

Готовые решения для популярных платформ:

Техническая реализация API

Основные 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...

Настройка IPSec VPN туннеля

Для production среды требуется установка IPSec VPN соединения между вашим сервером и процессингом Kaspi. Это обеспечивает дополнительную безопасность.

Процесс оплаты через QR:

1. Генерация уникального QR-кода продавцом
2. Сканирование QR через приложение Kaspi.kz
3. Вызов API scan для получения деталей
4. Подтверждение платежа покупателем в приложении
5. Обработка платежа продавцом
6. notifyPayment с результатом обработки
7. Зачисление средств на счет продавца (1-2 дня)

Требования безопасности:

• HTTPS обязателен для всех API запросов
• IPSec VPN туннель для production
• Электронная цифровая подпись (ЭЦП) для договоров
• Токены с ограниченным сроком (1 час)
• Идемпотентность операций (защита от дублирования)
• IP whitelist для production API

Возвраты и отмены платежей

Типы возвратов:

Процедура разрешения споров:

Согласно правилам платежной системы Kaspi, предусмотрено 6 типов спорных ситуаций:

1. Несанкционированная операция — Операция совершена без согласия владельца карты/счета. Срок рассмотрения: 30 дней.
2. Товар/услуга не предоставлены — Покупатель оплатил, но не получил товар или услугу.
3. Неверная сумма списания — Списана сумма, отличающаяся от согласованной.
4. Товар не соответствует описанию — Полученный товар отличается от заявленного в описании.
5. Дублирование операции — Один платеж был списан несколько раз по ошибке.
6. Возврат не обработан — Продавец не вернул средства в установленный срок.

Порядок разрешения: Покупатель подает заявку через приложение Kaspi → Kaspi запрашивает информацию у продавца (3 рабочих дня на ответ) → Рассмотрение спора (до 30 дней) → Решение и возврат средств при необходимости

Стоимость интеграции и обслуживания

Комиссии Kaspi Pay для бизнеса:

Согласно официальным тарифам, комиссия зависит от типа бизнеса, объема транзакций и индивидуальных договоренностей с банком.

Стоимость технической интеграции (услуги OSN.KZ):

Когда нужна POS-автоматизация?

Если ваш бизнес выставляет счета клиентам не через кассу/терминал, а из CRM/1С/ERP по триггеру — POS-автоматизация снимает с менеджера ручную работу и обнуляет потери из-за человеческого фактора.

OSN.kz не аффилирован с АО «Kaspi Bank». Интеграции выполняются на инфраструктуре заказчика. Заказчик подтверждает наличие зарегистрированного мерчантского аккаунта Kaspi Pay.

Дополнительные услуги:

Частые проблемы и решения

Почему интеграция Kaspi Pay увеличит продажи

Статистика конверсий:

Дополнительные возможности:

• Kaspi Рассрочка 0-0-3 — Платеж на 3 месяца без процентов
• Kaspi Red бонусы — До 30% кэшбэк для покупателей
• Kaspi Delivery — Интеграция с логистикой
• Мгновенные выплаты — Деньги на счёт в течение 1 дня

Сценарии POS-автоматизации

Реальные клиентские сценарии. Имена не раскрываем (NDA), показываем профиль ниши.

Частые вопросы