Kaspi Pay · Казахстан

Приём Kaspi Pay через один REST API

Выставляйте счета из своего сайта, CRM или бота. Покупатель платит в приложении Kaspi, ваш бэкенд получает подписанный вебхук. Деньги идут напрямую на ваш счёт Kaspi — yespay их не касается.

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

Тестовый ключ выдаётся сразу при регистрации — кассир Kaspi для старта не нужен.

bash

curl -X POST https://api.getyespay.com/v1/payments \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ORDER-1001" \
  -d '{
    "amount": 14990,
    "currency": "KZT",
    "customer": { "phone": "+77001234567" },
    "order_id": "ORDER-1001"
  }'

Через несколько секунд после оплаты придёт вебхук payment.paid

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

yespay — прослойка между вашим приложением и Kaspi Pay. Мы подключаемся с правами штатной роли «Кассир», создаём счета и следим за их статусом.

Подключаете кассира

Один раз, в кабинете: вводите номер сотрудника с ролью «Кассир», подтверждаете код из SMS. Занимает минуту.

Создаёте платёж

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

Получаете вебхук

Как только покупатель оплатил, ваш бэкенд получает подписанное событие payment.paid. Отгружаете заказ.

Движение денег

Покупатель

платит→

Kaspi

деньги→

ВАШ счёт Kaspi Business

запрос на оплату ↑

вебхук payment.paid ↓

Ваш сайт

У yespay нет расчётного счёта в этой цепочке и нет возможности задержать средства.

Что внутри

Идемпотентность

Заголовок Idempotency-Key защищает от двойного счёта при ретрае. У Kaspi своей идемпотентности нет — мы делаем её за вас.

Подписанные вебхуки

HMAC-SHA256 по сырому телу, метка времени внутри подписи. Повтор перехваченного запроса не сработает.

Честные статусы

Если Kaspi вернул статус, который мы не знаем, платёж уходит в unknown и поднимает алерт — но никогда не помечается «неуспешным».

Песочница

Тестовый ключ сразу после регистрации. Полный цикл на тестовых номерах без реального кассира и без денег.

Возвраты

Полный возврат одним запросом, синхронно. Чек возврата возвращается ссылкой.

Дашборд

Платежи, счета, возвраты, ключи, логи доставки вебхуков и состояние подключения Kaspi.

Ваш бэкенд узнаёт об оплате сам

Не нужно опрашивать статус в цикле. Как только покупатель оплатил, мы отправляем событие на ваш URL и повторяем доставку с экспоненциальной задержкой, пока не получим 2xx.

✓Подпись X-Yespay-Signature — HMAC по сырому телу
✓Дедупликация по X-Yespay-Event-Id
✓До 6 попыток: от 5 секунд до часа
✓Полный лог доставок в дашборде

Как проверять подпись →

json

{
  "id": "evt_9F2K...",
  "type": "payment.paid",
  "createdAt": "2026-09-06T08:00:37Z",
  "livemode": true,
  "data": {
    "id": "pay_7K3M...",
    "status": "paid",
    "amount": 14990,
    "currency": "KZT",
    "order_id": "ORDER-1001"
  }
}