Document Verification
In addition to providing identity verification and watchlist monitoring Synctera's verification solution includes document verification. In this guide, we'll dive into use cases and the document verification flow for your customers.
As discussed in the verification guide, Synctera recommends using document verification as a step up verification method for customers that cannot be automatically verified using basic CIP information (name, address, dob, govenment ID).
Synctera has partnered with Socure to provide the ability to verify thousands of documents from over 100 countries to help verify a customer's identity. By capturing the front and back of the document as well as a live capture selfie, document verification can be used as step up verification to improve conversion rates on customers that would otherwise go into manual review using standard identity verification methods. It can also help to reduce risk by further ensuring the validity of the customer and their information.
See the API reference or follow this guide for more information about integrating document verification into your onboarding flow.
Prerequisites
This guide assumes that you have:
- created a personal customer
- created a disclosure
- verified a customer
Socure SDKs
Socure provides SDKs for multiple platforms to simplify the integration of document verification into your application:
- WebSDK
- Android SDK
- iOS SDK
- React SDK
If you would like build out your document verification flow using the Socure SDK, contact your Synctera sales representative.
Integration Steps
- Create a personal customer
- Create a KYC data collection disclosure
- Verify the customer
- Collect the customer's documents
- Verify the customer using document verification
1. Create a personal customer
First we start by creating a record for our new customer. We'll use the POST /persons
endpoint to create a person.
curl \
-X POST \
-H "Authorization: Bearer $apikey" \
-H 'Content-Type: application/json' \
https://api.synctera.com/v0/persons \
--data-binary '
{
"first_name": "Christopher",
"middle_name": "James",
"last_name": "Albertson",
"dob": "1985-06-14",
"email": "[email protected]",
"phone_number": "+16045551212",
"ssn": "456-78-9999",
"legal_address": {
"address_line_1": "123 Main St.",
"city": "Beverly Hills",
"state": "CA",
"postal_code": "90210",
"country_code": "US"
},
"is_customer": true,
"status": "ACTIVE"
}'
For more information about creating and managing people consult the person guide.
2. Create a KYC data collection disclosure
Once we have our created customer, you will need to display a disclosure to your customer that you are collecting personal data that will be shared with a third-party for the purpose of verifying their identity. For this we use the disclosures resource.
curl \
-X POST \
-H "Authorization: Bearer $apikey" \
-H 'Content-Type: application/json' \
https://api.synctera.com/v0/disclosures \
--data-binary '
{
"person_id": "7ef75751-e372-4c12-9b02-b9e4b1faaac9",
"type": "KYC_DATA_COLLECTION",
"version": "1.0",
"event_type": "ACKNOWLEDGED",
"disclosure_date": "2022-03-17T17:04:34Z"
}'
For more information about creating and managing disclosures consult the disclosure guide.
3. Verify the customer
Now that we have a customer, and consent to collect and share their data we can make a request to verify the customer.
curl \
-X POST \
-H "Authorization: Bearer $apikey" \
-H 'Content-Type: application/json' \
https://api.synctera.com/v0/verifications/verify \
--data-binary '
{
"person_id": "7ef75751-e372-4c12-9b02-b9e4b1faaac9",
"customer_ip_address": "184.233.47.237",
"customer_consent": true
}'
Consent must come directly from the customer.
4. Collect the customer's documents
Currently, you must integrate with one of Socure's SDKs.
If you would like build out your document verification flow using the Socure SDK, contact your Synctera sales representative.
Once you have uploaded the customer's documents you will receive a document_id
which we will use in the next step.
5. Verify the customer using document verification
Using the document reference id returned from the Socure SDK, send a verification request, (like you did in step 3) this time including the document_id
.
curl \
-X POST \
-H "Authorization: Bearer $apikey" \
-H 'Content-Type: application/json' \
https://api.synctera.com/v0/verifications/verify \
--data-binary '
{
"person_id": "7ef75751-e372-4c12-9b02-b9e4b1faaac9",
"customer_ip_address": "184.233.47.237",
"document_id": "1ab2c3de-fg45-6789-a01b-23c45678defg",
"customer_consent": true
}'
By providing a document_id
, the verification request will perform a KYC verification of the individual using the documents provided to the Socure SDK.
{
"verification_status": "ACCEPTED",
"verifications": [
{
"id": "05e2ddf3-d172-450e-9cf3-7a34f76a414f",
"person_id": "7ef75751-e372-4c12-9b02-b9e4b1faaac9",
"verification_type": "IDENTITY",
"result": "ACCEPTED",
"details": [
{
"description": "Full name, address, and SSN/ITIN can be resolved to the individual",
"label": "Customer Identification Program (CIP)",
"result": "PASS"
},
{
"description": "Socure's document verification model recommends accepting the individual",
"label": "Document Verification",
"result": "PASS"
}
],
"verification_time": "2022-03-14T18:34:59.91272Z",
"creation_time": "2022-03-14T18:34:59.918188Z",
"last_updated_time": "2022-03-14T18:34:59.918188Z"
},
{
"id": "a24a16a2-4711-4486-8049-787462c61ffc",
"person_id": "7ef75751-e372-4c12-9b02-b9e4b1faaac9",
"verification_type": "WATCHLIST",
"result": "ACCEPTED",
"details": [
{
"description": "Global Watchlist sources selected are not correlated with the input identifiers",
"label": "Watchlist",
"result": "PASS"
}
],
"verification_time": "2022-03-14T18:34:59.91272Z",
"creation_time": "2022-03-14T18:34:59.918188Z",
"last_updated_time": "2022-03-14T18:34:59.918188Z"
}
]
}
Great! We have successfully created and verified a personal customer using document verification. You can now visit our account creation guide.
Updated about 1 year ago