Guatemala eKYC non-doc verification leverages Guatemala's source of truth to validate individuals. It is essential in eKYC processes for ensuring identity authenticity, regulatory compliance, and enhanced security. It helps prevent fraud, boosts user trust, and streamlines operations through automated and efficient verification methods.

Integration

User input flow

eKYC module configuration gives various options to specify different search criteria with various sources of truth for each country (eg. US has multiple via Telco, Credit Bureau, and Driver's License). User data can be collected via a user input flow by using pre-selected fields where users can type in their name or date of birth, etc. See an example below:

eKYC user input flow example

Module configuration

The module configuration can be leveraged to select the applicable fields for the input data you would like to collect from the end user.

eKYC module configuration

Direct API Approach

All module configurations and user data can be forwarded directly in the request for performing an eKYC search. This will override existing configuration and data collected about the user.

eKYC request

POST /omni/externalVerification/ekyc

This endpoint performs an eKYC check for the individual specified. Note: Endpoint can have empty body {} and in that case information will be pulled from module configuration and session details.

• source: (mandatory) String. Must be "GT_1".
• country: (mandatory) String. Two letter Alpha-2 country code. (Must be GT).
• taxID: (mandatory) We want to keep idNum as mandatory on Incode side as it is a logical requirement for KYC. In Guatemala DPI (Documento Personal de Identificación) numbers have thirteen digits and are generally written in this format: XXXX XXXXX XXXX
• firstName:: (optional) String. First name (and often Segundo nombre) of the individual.
• surName: (optional) String. Last name (and often Segundo apellido) of the individual.
• dateOfBirth: (mandatory) String. Format: yyyy-mm-dd (eg. 1980-06-01)

Example Incode request:

{
    "plugins": ["kyc"], // mandatory
    "source": "GT_1", // mandatory
    "firstName": "Juan Carlos", // optional
    "surName": "López Méndez", // optional
    "country": "GT", // mandatory
    "idNum": "1234 56789 0101", // mandatory
    "dateOfBirth": "1980-06-01" // mandatory
}

Direct API Response

Note: Endpoint can have empty body {} and in that case information will be pulled from module configuration and session details.

Example Incode response:

{
    "kyc": [
        {
            "key": "firstNameMatch",
            "status": "Exact"
        },
        {
            "key": "lastNameMatch",
            "status": "Approximate Match"
        },
        {
            "key": "fullNameMatch",
            "status": "Fuzzy"
        },
        {
            "key": "dobMatch",
            "status": "Exact"
        },
        {
            "key": "idNumMatch",
            "status": "Exact"
        },
        {
            "key": "overallLevel",
            "status": "Low"
        }
    ]
}

eKYC error responses

Please refer to conventional HTTP response codes to indicate the success or failure of an API request.

For Guatemala, custom 400 error messages if taxId, or country is “ “ or null:

message: taxId, and country are minimum required fields.