Результат проверки
Как принять решение и показать клиенту причину расхождения.
Сначала статус, затем рекомендация
При status: done обработайте recommendation:
| Значение | Что означает | Следующее действие |
|---|---|---|
accept | Чек прошёл проверку и соответствует заявке | Продолжить обработку платежа по правилам вашей системы |
review | Данных недостаточно для однозначного решения | Направить на ручную проверку или запросить уточнение |
reject | Чек не соответствует условиям или выявлены признаки подделки | Показать причину и предложить другой чек |
При status: failed используйте error, а не рекомендацию.
Это ошибка обработки, а не вывод о подлинности документа. См. ошибки и повторы.
Что не совпало
В fields находятся распознанные данные. Поля match показывают,
совпадают ли они с вашей заявкой: true — да, false — нет, null — определить не удалось.
Например, вы ожидали 15 000 RUB. Фрагмент ответа:
{
"status": "done",
"recommendation": "reject",
"fields": {"amount": 1500, "currency": "RUB"},
"match": {"amount": false, "currency": true}
}В своей системе можно показать: «Ожидали 15 000 RUB, в чеке — 1 500 RUB».
Ожидаемое значение берите из своей заявки; null показывайте как «не удалось распознать».
reasons содержит пояснения к результату. Для автоматической обработки используйте
status, recommendation и поля match, а не сравнение текста пояснений.
Подлинность документа
document.verdict оценивает сам чек:
| Значение | Значение для клиента |
|---|---|
genuine | Проверки подлинности пройдены |
suspicious | Есть признаки, требующие разбора |
forged | Обнаружены признаки подделки |
unknown | Подлинность установить не удалось |
Подлинный чек может не подходить к вашей заявке. При выборе действия ориентируйтесь
на итоговую recommendation. Проверка чека не подтверждает поступление денег на счёт.
Повторный чек
replay.seen_before: true означает, что найдено предыдущее предъявление документа.
Если доступна связанная проверка, её ID будет в replay.duplicate_of; иначе — null.
Не учитывайте такой документ как новый платёж без дополнительной проверки.
Полная схема ответа — в справочнике метода.