From f6966a4de370ebfffadc3489629b2e273730dc8f Mon Sep 17 00:00:00 2001 From: Stas Tsuprenko Date: Thu, 26 Oct 2023 10:26:00 -0400 Subject: [PATCH] Updated NFC FAQ --- Docs/Guides/MiSnapNFC/faq.md | 39 ++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) diff --git a/Docs/Guides/MiSnapNFC/faq.md b/Docs/Guides/MiSnapNFC/faq.md index 6f5d8270..f035addc 100644 --- a/Docs/Guides/MiSnapNFC/faq.md +++ b/Docs/Guides/MiSnapNFC/faq.md @@ -4,6 +4,45 @@ Refer to [this section](integration_guide.md#sdk-and-uxui) of the Integration guide for updated instructions. +## How to increase probability of NFC step to be presented for NLD DL? +For NFC step to be presented 1-line MRZ should be extracted from the front of DL. In versions before 5.3.3 an extraction success rate was around 50-60%. In 5.3.3 there was an improvement made that increased the rate to around 90%. + +To further increase extraction chances add QR-code scanning for `.idBack` that'll get 1-line MRZ value from a QR-code on the NLD DL back. To do this chain the following customization to your `.idBack` configuration: + +```Swift +.withCustomParameters { parameters in + parameters.science.supportedBarcodeTypes = [MiSnapScienceBarcodeType.PDF417.rawValue, MiSnapScienceBarcodeType.QR.rawValue] +} +``` + +Starting with 5.4.0 if you're using `MiSnapWorkfkow` no additional changes are needed. If you're not using `MiSnapWorkfkow` in your logic when a success result is returned assign a barcode string to an `mrzString` value that'll be later validated (just like for the front of DL) to determine whether NFC step needs to be presented: + +```Swift +if let extraction = result.extraction { + if let mrzString = extraction.mrzString { + // mrzString will be returned if 1-line MRZ was successfully extracted from the front of DL + self.mrzString = mrzString + } else if let barcodeString = extraction.barcodeString { + // barcodeString will be returned if MRZ was successfully extracted from QR code in the back of DL + self.mrzString = barcodeString + } + if let documentNumber = extraction.documentNumber { + // documentNumber will be returned if 1-line MRZ was successfully extracted from the front of DL + self.documentNumber = documentNumber + } + if let dateOfBirth = extraction.dateOfBirth { + // dateOfBirth will be returned if 1-line MRZ was successfully extracted from the front of DL + self.dateOfBirth = dateOfBirth + } + if let dateOfExpiry = extraction.expirationDate { + // dateOfExpiry will be returned if 1-line MRZ was successfully extracted from the front of DL + self.dateOfExpiry = dateOfExpiry + } +} +... + +``` + ## What countries and documents are supported? See a list of contries and documents with full and beta support [here](supported_geos.md).