Configuring ComplyAdvantage
ComplyAdvantage is a data provider you can use to run these checks:
- PEPs and sanctions screening (individuals)
- Sanctions and adverse media screening (companies)
PEPs and sanctions screening (individuals)
How it works
This is the default behaviour for a variant of the PEPs and sanctions screening check with ComplyAdvantage as the data provider.
The check is performed by screening an individual’s name and, when available, date of birth and nationality through ComplyAdvantage’s sources to provide a list of the individual’s potential matches to sanctions and politically exposed persons (PEPs).
If no potential matches are found for the individual (and the individual doesn't have potential matches returned from earlier screening checks), the check is marked Completed.
If any potential matches are found, the check returns Unresolved events and the matches are displayed in the check results. By default, all matches are displayed in the Potential matches list.
For every match that’s discovered, a detailed portfolio is displayed. This portfolio provides all available information from ComplyAdvantage about the match’s biography, associates, political exposure, events, and sources.
This check variant is supported for all countries.
name_variations
. For help setting up this custom search setting, please speak to your ComplyAdvantage account manager.Configuration options
You have the following configuration options:
- ComplyAdvantage fuzzy match configuration for names (required): Insert a value between 0.0 (exact match) to 1.0 (loose). The value here should match the settings you’re using for your ComplyAdvantage account. To get more information about this value or your account settings, please contact your ComplyAdvantage account manager.
- Enable ongoing monitoring (optional): When this option is selected, any time a new match is discovered by ComplyAdvantage, the check’s task is marked incomplete, and, if the profile’s application is approved, it’s put into review. When this option is deselected, new matches are only returned from ComplyAdvantage when a user runs the check manually or, if your policy specifies, when a new task version is added to the application. Learn more about monitored applications.
- Include adverse media matches (optional): When this option is selected, PassFort displays instances of adverse media returned from ComplyAdvantage.
- Ignore historical matches (optional): When this option is selected, PassFort removes any matches that ComplyAdvantage previously listed as politically exposed or sanctioned but are not on any current lists.
- Name settings for false positive reduction (required): This is one of three options contributing to PassFort’s false positive reduction service. It determines how PassFort treats results returned from ComplyAdvantage when a result’s name does not match the name on the profile. The value for the option must be one of the following: Allow any matches, Allow close or exact matches, or Allow exact matches.
- Date of birth settings for false positive reduction (required): This is one of three options contributing to PassFort’s false positive reduction service. It determines how PassFort treats results returned from ComplyAdvantage when a result’s date of birth does not match the profile’s date of birth. The value for the option must be one of the following: Allow any matches, Allow close or exact matches, or Allow exact matches.
- Nationality settings for false positive reduction (required): This is one of three options contributing to PassFort’s false positive reduction service. It determines how PassFort treats results returned from ComplyAdvantage when a result’s country of nationality does not match the profile’s country of nationality. The value for the option must be one of the following: Allow any matches, Allow close or exact matches, or Allow exact matches.
- ComplyAdvantage search profile configuration (optional with a direct agreement): Add the name of a ComplyAdvantage search profile, and the associated search filters (and any other configurable options) are applied by ComplyAdvantage to reduce false positives.
What we’ll need
Let us know that you’d like to add a PEPs and sanctions screening check variant with ComplyAdvantage and let us know which configuration options you’d like to use. We’ll set it up for you.
We'll also need you to:
- Send us your ComplyAdvantage API key.
- Create a ComplyAdvantage webhook with the URL we’ve sent you.
Learn how to get your API key and create a webhook.
Testing your configuration
Once the check variant is configured, follow these steps in your demo environment to test whether it's working as expected.
- Does the check complete when no matches are returned from ComplyAdvantage? To run the test, create an individual profile (with no other potential matches returned from previous screening checks) and run the check variant. If the check is marked Completed and there are no potential matches displayed in the check results, it’s working as expected.
- Do the check results display PEPs matches returned from ComplyAdvantage? To run the test, create an individual profile with "Hugo" as the first name and "Chavez" as the surname, and run the check variant. If the check status is Unresolved events and there are PEPs matches displayed in the check results, it’s working as expected.
- Do the check results display sanctions matches returned from ComplyAdvantage? To run the test, create an individual profile with "Bashar" as the first name and "Assad" as the surname. If you're using any false positive reduction configuration options, ensure the date of birth is 11 September 1965. Run the check variant. If the check status is Unresolved events and there are PEPs and sanctions matches displayed in the check results, it’s working as expected.
When the check is configured to include adverse media results:
- Do the check results display adverse media matches returned from ComplyAdvantage? To run the test, create an individual profile with "Robert" as the first name and "Mugabe" as the surname, and run the check variant. The check status should be Unresolved events and matches should be displayed in the check results. If, when you click the names of the matches, there are adverse media results displayed under Sources, it's working as expected.
When ongoing monitoring is configured:
- To see what happens when new results are returned during ongoing monitoring, follow the API steps in Test ongoing monitoring.
Profile fields
These are the profile details searched in ComplyAdvantage’s sources:
PassFort name | Description | ComplyAdvantage field details |
First name(s) ( Required | The individual’s first and, if applicable, middle names. |
|
Surname ( Required | The individual’s last name. |
|
Date of birth ( Optional | The individual’s date of birth. |
|
Nationality ( Optional | The individual’s country of nationality. |
Sent as an ISO alpha2 country code |
Entity type ( | This field indicates that this is an individual, rather than a company. |
|
Sanctions and adverse media screening (companies)
How it works
This is the default behaviour for a variant of the Sanctions and adverse media screening check with ComplyAdvantage as the data provider.
The check is performed by screening a company’s name and country of incorporation through ComplyAdvantage’s sources to provide a list of the company’s potential sanctions matches and (if you have access to ComplyAdvantage’s PEPs results) PEPs matches.
If no potential matches are found for the company (and the company doesn't have potential matches returned from earlier screening checks), the check is marked Completed.
If any potential matches are found, the check returns Unresolved events and the matches are displayed in the check results. By default, all matches are displayed in the Potential matches list.
For every match that’s discovered, a detailed portfolio is displayed. This portfolio provides all available information from ComplyAdvantage about the match’s biography, associates, political exposure, events, and sources.
This check variant is supported for all countries.
Configuration options
You have the following configuration options:
- ComplyAdvantage fuzzy match configuration for names (required): Insert a value between 0.0 (exact match) to 1.0 (loose). The value here should match the settings you’re using for your ComplyAdvantage account. To get more information about this value or your account settings, please contact your ComplyAdvantage account manager.
- Enable ongoing monitoring (optional): When this option is selected, any time a new match is discovered by ComplyAdvantage, the check’s task is marked incomplete, and, if the profile’s application is approved, it’s put into review. When this option is deselected, new matches are only returned from ComplyAdvantage when a user runs the check manually or, if your policy specifies, when a new task version is added to the application. Learn more about monitored applications.
- Include adverse media matches (optional): When this option is selected, PassFort displays instances of adverse media returned from ComplyAdvantage.
- Ignore historical matches (optional): When this option is selected, PassFort removes any matches that ComplyAdvantage previously listed as politically exposed or sanctioned but are not on any current lists.
- Name settings for false positive reduction (required): This is one of three options contributing to PassFort’s false positive reduction service. It determines how PassFort treats results returned from ComplyAdvantage when a result’s name does not match the name on the profile. The value for the option must be one of the following: Allow any matches, Allow close or exact matches, or Allow exact matches.
- Company incorporation date settings for false positive reduction (required): This is one of three options contributing to PassFort’s false positive reduction service. It determines how PassFort treats results returned from ComplyAdvantage when a result’s date of incorporation does not match the profile’s date of incorporation. The value for the option must be one of the following: Allow any matches, Allow close or exact matches, or Allow exact matches.
- Country settings for false positive reduction (required): This is one of three options contributing to PassFort’s false positive reduction service. It determines how PassFort treats results returned from ComplyAdvantage when a result’s country of incorporation does not match the profile’s country of incorporation. The value for the option must be one of the following: Allow any matches, Allow close or exact matches, or Allow exact matches.
- ComplyAdvantage search profile configuration (optional with a direct agreement): Add the name of a ComplyAdvantage search profile, and the associated search filters (and any other configurable options) are applied by ComplyAdvantage to reduce false positives.
What we’ll need
Let us know that you’d like to add a Sanctions and adverse media screening check variant with ComplyAdvantage and let us know which configuration options you’d like to use. We’ll set it up for you.
We’ll also need you to:
- Send us your ComplyAdvantage API key.
- Create a ComplyAdvantage webhook with the URL we’ve sent you.
Learn how to get your API key and create a webhook.
Testing the configuration
Profile fields
These are the profile details searched in ComplyAdvantage’s sources:
PassFort name | Description | ComplyAdvantage field details |
Company name ( Required | The company’s name. |
|
Country of incorporation ( Required | The country in which the company is incorporated. |
Sent as an ISO alpha2 country code |
Entity type ( | This field indicates that this is a company, rather than an individual. |
|
Getting your ComplyAdvantage API key and creating a webhook
To get your ComplyAdvantage API key:
- Log into your ComplyAdvantage account.
- Click the API option from the menu.
- Click API Keys.
- Under Create a new API Key, add a name for the key in the field provided. We recommend calling the key "PassFort", but it can have any name you choose.
- Click Create. The key is created.
- Send us the text displayed under Key.
To create a webhook:
- Log into your ComplyAdvantage account.
- Click the API option from the menu.
- Click API Webhooks.
- Under Create a new Web Hook, add a name for the webhook in the field provided. We recommend calling the webhook "PassFort", but it can have any name you choose.
- For the Endpoint, add the Webhook Url from the PassFort Policy Builder. To get the URL, log into your live PassFort environment, go to Policy Builder > Data providers, and click ComplyAdvantage (from Individual data providers or Company data providers). Ensure you're using your live PassFort account rather than your demo account for this step.
- Set the Type to Monitored Search Updates.
- Click Create.