Документация

Quick Start

От регистрации до первого QR-платежа за 5 минут

1. Создайте аккаунт

Зарегистрируйтесь на pay.aibot.kz — это бесплатно. Вы можете войти через Email, Google или Telegram.

2. Получите API ключ

После регистрации в дашборде перейдите в API ключи. Вы увидите два ключа:

  • •kp_live_... — для реальных платежей
  • •kp_test_... — для тестирования (sandbox)

3. Создайте первый QR-код

bash
Скачать
curl -X POST https://payapi.aibot.kz/v1/qr/create \
  -H "X-API-Key: kp_test_your_sandbox_key" \
  -H "Idempotency-Key: unique-id-123" \
  -H "Content-Type: application/json" \
  -d '{"amount": 1000}'

Ответ:

json
Скачать
{
  "Data": {
    "QrOperationId": 14837690870,
    "Status": "QrTokenCreated",
    "QrToken": "https://qr.kaspi.kz/...",
    "ExpireDate": "2026-04-02T13:33:58.000+0500"
  },
  "StatusCode": 0,
  "Message": "OK"
}

4. Проверьте статус платежа

bash
Скачать
curl https://payapi.aibot.kz/v1/qr/status/14837690870 \
  -H "X-API-Key: kp_test_your_sandbox_key"

5. Получайте уведомления

Зарегистрируйте webhook в дашборде или через API:

bash
Скачать
curl -X POST https://payapi.aibot.kz/me/webhooks \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yoursite.com/webhook",
    "events": ["payment.completed", "payment.cancelled"]
  }'

Когда клиент оплатит — вы мгновенно получите webhook с данными платежа.

Следующие шаги