Kaspi Pay REST API — Интеграция платежей для бизнеса

REST API для автоматизации приёма платежей через Kaspi Pay в Казахстане. Создавайте счета по номеру телефона и получайте уведомления об оплате вебхуком. Чеки через Kaspi ОФД, без скрытых комиссий.

ApiPay — независимый сервис автоматизации поверх вашего собственного Kaspi Pay: работает через штатную роль «Кассир», деньги идут напрямую на ваш Kaspi-счёт.

Начать бесплатно Документация API

Почему ApiPay.kz для Kaspi Pay интеграции?

Простая интеграция

Один API-вызов для создания счёта. Полная документация с примерами на JavaScript, Python, PHP. OpenAPI 3.0 спецификация.

Оплата по номеру телефона

Клиент получает push-уведомление в Kaspi.kz. Никаких QR-кодов, сканирования или ввода реквизитов.

Webhook о статусе платежа

Уведомление уходит на ваш URL сразу после смены статуса счёта; если сервер недоступен, доставка повторяется. Подпись HMAC-SHA256 по телу запроса.

Первый счёт — за 15 минут

Подключаетесь сами: роль «Кассир» в вашем Kaspi Pay, авторизация по SMS за ~1 минуту, при первом подключении включаются 3 бесплатных дня рабочего режима. Деньги идут напрямую на ваш Kaspi-счёт, чеки — через Kaspi ОФД.

Для кассира нужен отдельный номер: пока он привязан, входить в Kaspi Pay под этим номером нельзя — связь разорвётся. Требования к номеру кассира

API конфигурация

Параметр	Значение
Base URL	`https://api.apipay.kz/api/v1`
Аутентификация	Header `X-API-Key: ваш_ключ`
Rate Limit	200 запросов/минуту на API-ключ
Content-Type	`application/json`
Песочница	Бесплатно и без ограничения по времени; счета в Kaspi не уходят
Лимиты счетов	Счёт по номеру живёт 24 часа (описание ≤60 символов — Kaspi показывает покупателю только первые 60); QR-счёт — окно на скан меньше трёх минут, точный момент в qr_expires_at (описание ≤100)

Основные endpoints

Метод	Endpoint	Описание
POST	`/invoices`	Создание счёта
POST	`/invoices/qr`	QR-счёт без номера телефона (окно на скан — меньше трёх минут, qr_expires_at)
GET	`/invoices`	Список счетов
GET	`/invoices/:id`	Детали счёта
POST	`/invoices/:id/cancel`	Отмена счёта на номер телефона (QR-счёт отменить нельзя — он гаснет сам)
POST	`/invoices/:id/refund`	Возврат средств (полный/частичный) — уходит на полную сумму платежа, свою комиссию за приём Kaspi удержал при оплате, поэтому на Kaspi-счёте нужен запас → примеры
POST	`/subscriptions`	Создать подписку → примеры

Создание счёта — один API-вызов

// JavaScript / Node.js
const response = await fetch('https://api.apipay.kz/api/v1/invoices', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: 15000,
    phone_number: '87001234567',
    description: 'Оплата заказа #123'
  })
})

const { id, amount, status, created_at } = await response.json()
// status: "processing" — это норма: счёт создаётся асинхронно.
// Итог (pending → paid) придёт вебхуком invoice.status_changed — поллинг не нужен.

Каспи АПИ: как получить доступ

Разработчики ищут «каспи апи» по-разному: REST API Kaspi Pay, апи каспи пей, рест апи каспи, каспи пей апи — речь об одном и том же: как программно принимать платежи через Kaspi. У самого Kaspi публичного API для приёма платежей нет — есть Shop API для маркетплейса Kaspi и QR-регламент по договору. ApiPay закрывает этот разрыв: это независимый REST API поверх вашего Kaspi Pay. Он подключается с правами «Кассира» (штатная функция Kaspi) и позволяет выставлять счета по номеру телефона, получать webhooks и вести каталог.

Частые вопросы про АПИ Каспи

Есть ли у Каспи официальное АПИ?

Для маркетплейса Kaspi (Kaspi Shop) — да, у продавцов есть Shop API. Для приёма платежей через Kaspi Pay публичного API у Kaspi нет: прямая интеграция возможна по договору. ApiPay — независимый сервис, который даёт REST API поверх вашего Kaspi Pay: вы работаете с привычным Kaspi Pay, а мы добавляем программный доступ.

Нужен ли договор с банком, чтобы подключить АПИ Каспи?

ApiPay работает через штатную роль «Кассир» в вашем собственном Kaspi Pay: сотрудник с правами выставлять счета, смотреть статусы и делать возвраты. Роль подключается за пару минут в личном кабинете, дальше вы выставляете счета по номеру телефона через API или вручную — деньги приходят на ваш Kaspi-счёт на действующих условиях вашего Kaspi Pay. Какие документы нужны именно вашему бизнесу — вопрос к вашему юристу.

Сколько стоит рест апи каспи пей?

ApiPay не берёт процент с оборота — оплата по фиксированной подписке: Старт 10 000 ₸/мес, Бизнес 25 000 ₸/мес, Про 60 000 ₸/мес, Про Макс 90 000 ₸/мес. Полная документация — в разделе API.