API. Проверка чека
Использование API для проверки банковского чека
Отправка чека
POST /api/proofs
Headers
Content-Type
multipart/form-data (либо application/json)
Authorization
Bearer <token>
Body
attachments * для multipart/form-data используйте attachments[] для указания имени поля формы для каждого элемента массива
array[file|string]
Массив из файлов или ссылок на чеки одной транзакции. Массив удобно использовать для проверки одной выплаты осуществленной разными чеками. Форматы: pdf, png, jpg/jpeg, webp
Макс размер: 3МБ + Поддерживаются ссылки на Cash-In Т-Банка.
transaction_id *
string
Уникальный id транзакции
requisite *
string
Номер карты/счета/телефона
payment_method *
string
Метод оплаты: card sbp – присутствует проверка по названию банка-получателя account_number email (для Индии)
bank_full_name (* при СБП, либо validation_scope)
string
Название банка, который должен быть в качестве банка-получателя (для sbp). Например: Альфа-Банк, Т-Банк (не Тинькофф), Сбербанк и тд.
sender_bank_full_name
string
Если вы хотите провалидировать банк отправителя, передайте это поле
fiat_amount (* если указан в validation_scope)
float
Сумма в чеке
ignore_exist
boolean
Игнорировать ошибку PROOF_EXISTS. Данная ошибка определяет существует ли документ с такой чексуммой, но другим ID транзакции.
callback_url
string
Если вы планируете работать через callbacks, то можете передавать URL для ответного POST-запроса. В Headers будет Authorization с
"Bearer ваш-токен". Сообщите администратору, если хотите использовать свой токен.
validation_scope
array
По умолчанию мы проводим только валидацию реквизитов получателя и банк получателя/отправителя, если указано (получателя – только СБП). Однако, для выплат может быть полезно валидировать сумму в чеке и статус операции.
Перечислите здесь всё, что хотите валидировать в чеке. - fiat_amount (сумма, требуется передавать также поле fiat_amount с суммой в основном теле запроса) - status (будет ошибка, если операция в процессе, либо отклонена)
transaction_timestamp
Integer (время в UNIX виде)
Для валидации чека по времени, передайте дату/время в UNIX виде, когда была создана транзакция. Мы проверим, что чек подходит по дате.
proof_type
stopscam | email
Опционально, для pdf-чеков "stopscam", для майлера "email"
Response
В verdict находится итоговое решение нейросети по данному чеку. Если это пустой массив – то все проверки были пройдены.
Возможные значения type в элементах массива verdict:
PROOF_EXISTS – данный чек уже предоставлялся ранее по другой транзакции
INCORRECT – не является банковским чеком
WRONG_REQUISITES – неверные реквизиты для перевода
WRONG_BANK – неверный банк-получатель для перевода (для sbp)
WRONG_SENDER_BANK – неверный банк-отправитель
WRONG_STATUS – неуспешный перевод, либо в процессе
FAKE_PROOF – фейковый PDF-документ
WRONG_BYTES – несоответствие байтовой последовательности
UNKNOWN_FILE – неизвестный тип файла, либо данный тип не был включен в датасет (слишком минорный банк), либо является подделкой.
UNKNOWN_PRODUCER – продьюсер генератора не соответствует продьюсерам из белого списка банков.
WRONG_AMOUNT – неверная сумма
DATE_NOT_MATCH – неверная дата/время перевода
BANNED_PAYER – плательщик внесен в черный список, возможные пересечения по ФИО
Last updated