Документация 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. Нужен другой банк — добавим под вас: модель дообучается на новых форматах квитанций за несколько дней.