Get started with Payment Screening on Mesh

Last updated: November 18, 2026

Payment Screening enables you to screen payments in real-time against:

  • Our sanctions intelligence data

  • Your internal (custom managed) lists.

Both capabilities embed the screening process into your payment authorization flow.

Below are step-by-step instructions on configuring and using Payment Screening.

1. Payment screening configurations

Purpose

The configurations determine:

• The sanctions lists or custom lists to be used for screening the payment.

• The selection of relevant payment attributes to screen (name, BIC, reference text)

• The level of fuzziness in the matching process for each attribute.

Payment screening configuration with name, BIC and reference text source collections, each with its own settings
Payment screening configuration with name, BIC and reference text collections

Managing configurations

Payment screening configurations are accessible via API and UI. Please find the API documentation here.

 

2. Submitting payments for screening

Submission method

Payments are submitted for screening through a synchronous API endpoint. In production, you will be able to incorporate these API calls directly into your workflow, ensuring real-time responses.
You can also submit payments in a file through batch transaction upload, with Upload on the Transactions page or with POST /v2/batch-processing and the create-and-monitor workflow. Each row is screened asynchronously with the Payment Screening configuration named in its payment_screening_configuration_identifier column, so no real-time hold or process decision is returned. Batch upload needs Transaction Monitoring on your account: every row must also name a Transaction Monitoring scenario configuration. If your account has Payment Screening without Transaction Monitoring, contact your Customer Success Manager.

For further information on access and endpoint usage, refer to the access documentation provided and the API documentation.

 

3. Managing cases

Case creation

If the payment details and a list specified in the payment screening configuration match, a case is automatically generated.

Cases appear within the Mesh Cases area, alongside other cases (such as Customer Screening and Monitoring as well as Transaction Monitoring).

The Mesh Cases area, where Payment Screening cases sit alongside other case types
Payment Screening cases in the Mesh Cases area

Although the structure of these cases is similar, Payment Screening cases specifically involve screening elements of a payment message, including:

• Debtor name

• Creditor name

• Names of other parties involved

• Reference text

• BIC code

Case review

Analysts can now review the transaction details alongside the matched profiles for a holistic review in a single view.  Payment Screening cases contain profile hits that need to be reviewed as part of the investigation. Once you have identified if the profile is a true or false positive, you can assign the respective status.

A Payment Screening case with the transaction details beside the matched profiles
A Payment Screening case with transaction details and matched profiles

4. Transaction decisions for held transactions

The analyst determines whether to process or reject the payment. Your system receives this decision through webhook updates, allowing seamless integration into the payment authorization flow. The related API documentation can be found here.