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

Кому подходит

Везде, где вы принимаете деньги от клиента в Казахстане и хотите, чтобы заказ подтверждался без участия человека.

Telegram-боты

Бот выставляет счёт и выдаёт заказ сразу, как только придёт вебхук.

Интернет-магазины

Оплата без платёжной страницы: счёт открывается в приложении Kaspi у покупателя.

Заведения и услуги

Счёт по номеру телефона прямо из кабинета — без терминала и без кода.

CRM и внутренние системы

Один REST-запрос из той системы, в которой уже работает ваша команда.

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

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 секунд до часа
✓Полный лог доставок в дашборде

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

0% комиссии

Мы не берём процент с вашего оборота

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