REST API для вашего бизнеса: QR-коды, счета по номеру телефона, готовый checkout-виджет, возвраты, вебхуки и панель управления.
# 1. Создаём checkout-сессию
POST /api/v1/checkout
X-Api-Key: sk_live_xxxx
{ "amount": 5000, "comment": "Заказ №123",
"success_url": "https://myshop.kz/ok" }
← 201 { "checkout_url": "https://pay.superapp.kz/pay/..." }
# 2. Или напрямую создаём invoice
POST /api/v1/customers/lookup
{ "phone": "+77781234567" }
← 200 { "found": true, "name": "Иванов Иван" }
POST /api/v1/payments
{ "type": "invoice", "amount": 5000,
"customer_phone": "77781234567", "cashier_id": 1 }
← 201 { "status": "PENDING" }
# 3. Вебхук после оплаты
POST https://myshop.kz/webhook
X-Gateway-Signature: hmac-sha256=...
{ "event": "payment.success",
"data": {
"status": "SUCCESS",
"amount": 5000,
"paid_at": "2026-06-07T09:03:00+05:00"
}
}
Реальный платёж на 1 ₸ — без регистрации
К оплате
1 ₸
Тестовая оплата · pay.superapp.kz
Используются реальные данные первого мерчанта · Kaspi Pay live-режим
Один сервис — все инструменты
Invoice на Kaspi-номер клиента. Он получает пуш и оплачивает в пару касаний. Поддержка отмены PENDING-счёта через API.
Генерируйте QR для касс, сайтов и витрин. Клиент сканирует Kaspi-камерой и платит мгновенно.
Один запрос → готовая страница оплаты. Клиент сам выбирает способ. Редирект после оплаты на ваш сайт.
Полный или частичный возврат по QR-платежу. Деньги возвращаются клиенту автоматически.
5 событий: success, failed, expired, cancelled, refunded. HMAC-SHA256 подпись. 3 попытки доставки.
Проверьте номер до создания invoice — убедитесь что клиент зарегистрирован в Kaspi Pay.
Список платежей с фильтрами, кассиры, вебхуки, checkout. Всё доступно по API с пагинацией.
Публичный /api/health: статус Kaspi Node, uptime 24ч / 7д, среднее время ответа.
sk_test_ для разработки без реальных запросов. sk_live_ для продакшена. Одинаковый код.
Выберите подходящий
Создаёте сессию → редиректите клиента → он платит → вы получаете вебхук. Минимум кода.
POST /api/v1/checkout
Полный контроль над UI. Сами генерируете QR или отправляете invoice, сами показываете интерфейс.
POST /api/v1/payments
Полный REST API — от создания до возврата
POST /api/v1/checkout
X-Api-Key: sk_live_xxx
{ "amount": 5000, "comment": "Заказ №123",
"success_url": "https://myshop.kz/ok",
"expires_in": 15 }
← 201 { "checkout_url": "https://pay.superapp.kz/pay/...",
"expires_at": "2026-06-07T10:15:00+05:00" }POST /api/v1/payments
X-Api-Key: sk_live_xxx
{ "type": "invoice", "amount": 5000,
"cashier_id": 3,
"customer_phone": "77771234567",
"comment": "Заказ №123" }
← 201 { "id": "01J4KXYZ...", "status": "PENDING" }GET /api/v1/payments?status=SUCCESS
&date_from=2026-06-01&per_page=50
X-Api-Key: sk_live_xxx
← 200 { "data": [...],
"meta": { "total": 248, "last_page": 5 } }POST /api/v1/customers/lookup
X-Api-Key: sk_live_xxx
{ "phone": "+77781234567" }
← 200 { "found": true,
"name": "Иванов Иван",
"phone": "+77781234567" }// На ваш сервер:
POST https://myshop.kz/webhook
X-Gateway-Signature: hmac-sha256=...
{ "event": "payment.success",
"data": { "status": "SUCCESS",
"amount": 5000,
"paid_at": "2026-06-07T09:03:21+05:00" } }/api/health
/api/v1/payments
/api/v1/payments
/api/v1/payments/{id}
/api/v1/payments/{id}/cancel
/api/v1/payments/{id}/refund
/api/v1/cashiers
/api/v1/customers/lookup
/api/v1/checkout
/api/v1/checkout/{token}
/api/v1/webhooks
/api/v1/webhooks
/api/v1/webhooks/{id}
/api/v1/webhooks/{id}/test
/api/v1/webhooks/{id}
Подписывайтесь только на нужные
Тестовый режим бесплатно. Первый платёж — за несколько минут.