AML Verification
Beta
Last updated: November 28, 2024
After you have successfully verified a user's identity with Identity Verification, you can perform additional anti-money laundering (AML) checks.
With the AML Verification solution, Checkout.com returns an initial risk score for the user and, if it's below a certain threshold, checks if the user appears in any of the following databases:
- Politically exposed persons (PEP)
- Sanctions
- Adverse media
If there are exact or fuzzy matches for the user in a database, we raise screening alerts for you to investigate and either approve or decline the user. If there are no matches, the user is automatically approved.
Information
To enable AML Verification, contact your Account Manager or [email protected].
- You must have already integrated the Identity Verification solution and verified the user.
- The user must already have an
applicant_id
. - Prepare to handle the verification statuses and webhook notifications about flow events and the result.
- Contact our partner ComplyAdvantage to request API credentials and access to the ComplyAdvantage Dashboard to manage and investigate cases. Enter your API credentials in the IDV Dashboard.
In the ComplyAdvantage Dashboard, you can configure the following to meet your business requirements:
- The risk score model for all your verifications
- The screening checks Checkout.com performs for a specific verification
For example, which databases to screen and how to handle fuzzy matches. You receive a uniqueconfiguration_identifier
that you must provide when you create the AML verification.
You can monitor AML verifications to receive the following additional webhook notifications:
aml_verification_monitoring_alert
– An alert was raised and you need to investigate the case.aml_verification_monitoring_reviewed
– You've finished investigating the case, a case was re-opened, or the user's status was updated.
- Create an AML verification.
- Handle the verification result.
- If alerts are raised, investigate the case.
- To see the final result, you can retrieve the verification.
Call the Create an AML verification endpoint, and provide the user's applicant_id
from a previous identity verification.
- To apply a configured risk score model or set of screening checks, provide the configuration ID in the
configuration_identifier
field. - To monitor the verification, set the
monitored
boolean totrue
.
post
https://identity-verification.checkout.com/aml-verifications
1{2"applicant_id": "aplt_tkoi5db4hryu5cei5vwoabr7we",3"search_parameters": {4"configuration_identifier": "8eb79430-c014-41e5-be73-2c2c091322b8"5},6"monitored": true7}
A successful response returns:
- The verification
id
, which you need to retrieve the verification result - The verification status
1{2"id": "amlv_tkoi5db4hryu5cei5vwoabr7we",3"created_on": "2024-07-21T17:32:28Z",4"modified_on": "2024-07-21T17:40:32Z",5"status": "created",6"applicant_id": "aplt_tkoi5db4hryu5cei5vwoabr7we",7"search_parameters": {8"configuration_identifier": "8eb79430-c014-41e5-be73-2c2c091322b8"9},10"monitored": true,11"_links": {12"self": {13"href": "https://identity-verification.checkout.com/aml-verifications/amlv_tkoi5db4hryu5cei5vwoabr7we"14},15"applicant": {16"href": "https://identity-verification.checkout.com/applicants/aplt_tkoi5db4hryu5cei5vwoabr7we"17}18}19}
Checkout.com informs you of events during the verification process and the result via webhook notifications.
The notifications include the verification status and the risk_level
score, which can be one of the following:
Risk level | Outcome |
---|---|
| Checkout.com automatically performs the database checks. |
| |
| |
| The verification status automatically changes to |
If the verification raises screening alerts for database matches, Checkout.com creates a case and updates the verification status to review_required
.
Manually review the case in the ComplyAdvantage Dashboard and decide whether to accept or decline the risk associated with the user. You can:
- Change the status of a database match.
- Add an entity to an allowlist to prevent further alerts.
- Change the verification status.
If you perform any of these actions, you receive an aml_verification_status_updated
webhook notification with an updated status
value.
To view the final result, call the Retrieve an AML verification endpoint, and provide the verification id
you received in the Create an AML verification response as the aml_verification_id
path parameter. For example, amlv_tkoi5db4hryu5cei5vwoabr7we
.
get
https://identity-verification.checkout.com/aml-verifications/{aml_verification_id}
1{2"id": "amlv_tkoi5db4hryu5cei5vwoabr7we",3"created_on": "2017-07-21T17:32:28Z",4"modified_on": "2017-07-21T17:40:32Z",5"status": "created",6"applicant_id": "aplt_tkoi5db4hryu5cei5vwoabr7we",7"search_parameters": {8"configuration_identifier": "8eb79430-c014-41e5-be73-2c2c091322b8"9},10"monitored": false,11"_links": {12"self": {13"href": "https://identity-verification.checkout.com/aml-verifications/amlv_tkoi5db4hryu5cei5vwoabr7we"14},15"applicant": {16"href": "https://identity-verification.checkout.com/applicants/aplt_tkoi5db4hryu5cei5vwoabr7we"17}18}19}