1x1 and 2x2 Matching
Use recognized and secure sources to confirm user data.
To start verifying identity using 1x1 Matching and 2x2 Matching:
- Configure the WebSDK and MobileSDK integration or use the Sumsub API.
- Configure verification settings by reaching out to your Customer Success Manager or Support team.
- Create a verification level and add the Applicant data step.
- Include the required fields as specified in the table (Option 2).
- Submit the applicant data.
- Receive verification results.
Submit applicant data
To submit the applicant data:
- Create an applicant and in the
levelName
property, specify the verification level that you want to use. The verification level must contain the Applicant Data step. - Provide the required information according to the table (Option 2).
- Request an applicant check to verify the personal details of the applicant according to the matching rules configuration.
Note
The required fields and country code must be provided in the
fixedInfo
object as shown in the example below. The National ID number must be provided as the document number passed in thekey
property of themetadata
array.
Example request:
curl -X POST
'<https://api.sumsub.com/resources/applicants?levelName=global-address-verification'>
-H 'Content-Type: application/json'
-d '{
"externalUserId" : "someUniqueUserId",
"metadata": [
{
"key": "documentNumber",
"value": "12345678A" // National ID number
}
],
"fixedInfo": {
"firstName": "John", // First name
"lastName": "Doe", // Last name
"dob": "1990-01-01", // Date of birth
"country": "ESP", // Country code in alpha-3 format
"phone": "+34 123 456 789", // Phone number
"addresses": [
{
"street": "C. Ramon J Sender", // Street name
"buildingNumber": "7A", // Building number
"town": "Cartagena", // Town/city
"state": "Murcia", // State/province
"postCode": "30204", // Postal Code
"country": "ESP" // Country code in alpha-3 format
}
]
}
}
Get verification results
Once the check is performed, you will receive a webhook with the verification status. In the webhook, pay attention to the reviewResult
object indicating verification results:
- If verification was completed successfully, the
reviewAnswer
field will be set toGREEN
. - If the check fails, the
reviewAnswer
field will be set toRED
andreviewRejectType
will be set toRETRY
.
Updated 3 months ago