Document Check can be executed on:

Create a Document Check

When you want to collect and review a document, you can create a document check.

Using a default document type

Here is the list of document type available per entity type:

Company
- Articles of association: articles_of_association
- Registration certificate: registration_certificate
- UBO registry extract: ubo_registry_extract
- Financial statements: financial_statements
- Bank details: bank_details
- Proof of address: proof_of_address
- Proof of insurance: proof_of_insurance
Individual
- Identity document: id_document
- Driving license: driving_license
- Proof of address: proof_of_address
- Visa: visa
- Social security card: social_security_card
- Birth certificate: birth_certificate
- Vehicle registration certificate: vehicle_registration_certificate
- Bank details: bank_details
- Criminal record extract: criminal_record_extract
- Tax notice: tax_notice

Set the document_type_key in the settings when creating the check, for instance:

{
	"company_id": "aa7632a3-0bb3-4d48-8ab4-dddb4740f69f",
	"settings": {
		"document_type_key": "registration_certificate"
	}
}

Using a custom document type

You can define your own custom document type for your specific use-cases. For each custom document type, you can define a unique key, a label and for which entity it is applicable.

First, create custom document on the Console App in the workspace settings. You can list all the custom document types of your workspace using the endpoint List all custom document types

Then set the document_type_key using the custom document type key in the settings when creating the check, for instance:

{
	"company_id": "aa7632a3-0bb3-4d48-8ab4-dddb4740f69f",
	"settings": {
		  "document_type_key": "my_custom_document_type"
	}
}

Files

You can choose to create a Document Check with or without a File. You can learn how to upload a file and attach it to the Document Check in the File guide.

You can attach at most 5 files per document check.

{
  "company_id": "aa7632a3-0bb3-4d48-8ab4-dddb4740f69f",
  "settings": {
      "document_type_key": "my_custom_document_type"
  },
  "data": {
    "files": [
      {
        "upload_ref": "dG1wL2hlbGxvLWRvdGZpbGUtMTY3OTQ5ODQxMjcyNUZJUVFFLnBuZyxpbWFnZS9wbmcsaGVsbG8tZG90ZmlsZS5wbmc="
      },
      {
        "upload_ref": "dG1wL2hlbGxvLWRvdGZpbGUyLTE2Nzk0OTg0MTI3OTQyRklRUUUucG5nLGltYWdlL3BuZyxoZWxsby1kb3RmaWxlMi5wbmc="
      }
    ]
  }
}

If you create a Document Check without a File, you can omit data and the check will be in status In Progress waiting for a File.

Attach a File to an existing Document Check

You can to add a File to an existing Document Check in two situations:

For initial collection, Document Check is In Progress without a File (waiting for it)
For recollection, Document Check is Completed and Result is Rejected

You can upload a file and add it with the Add a File endpoint on an existing Document Check. You can learn more in the File guide.`

Review check result

On Console App

After the document has been uploaded, the check status is updated to Need review, meaning that your compliance analysts have to review the documents and decide to approve or reject the check (You can also add an optional comment) .

Via API

You can also send the review decision via the API endpoint Review a Document check.

In request body, you must specify the action:

approve: to change the result to Approved
reject: to change the to Rejected

Optionally, you can also pass a comment.

This will update the check data review object and the reviewer_type will be set to api.