# ProverkaCheka.kz

> Kaspi receipt validation API. Upload a PDF receipt, get instant verification against Kaspi's systems. Used by Telegram bots and websites to confirm payments.

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

## Docs

- [API Documentation](https://proverkacheka.kz/docs/): Full API reference with examples, parameters, error codes
- [API Documentation (Markdown)](https://proverkacheka.kz/llms-full.txt): Complete API docs in plain markdown for LLM consumption

## Links

- [Telegram Bot](https://t.me/ProverkaChekakzbot): Get API key and 10 free checks
- [Widget Demo](https://api.proverkacheka.kz/webapp/widget-demo.html): Embeddable receipt checker widget

## Quick Start

1. Get API key from the Telegram bot (10 free checks included)
2. POST a PDF receipt to `/upload` with your `api_key`, `file` (URL/base64/multipart), `user_id`, and `iin` (seller's 12-digit IIN/BIN)
3. Response contains `message`, `check_number`, `amount`, `company_name`

## Key Parameters

- `api_key` (required): UUID API key
- `file` (required): PDF as URL, base64 string, or multipart upload
- `user_id` (required): Your user's identifier
- `iin` (recommended): Seller's 12-digit IIN/BIN — most reliable validation
- `price` (optional): Minimum payment amount in tenge (default: 1000)
- `ip_name` (optional if iin provided): Seller name (ИП/ТОО)
- `use_balance` (optional): Accumulate partial payments
- `max_age` (optional): Max receipt age in days (default: 14)