Data Provider - Serpro
Digital identity verification in Brazil enhanced with Serpro's secure technology.
Serpro's CPF (Cadastro de Pessoas Físicas) number solution focuses on providing secure digital identity verification services using Brazil's unique CPF number system. CPF is a national identification number assigned to Brazilian citizens and residents for tax and other administrative purposes.
API Solution
Serpro offers 2 API solutions:
- Consulta CPF: The Consultation CPF service is available through HTTP REST, offering consultation operations for individuals in Brazil for registration information. Read the documentation here.
- Datavalid: Used to streamline customer onboarding processes and minimise fraud, by verifying the data provided by the customer during registration. It sends biographical and/or biometric (fingerprint/face) data, API “validates” data and returns info about data existence and correctness, and validates that biometric and biographic data matches. Read the documentation here.
The following are the filed types returned, subsequent situation codes, and descriptions.
| Field Types | Return Value |
|---|---|
NI "ni" | Registration Number in the Individual Taxpayer Register, in the format 99999999999. |
Name "nome" | Name of Individual. |
Situation "situacao" | Registration Status of Individuals is formed by two fields: Code and Description. |
Situation/Code "codigo" | Code of Registration Status of Individuals. |
Situation/Description "descricao" | Description of the Registration Status of Individuals. |
Date of Birth "nascimento" | Birthdate of Individuals, in the format DDMMYYYY. |
Year of Death "obito" | Death Year of Individuals, in the format YYYY. |
| Code | Description | Reason to flag tx (TBC) |
|---|---|---|
| 0 | Regular | pass |
| 2 | Suspended | flag |
| 3 | Deceased Holder | flag |
| 4 | Regularization Pending | flag |
| 5 | Canceled by Multiplicity | flag |
| 8 | Null | flag |
| 9 | Canceled Craft | flag |
Note:
- Please refer to the Reseller documentation for instructions on how to configure the Serpro Data Provider.
- Please refer to the API documentation for the Serpro Data Provider.
Example Results in IDKit
Note:
- The Serpro data check will not be invoked if the captured ID is non-Brazilian.
- The customer's CPF number will not be displayed on the ID details screen during the flow.
- The Serpro tab will not be available in the repository or PDF.
Serpro - CPF Number captured under Documents
Serpro CPF Consulta only- Failed Result
In this case, only the Serpro CPF Consulta will be invoked, and Datavalid will not be invoked:
- If the Consulta CPF call returns an invalid CPF, the Datavalid API check is not invoked.
- Suppose the user has configured the "Document Only" flow, i.e., the Normal V2 flow for which the Liveness Check is turned off. In that case, IDKit will only invoke the Serpro Consulta CPF API and not the Serpro Datavalid API.
Note:
The transaction above is flagged due to the situation code returned, which is 3, indicating a Deceased Holder.
Serpro - Consulta CPF and Datavalid API results captured under Data
In this case, Serpro Datavalid API was invoked because the Serpro Consulta CPF check had passed.
However, in the screenshot below, Serpro Datavalid caused a flag of the transaction because no image is available in the government db for this user.
💬 We Are Here to Help!
If you encounter an issue, a bug, or require assistance, please contact our support page here to find the solution. Don't forget to provide any important information on the issue.
Updated 28 days ago