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

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

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

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

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

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

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

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

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

Мгновенные Webhook

Получайте уведомления о статусе платежа в реальном времени. HMAC-SHA256 подпись для безопасности.

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

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

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

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

Основные endpoints

Метод	Endpoint	Описание
POST	`/invoices`	Создание счёта
POST	`/invoices/qr`	QR-счёт без номера телефона (TTL ~5 минут)
GET	`/invoices`	Список счетов
GET	`/invoices/:id`	Детали счёта
POST	`/invoices/:id/cancel`	Отмена счёта
POST	`/invoices/:id/refund`	Возврат средств (полный/частичный) → примеры
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, а мы добавляем программный доступ.

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

Отдельный договор эквайринга с банком не нужен. Приём платежей идёт через ваш аккаунт Kaspi Pay с правами «Кассира» — это штатная функция Kaspi, подключается за пару минут в личном кабинете. Дальше вы выставляете счета по номеру телефона через API или вручную.

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

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