Skip to main content

Name Matching Preferences

Shufti Pro allows two types of name matches in document service according to your business requirements.

  • Fuzzy Match: It allows for verification of the end user name even if the name provided by the end user does not exactly match the name on the document.
  • Exact Match: It allows for the verification of the end user name if and only if the provided name exactly matches the name on the document.
name-sample-object
{
"name" : {
"first_name" : "John",
"middle_name" : "Carter",
"last_name" : "Doe",
"fuzzy_match" : "1"
}
}

name-sample-object
{
"name" : {
"full_name" : "John Carter Doe",
"fuzzy_match" : "1"
}
}

ParameterDescription
first_nameRequired: No
Type: string
Minimum: 1 character
Maximum: 32 characters
Allowed Characters are alphabets, - (dash), comma, apostrophe, space, dot and single quotation mark.
Example: John'O Harra
middle_nameRequired: No
Type: string
Minimum: 1 character
Maximum: 32 characters
Allowed Characters are alphabets, - (dash), comma, apostrophe, space, dot and single quotation mark.
Example: Carter-Joe
last_nameRequired: No
Type: string
Minimum: 1 character
Maximum: 32 characters
Allowed Characters are alphabets, - (dash), comma, apostrophe, space, dot and single quotation mark.
Example: John, Huricane Jr.
fuzzy_matchRequired: No
Type: string
Value Accepted: 1
Provide 1 for enabling a fuzzy match of the name. Enabling fuzzy matching attempts to find a match which is not a 100% accurate.
full_nameRequired: No
Type: string
Minimum: 1 character
Maximum: 64 characters
Some countries don't have the identity document holder name as their first, middle or last name instead its written in full. In such cases, you may provide the full name.

Fuzzy & Exact Match Cases

ParametersDescriptionDecision
Fuzzy_match : 0The First and Last names are matched with the provided name.
Example:
Name on Document: Sample Caron Elizabeth
Provided Name in API: Sample Elizabeth
Accepted
An additional name is present within the provided name.
Example:
Name on Document:DOE JANE
Provided Name in API: DOE JANE Elizabeth
Repeated (First, Mid, or Last) name within the provided name.
Example:
Name on Document:DOE JANE
Provided Name in API: DOE JANE DOE
An additional character is present within the provided name.
Example:
Name on Document:DOE JANE
Provided Name in API: DOEE JANEY
Provided Name in API: DOE JAN
Provided Name in API: DO JANE
The First or Last name is different from the provided name.
Example:
Name on Document:DOE JANE
Provided Name in API: DOE Elizabeth
Provided Name in API: Jane Elizabeth
Declined
Name initials are present instead of the complete name within the provided name.
Example:
Name on Document:Sample Caron Elizabeth
Name passed in API: Sample C Elizabeth

Name on Document: DOE JANE
Name passed in API: D JANE
Name passed in API: D J
fuzzy_match : 1The First and Last names are matched with the provided name.
Example:
Name on Document:Sample Caron Elizabeth
Name passed in API: Sample Elizabeth
Accepted
An additional name is present within the provided name.
Example:
Name on Document:DOE JANE
Name passed in API: DOE JANE Elizabeth
Repeated (First, Mid, or Last) name within the provided name.
Example:
Name on Document:DOE JANE
Name passed in API: DOE JANE DOE
An additional character is present within the provided name.
Example:
Name on Document:DOE JANE
Name passed in API: DOEE JANEY
Name passed in API: DOE JAN
Name passed in API: DO JANE
Name initials are present instead of the complete name within the provided name..
Example:
Name on Document: Sample Caron Elizabeth
Name passed in API: Sample C Elizabeth

Name on Document: DOE JANE
Name passed in API: D JANE
The First or Last name is different from the provided name.
Example:
Name on Document: DOE JANE
Name passed in API: DOE Elizabeth
Name passed in API: Jane Elizabeth
Declined
Only Name initials are present within the provided name.
Example:
Name on Document: DOE JANE
Name passed in API: D J