API документація

Один запит — один вердикт. Ви надсилаєте фото квитанції, очікувану суму та останні 4 цифри картки отримувача. У відповідь — verified: true/false з поясненням, зазвичай за ~1 секунду.

Автентифікація

Кожен запит має містити заголовок X-API-Key. Ключ видається після оплати пакета — напишіть нам у Telegram: @sarmkadan, підключення займає один день.

POST /api/v1/verify

Формат: multipart/form-data.

Поле	Тип	Опис
`image`	file	Фото або скриншот квитанції (jpg/png/webp, до 10 МБ)
`expectedAmount`	number	Очікувана сума платежу в гривнях
`expectedCardLast4`	string	Останні 4 цифри картки отримувача

Приклад (curl):

curl -X POST https://check.sarmkadan.com/api/v1/verify \
  -H "X-API-Key: chk_ваш_ключ" \
  -F "image=@receipt.jpg" \
  -F "expectedAmount=2450" \
  -F "expectedCardLast4=7731"

Відповідь:

{
  "verified": true,
  "confidence": 0.97,
  "detectedAmount": 2450.0,
  "detectedCardLast4": "7731",
  "reason": "confirmed",
  "durationMs": 940,
  "checksLeft": 9814
}

Коди reason

reason	Що означає
`confirmed`	Платіж підтверджено: сума і картка збігаються
`rejection_or_payment_screen_detected`	Це екран відмови або незавершеної оплати, а не квитанція
`amount_not_found_or_mismatch`	Сума не знайдена або не збігається
`card_not_found_or_mismatch`	Картка отримувача не знайдена або не збігається
`amount_and_card_not_found`	Не знайдено ні суму, ні картку (обрізане/темне фото)
`processing_error`	Технічна помилка обробки — перевірка не списується, повторіть

Рекомендація. verified: false — не завжди «фейк». Обрізані й дуже темні фото (~4% потоку) краще відправляти оператору на ручну перевірку, а не відхиляти автоматично.

Помилки

HTTP	Значення
401	Немає або невірний `X-API-Key`
402	Пакет перевірок вичерпано — поповніть баланс
413 / 415 / 422	Проблема з вхідними даними (розмір, формат, поля)
502	Тимчасова недоступність — повторіть запит

Приватність. Зображення обробляється на наших серверах в ЄС і видаляється одразу після перевірки. Жодні дані не передаються стороннім хмарним сервісам розпізнавання.

Тарифи

Пакет	Ціна	За перевірку
Start — 1 000 перевірок	$30	$0.03
Business — 10 000 перевірок	$200	$0.02
Custom	від $500	окремий продукт під ваш кейс: ваші банки, ваші правила, інтеграція під ключ

Оплата у USDT або на рахунок. Без абонплати і мінімальних місячних платежів.

Підтримувані банки

ПриватБанк, monobank, OTP Bank, A-Bank, Raiffeisen. Потрібен інший банк — додамо під вас: модель донавчається на нових форматах квитанцій за кілька днів.