📄Valify Sanction Shield

---

---

The Sanction Screening Product is a powerful tool that enables organizations to effectively identify sanctioned parties, combat money laundering, and comply with regulatory requirements. The solution is designed to address the challenges faced by our clients by streamlining the compliance process, thus minimizing manual effort and mitigating the risk of errors. This ensures a robust and efficient compliance mechanism for our clients. Moreover obtaining licensing from the Financial Regulatory Authority (FRA), further solidifying our commitment to providing robust sanction screening solutions.

Features & Benefits

Comprehensive Data Coverage

• Up-to-date information sourced from a wide range of international and local sanction lists.

• Ensures thorough screening against diverse databases, reducing the risk of overlooking sanctioned individuals or entities.

• Real-time updates eliminate the need for manual intervention, reducing human error and ensuring continuous compliance.

Advanced Search Capabilities

• Multi-language support (English and Arabic) for flexible screening options.

• Allows users to screen entities and individuals using their preferred language, improving user experience and accuracy.

• Cut-off score functionality: Enables users to set a threshold score for matches, allowing for customization based on risk tolerance and compliance requirements.

• Enhanced Targeted Screening: Adds an extra layer of filtering to handle partial match cases more effectively, reducing false positives and improving overall screening efficiency.

Easy Integration Options We offer multiple integration options to cater to different compliance workflows:

• Synchronous API Integration: Offers immediate feedback and decision-making during transactions.

• Asynchronous API Integration: Enables integration with existing systems, allowing for automated and real-time screening processes.

• Valify Portal Integration: Provides a user-friendly interface for manual screening and access to sanction lists, catering to varying user preferences and needs.

Sanction Documentation

Synchronous API Integration

Functionality v2 of Sanction Screening Product can be consumed synchronously.

An API call is made to create a sanction search, using the available search terms (Full Name and/or Document Number) and it will return a transaction ID, trials renaming and the result of the search

/api/v2/sanction-shield/search/ for creating a search attempt and receiving the result of that search

Endpoints

1- Search

Create a search attempt by sending the fields to be searched and the values that need to be searched for. Each field should include:

• field_name (Currently supported fields are full_name and document_number)* • value

• cutoff_match_score (Float between 0.0 and 1.0, 1 being an exact match)

*Always check spelling of the input into field_name

URL

Endpoint: /api/v2/sanction-shield/search/

• result key contains a list of matching entries. Each entry will include the following details:

• data: Contains the specific data fields that matched the search criteria, such as document number and full name.

• sanction_list: Indicates which sanction list did the record match in.

• matched_records: Provides information about the fields that contributed to the match, including the field name and the match score.

the result key contains the following if a match is found:

otherwise if a match is not found:

Sample Code Snippet

Note: you can search in multiple sanction lists, and using one full_name and/or one document_number.

Asynchronous API Integration

Headers

Name	Type	Description
Content-Type*	string	application/json
Authentication*	string	Bearer <access-token>

1) Search

Create a search attempt by sending the fields to be searched and the values that need to be searched for.

POST https://valifystage.com/api/v1/sanction-shield/search

Name	Type	Request body	Response
data*	object	Object containing the parameters below: { "bundle_key": "<str>", "fields": [ { "field_name": "<str>", "value": "<str>", "cutoff_match_score": <float>, }, ... ], "sanction_lists": [ "<str>", "<str>", ... ], "lang": "<str>" #optional }	{ "transaction_id": "<string>", "trials_remaining": <int> }

2) Result

Inquire about the transaction results using the transaction ID obtained from the search attempt.

POST https://valifystage.com/api/v1/sanction-shield/result

Name	Type	Request body	Response
data*	object	{ "bundle_key": "<str>", "transaction_id": "<str>", }	{ "status": "<str>", "matched_records": [ { "data": { "document_number": "<str>", "full_name": "<str>" }, "source_list": "<str>", "matched_fields": [ { "field_name": "document_number", "match_score": <float> }, ... ] }, ... ] }

Code Snippet

Python

import json
import requests
import time

# API endpoint URLs
search_url = "<base-url>/api/v1/sanction-shield/search/"
result_url = "<base-url>/api/v1/sanction-shield/result/"

token = '<token>'

# Search API Call
data = {
    "bundle_key": "<str>",
    "fields": [
      {
        "field_name": "<str>",
        "value": "<str>",
        "cutoff_match_score": <float>,
      },
      ...
    ],
    "sanction_lists": [
      "<str>",
      "<str>",
      ...
    ],
    "lang": "<str>"  # optional
}
r = requests.post(
    search_url,
    json=data,
    headers={'Authorization': 'Bearer %s' % token}
)

print(r.json())

if r.status == 200:
    # Poll the Result until status is no longer pending
    transaction_id = r.json()['transaction_id']
    
    # This snippet polls every 2 seconds for a maximum of one minute
    for i in range (30):
        data = {
            "bundle_key": "<str>",
            "transaction_id": transaction_id,
        }
        r = requests.post(
            result_url,
            json=data,
            headers={'Authorization': 'Bearer %s' % token}
        )
        if r.status_code == 200 and r.json["status"] == "successful":
            break

        time.sleep(2)

    print(r.json())

Potential Errors:

Action	Error Message	Code
Not subscribed to list or wrong list name	Invalid Sanction list.	5048
Using Multiple names or document numbers together	Multiple names or document numbers detected in the request.	400

For more information, please contact our sales team at [e-mail].