Document Capture and Reuse
In this section, you will find the specific details on creating a process that includes Document Capture and Reuse as a capability
Last updated
Was this helpful?
In this section, you will find the specific details on creating a process that includes Document Capture and Reuse as a capability
Last updated
Was this helpful?
In this section, you will find detailed documentation about the functionality of the endpoints related to the Document Capture and Reuse capability. The use of Reuse requires that there be a previous Identity Verification process and this must obtain a “YES” response OR the Risk Score equal or more than +50, otherwise it will be necessary to capture the user's document.
This is an synchronous capability that requires consuming two endpoints, detailed in this documentation, for its full utilization.
The capabilities of the Unico IDCloud platform via Client are managed through API Keys—used as a parameter in the request headers—that define the access scope. As a prerequisite, it is necessary to have an API Key configured exclusively for the Document Capture and Reuse capability, ensuring dedicated and secure access to the resource.
Your API requests are authenticated using an access token. Any request that does not include a valid access token will return an error.
You can learn more about generating an access token .
Important:
To use the Document Capture and Reuse capability, the Identity Verification capability must be used beforehand, as it is necessary to include the processId obtained from the Identity Verification in the document.authProcessId parameter:
The process must have valid biometrics, be used within 24 hours of completion and cannot be reused;
It is possible to reuse a biometric authentication previously performed by the same user within a period of up to 24 hours. Within this timeframe, the ID authentication proof can be used in different document verification processes (e.g., RG and CNH) without the need for a new biometric authentication.
If we are unable to extract a field from the document, it is not listed in the API return;
When using the Document Capture and Reuse feature, it is mandatory to inform the user, on the interface, about the reuse, as required by the contract.
If an error occurs during processing, the process will return a status = 5, as shown in the example below:
Content returned in document.content based on document.type:
Tips:
When implementing your business rules, always validate the final statuses of the processes (3, 5). To validate the response of IDCloud capabilities, only consider status = 3 for your decision-making process;
For more information about possible errors for this endpoint, refer to the Errors section.
Still need help?
Didn't find something or still need help? If you're already a client or partner, you can reach out through our .
Endpoint to create a new Document process via Client.
Valid access token.
Valid APIKEY with the capabilitie Document Capture and Reuse enabled.
Type: CNH
Content: Brazilian National Driving License
String numero;
String rgNumero;
String cpfNumero;
String nomeCivil;
List string filiacao;
Datetime dataNascimento;
Datetime data_habilitacao;
Datetime data_expiracao;
Datetime data_emissao;
String local_emissao;
String categoria;
String renachNumero;
Endpoint to get a user's documents for reuse in by Client.
User identifier value (e.g., CPF value).
12345678909Document type (e.g., BR_CPF).
BR_CPFValid access-token.
Valid APIKEY with the capabilitie Document Capture and Reuse enabled.