Быстрый старт

Получите API-ключ у команды Kvitera. Храните его на сервере, передавайте в Authorization: Bearer. Замените адрес API, даты, сумму и получателя на параметры вашего платежа.

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

В id придёт идентификатор проверки. Сначала проверьте status. Для done обработайте recommendation; для failed используйте error.code и error.retryable.

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

Повтор чтения результата не запускает модель. Идентификатор заявки order_ref нужен для связи с вашей системой и не обязан быть уникальным.