FAQ
❓ FAQ on the NV Global KYC Platform
Below are frequently asked questions about using the platform, architecture, integration, and features of NV Global KYC modules.
General (KYC)
Question: What is the NV Global KYC platform and what is it for?
Short answer: It is a comprehensive solution for remote customer identification.
Expanded answer
The NV Global KYC platform allows companies to remotely verify user identities using document and facial recognition. It automates the KYC (Know Your Customer) process, combining document scanning, biometric verification, and other checks for fast and accurate identity confirmation.
Question: What types of documents and countries are supported by the NV Global system?
Short answer: A wide range of documents from different countries is supported – passports, identity cards, international passports, etc.
Expanded answer
The platform recognizes passports, national ID cards, driver's licenses, and other official documents from many countries. The specific list of supported documents is regularly updated – before integration, it is recommended to clarify whether the system covers documents from your country and of the required type. The list of supported documents is available at the link: [
Question: Is it possible to add support for a new document type if it is not recognized by the system?
Short answer: Yes, the list of supported documents can be expanded if necessary.
Expanded answer
If the document you need is not yet supported, you can contact NV Global support. The team will be able to assess the possibility of training the system on this document and release an update. Adding a new document type usually requires time for data collection and model retraining, but it is possible within the framework of cooperation.
Question: How to ensure high quality photos of documents and selfies for successful verification?
Short answer: You need to take clear photos without glare, shadows, or cropped parts.
Expanded answer
It is recommended to photograph the document in good lighting, without flash and glare, so that all important areas (photo, stamps, numbers) are fully visible. Selfies should be taken with a good quality camera, in sufficient lighting, looking directly into the camera with a neutral facial expression – this will increase recognition accuracy and reduce the likelihood of errors.
Question: Can scanned copies or photocopies of documents be used instead of photographs?
Short answer: Yes, but only if the anti-fraud check is disabled for copies and printouts
Expanded answer
The platform is by default oriented towards working with photos of original documents. If anti-fraud checks for photocopies and printouts (both black and white and color) are enabled, then such images may be recognized as suspicious and flagged with errors such as "image printed," "black and white image," or "image edited." However, if necessary, these checks can be disabled in the scenario editor. In this case, the system will accept high-quality copies and scanned documents (including printouts and Xerox copies) without issues, provided they meet the requirements for resolution, completeness, field visibility, and other parameters. To use copies, ensure that the corresponding anti-fraud rules are disabled in the verification scenario.
Question: How long does a full check (document + face) typically take on the NV Global platform?
Short answer: On production servers — less than a second. With Liveness — up to a minute.
Expanded answer
On NV Global servers, a full document check (including upload, recognition, field extraction, verification, and face matching) takes an average of 500–600 milliseconds, and in some cases, even less than half a second. This is achieved through an optimized architecture and high-performance neural networks. On the demonstration version servers (in demo mode), a similar check can take up to 5 seconds, which is due to limitations in computing resources and background loading. If the Liveness check (authenticity check) is included in the scenario, the total verification time may increase. In this case, the time for the user to pass the Liveness check ranges from a few seconds to one minute, depending on the shooting quality, lighting conditions, and the user's reaction speed.
Question: Does the user need camera access to pass the verification, or can they upload a pre-existing photo?
Short answer: A camera is mandatory for selfies (and liveness). Documents can be uploaded, but with caveats.
Expanded answer
A user can upload a document photo from a file, which is allowed by the platform. However, for the face verification stage (including Liveness), the use of a camera is mandatory. This is necessary to confirm liveness and exclude spoofing attempts – the system must ensure that it is a live person in front of it, not an image. Nevertheless, for photographing documents, we strongly recommend using the built-in camera component – WebSDK. This significantly reduces the risk of fraud. If anti-fraud checks within the current scenario are not critical, and the scenario allows uploading files without protection against falsification, then the user can provide document images directly from the gallery or by uploading a file.
Document Recognition
Question: What image format and size are required for document and face recognition?
Short answer: Only JPEG or PNG. Document — minimum 200 pixels, face — minimum 30×30 pixels.
Expanded answer
The system accepts images exclusively in JPEG or PNG formats. Files in other formats (e.g., HEIC, WEBP, PDF, etc.) will be rejected. Image size requirements apply not to the entire file, but to the size of the object in the image: The document in the photo must occupy at least 200 pixels on its larger side (width or height). If it is smaller, the system will return the error "too small image" or "document too small" because it will not be able to extract data correctly.
The user's face (e.g., in a selfie or document) must be at least 30×30 pixels. Smaller faces cannot be analyzed and recognized properly and will lead to the error "face too small".
It is also important to avoid strong compression, blurriness, and poor lighting – such defects can degrade OCR quality and reduce the accuracy of face comparison.
Question: Do I need to specify the document type or country before recognition, or does the system determine them automatically?
Short answer: The system automatically determines the document type from the image; no separate settings are required.
Expanded answer
NV Global can automatically recognize which document was uploaded (e.g., passport or driver's license, and from which country, if the format is unique). You don't need to manually select the type – just upload the photo, and the algorithm will classify the document itself. However, in some cases (if documents of different types are very similar), the system may require specifying the type in the verification scheme settings.
Question: What should I do if some document data is recognized incorrectly (error in full name, date, etc.)?
Short answer: It is recommended to re-photograph the document more clearly or check the original.
Expanded answer
If the system incorrectly recognized the text on the document, it is likely that the image quality was insufficient (glare, blurriness). In such a situation, it is better to take a new photo of the document with better quality and try again – this most often solves the problem. If the recognition error repeats on a clear image, you can report it to support, and in the meantime, manually correct this data outside the system.
Question: Does the system verify the authenticity of the document by visual security features (holograms, watermarks)?
Short answer: Indirectly – the system checks structural elements, but direct hologram analysis is not supported.
Expanded answer
The NV Global algorithm analyzes image quality and the presence of mandatory elements (stamp, signature, owner's photo) and can detect copies or fakes. However, a full authentication of security holograms or UV markings from a regular photograph is difficult. Thus, the system identifies obvious discrepancies (document format, fake elements) but does not guarantee the detection of all types of fakes, especially if they are not reflected in the photo.
Question: Is multi-page document recognition supported (e.g., passport + registration page)?
Short answer:
Yes, for such cases, sequential uploading of multiple document images is provided.
Expanded answer
If the identity document consists of two pages (like an internal passport with registration), the platform can process both pages sequentially. In the schema settings, you can specify the need for an additional step – first, a scan of the main page, then, for example, the registration page. The user will be prompted to upload both sides, and the system will combine this data for a complete verification.
Question: Does the system recognize text in documents in different languages (e.g., Cyrillic, Latin)?
Short answer: Yes, OCR supports many languages, including Cyrillic, Latin, and others.
Expanded answer
NV Global can read text in Russian and other languages with the Cyrillic alphabet, as well as in Latin script (English, French, etc.), and in many other languages represented in documents. The system is trained on international samples, so it automatically extracts fields (full name, date of birth, document number, etc.) regardless of the language – the only important thing is that the document is on the list of supported formats.
Liveness (liveness check)
Question: How is user liveness checked?
Short answer: The user performs simple actions on the camera, and the system determines if a person is in front of it.
Expanded answer
Enface platform's Liveness check is used to confirm that a real living person is in front of the camera, not a photo, video, or other deception. We use three modes of active Liveness check: — Simple tasks — the user performs individual commands (e.g., turn head left or right, blink, look at a specific point). — Complex tasks — tasks are complicated and follow in quick succession (e.g., combinations of turns and gazes) for deeper verification. — Circular head movement — the user moves their head in a circle, similar to the initial Face ID setup on an iPhone. This method allows for collecting the maximum amount of 3D facial information.
During task execution, the system takes a series of snapshots (key frames) which are automatically sent to the server. On the server, these images are analyzed using neural network models that determine the presence of signs of a living person (micro-movements, skin texture, depth, etc.). Based on the analysis of all frames, the system makes a final decision on passing the Liveness check.
Question: What to do if the client fails the Liveness check (failed to confirm live presence)?
Short answer: The client should try again, following the instructions – most often, a repeat test is successful.
Expanded answer
If the liveness check fails, the system could not verify that it was a live person (e.g., due to poor lighting or failure to perform actions). It is recommended to ask the user to repeat the liveness check: look directly into the camera, do not cover your face, and perform the required action. The system usually allows several attempts. If it fails repeatedly, it may be possible to switch to an alternative identification method (e.g., manual verification by an operator).
Question: Is it possible to disable the Liveness stage and only conduct document verification?
Short answer: Yes, it is possible to configure a verification scheme without Liveness, although this will reduce the level of protection against issuance.
Expanded answer
The Liveness test is recommended to ensure that the document is presented by its owner at the time of verification. Nevertheless, the platform is flexible – at the client's request, a simplified KYC scheme can be used, which includes only document upload and recognition. In this case, the user's face is not confirmed via selfie, which somewhat increases the risks of fraud, so disabling Liveness makes sense only in low-risk scenarios.
Question: Does the system detect spoofing attempts in Liveness (masks, someone else’s video instead of a face)?
Short answer: Yes, Liveness algorithms can detect discrepancies (e.g., a mask on the face or a video stream).
Expanded answer
Built-in Liveness mechanisms check for natural behavior: they can distinguish a live face from a static photograph or a video playback. If, for example, an attacker wears a silicone mask or tries to show another person's video on the camera screen, the system will very likely recognize this as an attempted deception and will not count the liveness check.
Anti-fraud
Question: How does the platform detect fraudulent attempts during identification?
Short answer: It analyzes signs of document forgery, biometric reuse, and other anomalies.
Expanded answer
NV Global implements a number of anti-fraud mechanisms: it checks the document for forgery (for example, by recognizing a copy or photomontage), compares facial biometrics with those already known in the system (to identify if the same person has tried to register under a different name), and also monitors the sequence of user actions. Any deviations (black and white copy of the document, mismatch between the face and data, suspiciously frequent attempts, etc.) are flagged and can serve as a signal for rejection or additional verification.
Question: What does the error «[fraud] image printed» mean when checking a document?
Short answer: This is a warning that the uploaded document image looks like a photocopy or a printout.
Expanded answer
The label [fraud] image printed indicates the detection of signs of a copy: the system determined that the document is likely not an original, but a scan or photocopy (e.g., black and white or color). This error serves as a signal of possible fraud. It is recommended to request a photo of the original document from the user – with real security features – to pass the verification.
Question: Can the system detect if the same person is trying to go through identification under different names?
Short answer: Yes, the system detects face matches and links them across sessions.
Expanded answer
The platform supports the storage of biometric facial templates of users who have successfully passed verification. During new KYC attempts, the system automatically compares the face with the database of already known embeddings.
If the face has been encountered in previous sessions—even under a different name, with a different document, or in a different context—the system will detect a match. This allows for timely identification of repeated KYC attempts with data substitution.
In the interface, upon a match, the system highlights the current session ID in red, which is a direct indicator that the person has already appeared in the system. Clicking on this ID opens the history of all sessions in which this face was detected, with the ability to view and analyze them.
Question: Is it possible to set up a «stop list» – a list of unwanted persons or documents for blocking?
Short answer: Yes, we have implemented a face blacklisting mechanism.
Expanded answer
The platform supports a built-in mechanism for adding faces to a blacklist. This allows for the automatic blocking of verification attempts by the same person, even if they use different documents or personal data.
To do this, click on the icon with a crossed-out circle in the session viewing interface. After that, the face detected in this session will be added to the blacklist. During subsequent verification attempts:
- If the face matches a previously blocked one, the session will be automatically rejected.
- This will be accompanied by the label "User on blacklist" in the interface.
Blacklist in the interface
This approach is effective against repeated fraudulent attempts with data substitution, as it relies on biometrics rather than just document details. The mechanism does not require additional implementation from the client – it works out of the box.
API Integration
Question: Where can I find the NV Global API documentation for integration?
Short answer: Detailed API documentation (including Swagger interface) is available on the official website.
Expanded answer
All technical documentation is available on the NV Global portal: it describes REST API endpoints, request and response formats, examples, and errors. For ease of integration, you can use Swagger/UI at or read the guide on GitBook. It is advisable to familiarize yourself with these materials before starting the integration.
Question: How to access the API (test and production keys)?
Short answer: You need to request a promo code from the administrator and register on the platform.
Expanded answer
To gain access to the platform's API, you need to:
Request a unique promo code from the NV Global administrator.
Register on the platform (via the web interface) using this promo code.
After registration, you will get access to your personal account, where you can:
Manage connections,
Obtain tokens,
Configure scenarios and integration,
View statistics and request status. All access parameters (tokens, identifiers, configurations) are issued automatically through the platform – we do not transfer anything manually, including any clientKey or secret keys.
Usually, a Non-Disclosure Agreement (NDA) is concluded before this. After that, you can start using the test access. Load parameters, limits, and scenario restrictions are discussed individually.
After a full contract is signed, production access will be granted, with the possibility of connecting to an isolated environment, dedicated servers, and custom SLA parameters.
Question: What are the main steps for KYC verification via API integration?
Short answer: You need to send photos to the server via the appropriate API method and get the verification result.
Expanded answer
The general process is as follows: your backend calls the NV Global API method, passing the document image and the user's selfie/video (either in sequential requests or within a single session, depending on the chosen scheme). The NV Global server processes the data (OCR, face comparison, liveness) and returns a structure with the results – the verification status and extracted data. In the integration, you will need to implement sending the data, receiving the response, and parsing the results (e.g., filling out a user form with data from the passport, processing the "success/failure" status).
Question: Are the document and selfie sent in one request or separately?
Short answer: It can be done in one request or in stages—synchronously or asynchronously.
Question: What is sessionId and how to use it?
Short answer: sessionId is a unique identifier for the verification session, which tracks the KYC process.
Question: Can the sessionId be reused for another client or a new check?
Short answer: No, a unique session (sessionId) is created for each individual check.
Question: How to get the verification result: does the platform send the answer itself, or do I need to poll the status?
Short answer: By default, you can poll the session state, and a callback (webhook) is also available for the final result.
Question: Is there a reference of all possible errors and codes returned by the system?
Short answer: Yes, it is available in the KYC errors section and contains a detailed description of each check.
Question: Does the platform API return recognized personal data (full name, date of birth, etc.) in a structured format? {{ … }}
Short answer: Yes, all data is returned in a structured JSON format.
Question: Why can the verification result be FAILED, even though the data was recognized correctly (e.g., all passport fields were read correctly)?
Short answer: This means that the system is not sure about the correctness – for example, the model’s confidence threshold was triggered, despite visible recognition.
Web Widget and SDK
Question: Is there a ready-made web widget for KYC verification that can be embedded on our website?
Short answer: Yes, NV Global provides a «KYC Widget» for simplified integration on websites.
Question: How to integrate the KYC widget into my web page or application (e.g., in a React application)?
Short answer: You need to connect the NV Global widget script and call initialization with your schemaId.
Question: Is there a mobile SDK for integrating NV Global into our Android/iOS application?
Short answer: There is no specialized native SDK yet, but you can embed a web widget into a mobile application.
Question: Is it possible to change the appearance of the widget to match our brand (colors, logo)?
Short answer: You can brand the widget by adding your logo and changing the color scheme through styles.
Question: What is schemaId in the context of a widget and where can I get it?
Short answer:
schemaId is the identifier of the verification scenario configured for you in the NV Global system.
Question: What is clientKey and how to get it to work with the widget or API?
Short answer: ClientKey is a client access key issued by the system for request authentication, it can be obtained from support or in the personal account.
Errors and Codes
Question: What does the error «The document is missing required elements» mean in the verification result?
Short answer: This means that some mandatory fragments (stamp, signature, or other important elements) are not visible in the document photo.
Question: What does the «bad_image» error mean when uploading a photo?
Short answer: The system could not process the file — it might not be an image or it might be a low-quality image.
Question: What does the «bad_face_matching» error mean in the verification result?
Short answer: This means that the person in the selfie did not match the photo in the document with a sufficient degree of confidence.
Question: What result statuses can the system return and what do they mean?
Short answer: The main statuses are success, failed, idle, and suspicious is also possible.
Question: What does the «idle» status mean and in what situations is it set?
Short answer: «Idle» means that the check was not completed by the user until the end.
Question: How to understand the reason why the check failed (status failed)?
Short answer: The reasons are indicated in the results array, in the errors list for each check type.
On-Premise vs Cloud
Question: Is it possible to deploy the NV Global platform on your own servers (On-Premise) instead of using a cloud service?
Short answer: Yes, an On-Premise version is available for installation within the client’s infrastructure.
Question: How does the cloud version of the service differ from On-Premise?
Short answer: Cloud runs on NV Global servers (SaaS), On-Premise – on your servers, giving you full control over your data.
Question: What are the minimum hardware requirements for installing the On-Premise version?
Short answer: Minimum — RTX 3090 or equivalent with 24 GB VRAM, 16-core CPU, 64 GB RAM. It is recommended to use two servers with load balancing.
Question: How are updates to the On-Premise version (new models, improvements) handled?
Short answer: The update is performed by the NV Global command via a secure connection to the client’s server.
Question: Can an On-Premise solution work completely isolated, without internet access?
Short answer: Yes, the local version does not require an internet connection to function (after initial installation).
Digital ID
Question: What is meant by the «Digital Passport on the Blockchain» mentioned by NV Global?
Short answer: It is a concept of a decentralized digital identifier stored on a blockchain network for reusing verified data.
Expanded answer
NV Global is developing a Digital ID solution, within which a record (digital passport) is created in a distributed system (blockchain) based on KYC results.
- What is a digital passport on the blockchain:
- A unified verified identity profile created after successful KYC completion;
- Stored in a distributed blockchain network — decentralized and immutable;
- Allows for the reuse of verified data across different services without the need for re-identification;
- Can be implemented as a Soulbound NFT token or another digital certificate;
- Recognized by ecosystem partners, facilitating access to various services.
Essentially, it's an add-on to KYC: undergo identification once — receive a digital certificate that can be presented repeatedly.
Question: Can I already use the decentralized digital passport from NV Global?
Short answer: This functionality is under development – for specific use cases, please discuss the details with the NV Global team.
Rates and Limits
Question: What is NV Global’s tariff approach – per number of requests, subscription-based, or something else?
Short answer: Various models are available – usually either a lump-sum payment for the number of checks, or a subscription fee based on a tariff plan.
Question: Are there any limits on the number of checks per month on our plan?
Short answer: No, you can use the purchased check package at any pace – even in a minute.
Question: What will happen if we exceed the agreed number of checks?
Short answer: The service will not stop — you will simply need to purchase the next package.
Question: How to get a report on the number of KYC checks performed by us for a period?
Short answer: You can generate a detailed report for any period directly in your personal account.
Question: Do you provide closing documents and acts for services rendered every month?
Short answer: Yes, monthly acts of completed work are generated, indicating the number of inspections, which are provided to the client for signature.
Question: Is it possible to switch to a discounted annual plan with a larger volume after the trial period?
Short answer: Yes, NV Global is ready to discuss the transition to an annual service package on favorable terms after a successful trial period.
Sessions and statuses
Question: How long does an unfinished session (idle) last, and does it need to be closed manually?
Short answer: The session automatically expires via a script timer — you do not need to end it manually.
Question: Do we need to store the sessionId and results ourselves, or can we retrieve the data from the system later?
Short answer:Yes, you can get all data by sessionId at any time. Images – within 6 months.
Post-exploitation
Question: How to contact NV Global support if problems or questions arise after launch?
Short answer: Support is available during business hours. There is a 24/7 option. Inquiries are accepted via tickets, Telegram, and email.
Question: Is it possible to change the validation scheme settings or add new documents after the service has been launched?
Short answer: Yes, everything is edited through the KYC editor — you can change parameters, steps, document types, and rules.
Question: What to do if the service is slow or unavailable?
Short answer: Contact support – we will check during business hours. Failures are rare and are usually fixed within minutes.