# PayProverkaBot

> Программное создание удалённых счетов Kaspi Pay для казахстанских мерчантов через REST API и Telegram-бота. Один раз авторизуйтесь по SMS — дальше выставляйте счета программно. Вебхуки с HMAC-подписью на оплату, отказ, истечение и возврат.

Base URL: `https://pay.proverkacheka.kz/api`

## Docs

- [Главная (полная API-документация)](https://pay.proverkacheka.kz/): эндпоинты, примеры, ошибки, лимиты
- [API-документация в Markdown](https://pay.proverkacheka.kz/llms-full.txt): полный API-референс в plain markdown для LLM

## Blog

- [Вебхуки или поллинг](https://pay.proverkacheka.kz/blog/webhooks-vs-polling-kaspi-pay.html): архитектура отслеживания статуса
- [HMAC-SHA256 без багов](https://pay.proverkacheka.kz/blog/hmac-podpis-webhookov-kaspi.html): проверка подписи на Python/Node/Go
- [Интеграция в Bitrix24, Kommo, amoCRM](https://pay.proverkacheka.kz/blog/integratsiya-kaspi-pay-v-crm.html): готовые сценарии

## Links

- [Telegram-бот](https://t.me/PayProverkaBot): получить API-ключ, авторизация по SMS
- [Сестринский сервис ProverkaCheka.kz](https://proverkacheka.kz/): валидация чеков Kaspi (обратное направление)

## Quick Start

1. Откройте `@PayProverkaBot` в Telegram, нажмите `/start` → получите API-ключ
2. `/login` → введите телефон ИП/ТОО → введите SMS-код
3. `POST /api/v1/invoice/create` с `phoneNumber`, `items` (массив товаров) и заголовком `X-API-Key: <ключ>`
4. Получите `paymentId`, клиент видит push в Kaspi.kz
5. (Рекомендуется) подпишитесь на вебхуки `POST /api/v1/webhooks` для мгновенного уведомления об оплате

## Key Endpoints

- `POST /v1/invoice/create` — создать счёт с корзиной товаров
- `GET /v1/invoice/{id}` — статус счёта
- `POST /v1/invoice/{id}/cancel` — отменить неоплаченный счёт
- `POST /v1/invoice/{id}/refund` — частичный или полный возврат
- `POST /v1/webhooks` — подписка на события платежей