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

1. Подготовьте ключ

Создайте API-ключ в личном кабинете и сохраните его на сервере своей системы. Не передавайте ключ в браузер или мобильное приложение.

export KVITERA_API_URL='https://api.kvitera.tech'
export KVITERA_API_KEY='<ваш API-ключ>'

2. Отправьте чек

Подготовьте оригинальный PDF. В примере замените путь к файлу, сумму, имя получателя и интервал времени на данные своей заявки. Даты должны включать часовой пояс.

curl "$KVITERA_API_URL/v1/checks" \
  -H "Authorization: Bearer $KVITERA_API_KEY" \
  -H 'Idempotency-Key: payment-123-attempt-1' \
  -F 'file=@receipt.pdf' \
  -F 'external_id=payment-123' \
  -F 'expectation={"bank":"kz.kaspi","amount":2000,"currency":"KZT","recipient":{"name":"Алексей Петров"},"window":{"from":"2026-09-09T10:00:00+03:00","to":"2026-09-09T11:00:00+03:00"}}'

expectation — JSON-строка с параметрами платежа. external_id связывает результат с вашей заявкой. Idempotency-Key защищает от повторного создания проверки при потере ответа.

Не задавайте Content-Type вручную: для отправки файла curl сформирует его сам.

3. Обработайте ответ

Сохраните id проверки. Сначала прочитайте status:

• done — проверка завершена; используйте recommendation.
• failed — обработка не завершилась; следуйте правилам повторного запроса.

Пример ключевых полей ответа, остальные поля опущены:

{
  "id": "chk_example",
  "external_id": "payment-123",
  "status": "done",
  "recommendation": "accept"
}

accept — чек прошёл проверку, review — нужен разбор, reject — чек не подходит. Подробнее — результат проверки.

4. Получите сохранённый результат

Подставьте полученный id:

curl "$KVITERA_API_URL/v1/checks/chk_example" \
  -H "Authorization: Bearer $KVITERA_API_KEY"

Чтение результата не создаёт новую проверку. Если вы сохранили только ID своей заявки, используйте поиск по external_id.