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

Приём оплаты через Kaspi Pay — за минуты, не недели

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

Создать аккаунт Смотреть API
10 000 ₸ за первого кассираКомиссия 4% → 1%Без абонентской платы
POST /v1/payments
{
  "amount": 12500,
  "payer_phone": "+7 701 123 45 67",
  "comment": "Заказ #1042"
}
201 Created · 240 ms PENDING
payment.completed · ₸ 12 500qr · ₸ 4 900payment.completed · ₸ 89 000refund · ₸ 1 200invoice · ₸ 25 000payment.completed · ₸ 7 350subscription · ₸ 9 990payment.completed · ₸ 156 000link · ₸ 3 400payment.completed · ₸ 12 500qr · ₸ 4 900payment.completed · ₸ 89 000refund · ₸ 1 200invoice · ₸ 25 000payment.completed · ₸ 7 350subscription · ₸ 9 990payment.completed · ₸ 156 000link · ₸ 3 400
01 — Как это работает

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

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

01

Кассир Kaspi

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

02

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

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

03

Выпустите API-ключ

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

04

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

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

02 — Возможности

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

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

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

POST /v1/payments — покупатель получает счёт прямо в приложении Kaspi и подтверждает оплату. Платёжные ссылки и QR для соцсетей, инвойсов и оффлайн-точек.

Счёт

QR

Ссылка

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

payment.completed, failed, refunded и др. с HMAC-подписью и ретраями.

Возвраты

Полный или частичный возврат проведённого платежа одним вызовом.

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

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

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

Платежи, устройства, ключи, подписки и оборот — в одном месте.

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

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

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

  • Authorization: Bearer 1pay_live_…
  • Идемпотентность по merchant_order_id (409 при дубле)
  • Коды ошибок: 400, 401, 402, 404, 409, 422
  • Вебхуки с ретраями и подписью 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": 12500,
    "payer_phone": "+77011234567",
    "comment": "Заказ #1042",
    "merchant_order_id": "order_1042"
  }'
Ответ · 201 Created
{
  "id": "pay_3kQ7v2",
  "status": "PENDING",
  "type": "invoice",
  "amount": 12500,
  "currency": "KZT",
  "payment_link": "https://pay.kaspi.kz/pay/abc123",
  "created_at": "2026-06-06T09:14:00Z"
}
04 — Тарифы

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

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

Базовый старт
4%→ 1%

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

10 000 ₸ на баланс за первого кассира

Подключите первого кассира Kaspi — начислим бонус на баланс комиссии. Это ≈ 250 000 ₸ оборота без вашей оплаты (при 4%).

  • Счета, ссылки/QR, возвраты
  • Вебхуки с HMAC-подписью
  • Неограниченно устройств и ключей
  • Дашборд с оборотом и статусами
Начать бесплатно
Ступени по обороту
до 1 000 000 ₸4%
1 000 000 – 2 500 000 ₸3%
2 500 000 – 5 000 000 ₸2%
свыше 5 000 000 ₸фикс1%

Комиссия списывается с предоплаченного баланса. Деньги покупателей идут вам на Kaspi напрямую — мы берём только комиссию.

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

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

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