Платежи через Kaspi Pay по REST API

Приём платежей через Kaspi Pay без бюрократии

Подключите устройство Kaspi, получите API-ключ и начните принимать оплату — счета на телефон, платёжные ссылки и вебхуки. Без эквайринг-договоров и недель ожидания.

Создать аккаунт Смотреть API

Старт за минуты · Комиссия от 1% · Без абонентской платы

POST /v1/payments

curl -X POST https://pay.1app.kz/v1/payments \
  -H "Authorization: Bearer 1pay_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1500,
    "payer_phone": "+77011234567",
    "comment": "Заказ #1042",
    "merchant_order_id": "order_1042"
  }'

Подходит для приёма оплаты в любом бизнесе

Интернет-магазиныSaaS-сервисыДоставкаУслугиОбразование

Как это работает

От нуля до первого платежа — за четыре шага

Никаких интеграционных комитетов. Логика приёма уже готова — вам остаётся вызвать API.

Кассир в Kaspi

Используется ваш реальный аккаунт Kaspi Бизнес или кассир организации — деньги приходят напрямую к вам.

Подключите устройство

Добавьте «терминал» в дашборде: имя и телефон → приходит SMS-код → подтверждаете. Сессия живёт сама.

Создайте API-ключ

Привяжите ключ 1pay_live_… к устройству. Он показывается один раз — храните в секрете на бэкенде.

Принимайте платёж

Один POST /v1/payments — клиенту приходит счёт в Kaspi. Статус прилетит вам вебхуком.

Возможности

Всё для приёма платежей в одном API

Нормализованная модель поверх Kaspi: предсказуемые поля, статусы и события.

Счета на телефон

POST /v1/payments — покупатель получает счёт прямо в приложении Kaspi и подтверждает оплату.

Платёжные ссылки и QR

POST /v1/payments/link создаёт ссылку/QR — удобно для соцсетей, инвойсов и оффлайн-точек.

Вебхуки в реальном времени

События payment.completed, failed, refunded и др. с HMAC-подписью X-Webhook-Signature и ретраями.

Возвраты

POST /v1/refunds — полный или частичный возврат проведённого платежа одним вызовом.

Секреты под шифрованием

Ключи устройств и сессии Kaspi хранятся зашифрованными AES-256-GCM. API-ключи — только хеш.

Дашборд и статусы

Платежи, устройства, ключи и оборот в одном месте. Прозрачный маппинг статусов Kaspi → 1pay.

Тарифы

Платите меньше, когда растёте

Прозрачная ступенчатая комиссия по обороту. Никакой абонентской платы и скрытых сборов.

Базовый старт

Комиссия с платежа

4%→ 1%

Стартовая ставка 4%. По мере роста оборота ставка снижается ступенчато вплоть до 1%.

Зафиксированный 1% после 5 000 000 ₸

Как только суммарный оборот превысит 5 млн ₸, ставка фиксируется на уровне 1%.

Счета, ссылки/QR, возвраты
Вебхуки с HMAC-подписью
Неограниченное число устройств и ключей
Дашборд с оборотом и статусами

Начать бесплатно

Ступени комиссии по обороту

До 1 000 000 ₸4%

1 000 000 – 2 500 000 ₸3%

2 500 000 – 5 000 000 ₸2%

Свыше 5 000 000 ₸фикс1%

На этапе старта комиссия учитывается, но не списывается — вы видите её в дашборде для прозрачности расчётов.

Для разработчиков

Понятный REST API с предсказуемыми ответами

Авторизация по Bearer-ключу, JSON на входе и выходе, нормализованные статусы и идемпотентность по merchant_order_id.

Authorization: Bearer 1pay_live_…
Идемпотентность через merchant_order_id (409 при дубле)
Понятные коды ошибок: 400, 401, 402, 404, 409, 422
Вебхуки с ретраями 5с/30с и подписью HMAC-SHA256

Полная документация API

Запрос · POST /v1/payments

curl -X POST https://pay.1app.kz/v1/payments \
  -H "Authorization: Bearer 1pay_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1500,
    "payer_phone": "+77011234567",
    "comment": "Заказ #1042",
    "merchant_order_id": "order_1042"
  }'

Ответ · 201 Created

{
  "id": "pay_3kQ7v2",
  "status": "PENDING",
  "type": "invoice",
  "amount": 1500,
  "currency": "KZT",
  "payer_phone": "+77011234567",
  "merchant_order_id": "order_1042",
  "created_at": "2026-06-02T09:14:00Z"
}

Подключите Kaspi Pay сегодня

Регистрация занимает минуту. Добавьте устройство, получите ключ и сделайте первый платёж.

Создать аккаунт Изучить API