Реализация верификации документов в мобильном приложении
Верификация документов через мобильную камеру — стандарт для финтех- и KYC-процессов. Пользователь снимает паспорт, водительские права или загранпаспорт, приложение распознаёт данные и проверяет подлинность. Реализация сложнее, чем кажется: качество съёмки, детекция подделок и точность OCR создают цепочку точек отказа.
Детекция и качество документа до OCR
Первый этап — убедиться, что документ попал в кадр правильно, без бликов и смазывания. Показывать пользователю сообщение «слишком темно» или «наклоните телефон» важнее хорошего OCR — мусор на входе даёт мусор на выходе.
На iOS для real-time детекции прямоугольника документа — Vision.VNDetectRectanglesRequest:
let request = VNDetectRectanglesRequest { request, error in
guard let observations = request.results as? [VNRectangleObservation],
let doc = observations.first else { return }
// Проверяем confidence и aspect ratio для паспорта
if doc.confidence > 0.9 && isValidDocumentAspectRatio(doc) {
// Захватываем кадр
captureDocument(rect: doc)
}
}
request.minimumConfidence = 0.8
request.minimumAspectRatio = 0.5
Для проверки блика — анализ яркости через CIFilter.glassDistortion или кастомный Metal-шейдер. Наличие specular highlights (белые пятна на ламинированной поверхности паспорта) — типичная причина отказа OCR в ~15% случаев.
На Android — CameraX + MLKit DocumentScanner API (появился в 2024) либо OpenCV для детекции прямоугольников через Imgproc.findContours.
OCR: платформенные vs специализированные SDK
Apple Vision (VNRecognizeTextRequest) — хорошее качество для латиницы и кириллицы, работает on-device:
let textRequest = VNRecognizeTextRequest { request, _ in
let observations = request.results as? [VNRecognizedTextObservation] ?? []
let lines = observations.compactMap { $0.topCandidates(1).first?.string }
parseDocumentFields(from: lines)
}
textRequest.recognitionLevel = .accurate
textRequest.recognitionLanguages = ["ru-RU", "en-US"]
textRequest.usesLanguageCorrection = true
Google ML Kit Text Recognition v2 — на Android, поддерживает латиницу, кириллицу, деванагари и ещё несколько скриптов. Работает on-device.
Специализированные SDK: Regula Document Reader, ABBYY Mobile Capture, Scandit. Стоят денег, но дают лучшую точность на MRZ (Machine Readable Zone) паспортов и понимают структуру конкретных документов. Regula, например, знает форматы паспортов 240+ стран.
MRZ: самое ценное
Machine Readable Zone — две строки с OCR-оптимизированным шрифтом OCR-B в нижней части паспорта или ID-карты. Именно оттуда извлекаются: имя, номер документа, дата рождения, срок действия, гражданство.
Парсинг MRZ по стандарту ICAO 9303 (реализация — открытые библиотеки NFCPassportReader на iOS или MRZParser на Android):
// MRZ строка: P<RUSLASTNAME<<FIRSTNAME<<<<<<<<<<<<<<<
// Строка 2: PA1234567<8RUS9001011M2512310<<<<<<<<<6
struct MRZData {
let documentNumber: String
let lastName: String
let firstName: String
let nationality: String
let dateOfBirth: Date
let expiryDate: Date
let gender: Character
var isChecksumValid: Bool {
// Проверка контрольных цифр по ICAO 9303
validateMRZCheckDigits(line2: rawLine2)
}
}
Контрольные суммы в MRZ — простой способ проверить, что данные не повреждены при OCR. Если checksum не сходится — перечитать документ, не отправлять на сервер.
NFC-верификация биометрических паспортов
Новые паспорта (ICAO LDS1) содержат NFC-чип с биометрическими данными и цифровой подписью страны-эмитента. Чтение чипа — более надёжная верификация, чем OCR.
На iOS (CoreNFC, NFCTagReaderSession):
// Basic Access Control: ключ формируется из MRZ
let bacKey = BACKey(documentNumber: mrz.documentNumber,
dateOfBirth: mrz.dateOfBirth,
dateOfExpiry: mrz.expiryDate)
let nfcReader = NFCPassportReader()
nfcReader.readPassport(mrzKey: bacKey.key,
tags: [.DG1, .DG2, .SOD]) { result in
switch result {
case .success(let passport):
let photo = passport.passportImage // UIImage из DG2
let isValid = passport.documentSigned // проверка сертификата CSCA
case .failure(let error):
handleNFCError(error)
}
}
NFC доступен только на физических устройствах, iPhone 7+. На Android — NfcAdapter с PACE/BAC.
Серверная валидация
OCR-данные с клиента — всегда недоверенные. Финальная верификация происходит на сервере: сравнение фото документа с селфи пользователя через face matching API (Amazon Rekognition, Azure Face, или ГАРАНТ/Паспорт-сервис для российских документов).
Процесс работы
Определение типов документов и стран. Выбор SDK (Vision/ML Kit vs специализированные). Реализация capture-flow: детекция, проверка качества, захват. OCR + парсинг полей. NFC-верификация (если нужна). Серверная валидация с face matching. Тестирование на коллекции реальных документов разного качества.
Ориентиры по срокам
Базовый OCR паспорта (MRZ + основные поля) — 1–2 недели. Полный KYC-flow с NFC, face matching, поддержкой нескольких типов документов — 6–10 недель.