Kaspi Pay invoice
из вашего кода.

Четыре шага от установки до первой оплаты.

SMS приходит на ваш собственный номер ИП или ТОО. Сессия живёт, пока вы не разлогинились или не вошли в Kaspi Pay на смартфоне — тогда мы возвращаем 412 kaspi_session_required и просим пройти SMS снова.

1. 01

   SMS-авторизация в Telegram-боте

   Открываете @PayProverkaBot, отправляете номер ИП/ТОО, вводите код из SMS. Получаете персональный X-API-Key.

   $ /login → 87019009393 → 123456
2. 02

   Выставляете счёт через API

   POST на /v1/invoice/create с номером клиента и корзиной. В ответ — paymentId, по которому отслеживаете статус.

   › phoneNumber + items[] ⟶ paymentId
3. 03

   Клиент платит в один клик в Kaspi.kz

   Клиенту приходит push в приложение Kaspi.kz. Он подтверждает оплату пальцем — комиссии стандартные эквайринговые, никаких посредников.

4. 04

   Вебхук с HMAC-подписью

   Ваш сервер моментально получает payment.success с заголовком X-Webhook-Signature: sha256=.... Идемпотентный приёмник в две строки.

   ⟵ POST your-app/kaspi · 200 OK

Не «волшебный коннектор», а честный API.

Только то, что нужно для интеграции Kaspi Pay в существующий бизнес-софт. Без UI-конструкторов, без своих платёжных форм, без рекуррентов, которых у Kaspi нет.

Один запрос — один счёт.

Выберите свой стек. Все три примера делают одно и то же: создают счёт на 4 200 ₸ для клиента 87019009393 и возвращают paymentId.

import os, requests

API = "https://pay.proverkacheka.kz/api"
H   = {"X-API-Key": os.environ["KASPI_API_KEY"]}

r = requests.post(f"{API}/v1/invoice/create", headers=H, json={
    "phoneNumber": "87019009393",
    "comment":     "Заказ #42",
    "items": [
        {"name": "Капучино", "price": 1200, "count": 2},
        {"name": "Чизкейк",  "price": 1800, "count": 1},
    ],
})
r.raise_for_status()
payment_id = r.json()["paymentId"]
print("Счёт создан:", payment_id)

const API = "https://pay.proverkacheka.kz/api";

const res = await fetch(`${API}/v1/invoice/create`, {
  method: "POST",
  headers: {
    "X-API-Key":   process.env.KASPI_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    phoneNumber: "87019009393",
    comment:     "Заказ #42",
    items: [
      { name: "Капучино", price: 1200, count: 2 },
      { name: "Чизкейк",  price: 1800, count: 1 },
    ],
  }),
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const { paymentId } = await res.json();
console.log("Счёт создан:", paymentId);

curl -X POST https://pay.proverkacheka.kz/api/v1/invoice/create \
  -H "X-API-Key: $KASPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "87019009393",
    "comment":     "Заказ #42",
    "items": [
      { "name": "Капучино", "price": 1200, "count": 2 },
      { "name": "Чизкейк",  "price": 1800, "count": 1 }
    ]
  }'

# → {"paymentId":"14918505280","amount":4200.0,"status":"RemotePaymentCreated"}

Три типа команд используют API.

У каждой — своя точка входа. Гайды на блоге показывают конкретные сценарии с кодом, который можно скопировать.

Свежие материалы.

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

Счёт выставлен — чек проверен.

Этот API закрывает исходящую сторону: счёт уходит клиенту в Kaspi.kz. Входящую сторону закрывает наш второй сервис proverkacheka.kz — валидация чеков Kaspi по QR-коду и ИИН/БИН. Оба работают на одном Telegram-аккаунте и одной подписке.