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"
}
}
Parameter | Description |
---|---|
first_name | Required: 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_name | Required: 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_name | Required: 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_match | Required: 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_name | Required: 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
Parameters | Description | Decision |
---|---|---|
Fuzzy_match : 0 | The 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 : 1 | The 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 |