K
Kaspi Pay API подключение не начато
Kaspi Pay для сайтов, CRM, POS и Telegram

Принимайте платежи Kaspi Pay через понятный API

Выдавайте счета по телефону, показывайте QR-счета, принимайте возвраты, ведите каталог, запускайте подписки и получайте webhooks об оплате без хранения Kaspi-сессии в своей CRM.

Подключить бизнес Посмотреть методы
Sandbox сразу Тестовые счета работают до подключения Kaspi Business.
API ключи Сайт или CRM работает по `X-API-Key`, без Kaspi токенов.
Webhook подпись HMAC-SHA256 помогает проверить каждое событие оплаты.
Бизнес принимает онлайн-оплату
POST /api/v1/invoices POST /api/v1/invoices/qr POST /api/v1/subscriptions POST /api/v1/webhook/test

Методы как у полноценного payment API

Покрываем основные сценарии ApiPay-like интеграции: платежи, QR, возвраты, каталог, подписки и webhooks.

Счета и QR Создание, просмотр, список, отмена и ручная проверка статусов.
  • POST /invoices
  • POST /invoices/qr
  • GET /invoices
  • POST /invoices/status/check
Возвраты Полные и частичные возвраты, история по счету и по компании.
  • POST /invoices/{id}/refund
  • GET /invoices/{id}/refunds
  • GET /refunds
Каталог Товары, единицы измерения и изображения для заказов с корзиной.
  • GET /catalog/units
  • POST /catalog
  • PATCH /catalog/{id}
  • DELETE /catalog/{id}
Подписки Локальные recurring-сценарии и история счетов подписки.
  • POST /subscriptions
  • GET /subscriptions/{id}
  • POST /subscriptions/{id}/pause
  • GET /subscriptions/{id}/invoices
Webhooks Настройка URL, тестовое событие и HMAC-подпись payload.
  • POST /webhook/configure
  • POST /webhook/test
  • GET /webhook/configure
Sandbox Тестируйте success, cancel, expire и error без реального списания.
  • POST simulate: paid
  • POST simulate: expired
  • POST simulate: error
Счёт по телефону Клиент получает оплату в Kaspi, а ваш сайт видит статус через API.
QR на кассе Показывайте QR для POS, курьера, витрины или Telegram-бота.
Корзина и скидки `cart_items`, `subtotal`, `discount_sum` и `discount_percentage` сохраняются в счете.
Безопасное подключение Kaspi SMS проходит в личном кабинете, интеграции получают только API key.

Быстрый старт

Путь клиента должен быть понятным без созвона с разработчиком.

1. БизнесСоздайте личный кабинет и сохраните ключ интеграции.
2. SandboxСоздайте тестовый invoice или QR с `simulate=paid`.
3. KaspiПодключите номер кассира через SMS в кабинете.
4. WebhookПолучайте события оплаты и возврата с HMAC подписью.

Документация для разработчика

На странице есть готовые cURL-примеры, схема webhook-подписи и правила ошибок. В кабинете ключ подставится автоматически.

Минимальный запрос

curl -X POST /api/v1/invoices \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone_number":"87001234567","amount":5000,"is_sandbox":true}'

Webhook подпись

X-Webhook-Signature: sha256=<hmac>
rawBody + webhookSecret = trusted event