Argentina

Argentina eKYC non-doc verification leverages Argentina'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.

📘

API Authentication

All endpoints require authentication headers to be specified as stated in Incode API Documentation

POST /omni/externalVerification/kyc

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.

  • country: (mandatory) String. Two letter Alpha-2 country code. (Must be AR).
  • National ID Number(mandatory) This can be optional, but we want to keep idNum as mandatory on Incode side as it is a logical requirement for KYC; (8 digits, all numeric) - id_num.
  • taxID: (mandatory) This can be optional, but we want to keep idNum as mandatory on Incode side as it is a logical requirement for KYC. Refers to DNI - Tax ID Number (11 digits, all numeric) - id_num1.
  • firstName:: (mandatory) String. First name of the individual.
  • middleName:: (optional) String.
  • surName: (mandatory) String. Last name of the individual.
  • streetNo: (optional) String. Street number (address1 - recommended value for streetNo + street)
  • street: (optional) String. (Address1 - recommended value for streetNo + street)
  • floor: (optional) String. (Address2 - recommended value for floor + apartment)
  • apartment: (optional) String. (Address2 - recommended value for floor + apartment)
  • city: (optional) String. City of the individual's address. (eg. Buenos Aires).
  • state: (optional) String. (eg. Buenos Aires)
  • postalCode: (optional) String. PostalCode formatted based on per-country postalCode basis.
  • dateOfBirth: (optional) String. Format: yyyy-mm-dd (eg. 1980-06-01)
  • gender: (optional) String. Accepted values are “m” or “f”.

Example Incode request:

{
    "plugins": ["kyc"], // mandatory
    "source": "AR_1", // mandatory 
    "firstName": "Lionel", // mandatory
    "middleName": "",
    "surName": "Messi", // mandatory
    "street" : "Av. Corrientes",
    "streetNo": "2548", 
    "floor" : "7", 
    "apartment" : "B", 
    "city" : "Buenos Aires",
    "postalCode": "C1046AAF",
    "state" : "Buenos Aires",
    "country": "AR", // mandatory
    "dateOfBirth": "1980-06-01", 
    "gender" : "M", 
    "idNumber" : "32165498",// mandatory 
    "idNumber1" : "32165498989" // mandatory 
}

Direct API Response

📘

API Authentication

All endpoints require authentication headers to be specified as stated in Incode API Documentation

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": "middleNameMatch",
            "status": "Exact"
        },
        {
            "key": "lastNameMatch",
            "status": "Approximate Match"
        },
        {
            "key": "fullNameMatch",
            "status": "Fuzzy"
        },
        {
            "key": "dobMatch",
            "status": "Exact"
        },
        {
            "key": "streetMatch",
            "status": "Exact"
        },
        {
            "key": "cityMatch",
            "status": "Exact"
        },
        {
            "key": "stateMatch",
            "status": "Exact"
        },
        {
            "key": "postalCodeMatch",
            "status": "Exact"
        },
        {
            "key": "fullAddressMatch",
            "status": "Fuzzy"
        },
        {
            "key": "idNumMatch",
            "status": "Exact"
        },
        {
            "key": "idNum1Match",
            "status": "Exact"
        },
        {
            "key": "genderMatch",
            "status": "Exact"
        },
        {
            "key": "overallLevel",
            "status": "Low"
        }
    ]
}

Please refer to error response to see conventional HTTP response codes to indicate the success or failure of an API request. For Argentina, custom 400 error messages if taxId, or country is “ “ or null:

message: taxId, and country are minimum required fields.


Incode API Key

Status

Definition

firstNameMatch

Match / Partial Match / No Match / No Data

Matches first name submitted against the name associated to the value in the source of truth.

middleNameMatch

Match / Partial Match / No Match / No Data

Matches middle name submitted against the name associated to the value in the source of truth.

lastNameMatch [NEW]

exact, fuzzy, nomatch

Matches last name submitted against the name associated to the value in the source of truth.

fullNameMatch [NEW] (first_name, last_name, middle_name)

exact, fuzzy, nomatch

Matches full name (first_name, last_name, middle_name) submitted against the full name associated to the value in the source of truth.

dateOfBirthMatch

exact, nomatch, nodata

Matches date of birth submitted against the date of birth associated to the value in the source of truth

streetMatch (street name, street number)

exact, fuzzy, nomatch, nodata

Matches street name and street number submitted against the street name and street number associated to the value in the source of truth (address1)

houseNoMatch (floor, apartment)

exact, fuzzy, nomatch, nodata

Matches floor and apartment submitted against the floor and apartment associated to the value in the source of truth (address2)

streetAddressMatch (address1, address2)

exact, fuzzy, nomatch, nodata

Matches address1, address2 submitted against the address1, address2 associated to the value in the source of truth

cityMatch

exact, fuzzy, nomatch, nodata

Matches city submitted against the city associated to the value in the source of truth

stateMatch

exact, fuzzy, nomatch, nodata

Matches state submitted against the state associated to the value in the source of truth

postalCodeMatch

exact, fuzzy, nomatch, nodata

Matches postal code submitted against the postal code associated to the value in the source of truth

fullAddressMatch (StreetAddressMatch, cityMatch, postalCodeMatch)

exact, fuzzy, nomatch, nodata

Matches full address (address1, address2, city, zip) submitted against the full address associated to the value in the source of truth

idNumMatch

exact, nomatch, nodata

Matches id number submitted against the id number associated to the value in the source of truth

idNum1Match

exact, nomatch, nodata

Matches id number1 submitted against the id number associated to the value in the source of truth

genderMatch

Match / No Match / No Data

Matches gender submitted against the gender associated to the value in the source of truth

overallLevel

low, medium, high

Overall Risk Level is focused on the risk associated to the submitted full name and id number

See context below for more information around how low, medium, and high are calculated


overallLevel

Overall Risk Level is focused on the risk associated to the submitted full name and id number. The fields low, medium, and high are mapped to a proprietary fuzzy matching algorithm.The overall level is "low" if the full name and identification number match the values ​​for the full name and identification number found in the source of truth.

Single Session Dashboard Result

eKYC Single Session Dashboard result