Гайд

Есть ли API у Kaspi и как принимать оплату программно

6 июня 2026 г.·2 мин чтения

Короткий ответ: публичного официального API у Kaspi нет — нельзя зарегистрироваться как разработчик и получить ключ напрямую от Kaspi. Но принимать оплату через Kaspi из кода всё равно можно: AgentPay даёт REST API, CLI и вебхуки поверх обычного кассира Kaspi Pay.

Почему у Kaspi нет API

Kaspi Pay — это приложение для приёма оплаты, а не платёжный шлюз с документацией для разработчиков. Нет публичного REST API, нет sandbox, нет вебхуков. Каждый платёж кассир подтверждает вручную в приложении. Для разработчика, который хочет встроить приём Kaspi в свой продукт, это тупик.

AgentPay закрывает этот разрыв честно: мы не выдаём себя за «официальный API Kaspi». Технически мы автоматизируем работу обычного кассира, которого вы сами подключаете. Деньги идут напрямую на ваш Kaspi-счёт — AgentPay их не касается.

Кассир в Kaspi Pay физически не может видеть баланс, делать переводы или заходить в личный кабинет. Худшее, что технически возможно — выставить счёт на ваш номер. Украсть деньги нельзя.

Что умеет API AgentPay

• Создавать счета и получать pay_link_url — ссылку, которая открывает Kaspi в один тап;
• Получать статус оплаты — не опросом, а подписанными вебхуками (событие invoice.paid);
• Отменять и возвращать платежи (cancel, refunds);
• Запускать подписки и регулярные счета;
• Слушать события локально через CLI agentpay listen — без публичного URL.

Первый запрос

Подключите кассира в веб-кабинете, создайте ключ sk_test_* в настройках — и сделайте POST на /v1/invoices:

curl -X POST https://agentpay.kz/api/v1/invoices \
  -H "Authorization: Bearer sk_test_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "client_phone": "77001234567",
    "amount_kzt": 1500,
    "comment": "Заказ #42"
  }'

В ответе придёт JSON с полем pay_link_url — это ссылка для клиента. Параллельно Kaspi отправит push на телефон клиента. Все запросы к /v1/* требуют заголовок Authorization: Bearer, а мутирующие POST — Idempotency-Key (UUID на каждую логическую операцию).

Не хотите писать код?

Тот же приём оплаты доступен через веб-кабинет и CLI. CLI @kaspi-agentpay/cli повторяет весь API одной командой — удобно и для людей, и для AI-агентов (Claude Code, Cursor), которым достаточно скормить /api/docs.md.