How to screen a payment reference text against risk words

Last updated: November 5, 2026

Risk word screening is an extension to the custom list capability described in this article. It lets users create their own lists of high-risk terms and allows payment reference texts to be screened against them. This could for example include references to sanctioned jurisdictions, prohibited goods, or high-risk activities (i.e. terms such as firearm, drugs etc.).

Screening payment reference texts against risk words

First step: Create your Risk Words List

  1. In the settings area go to ‘Lists’ settings

  2. Select Risk Words List

  3. Select Create




    The Risk Words List page in Lists settings, with the Create button
  4. Name your list


    The name field when creating a new Risk Words List
  5. Upload your file containing the relevant risk words.

  6. The system validates the file and reports back the upload summary.



    The upload summary returned after the risk words file is validated
  7. The list appeared as successfully uploaded



    And appears accordingly on the overview page


    The new risk words list after a successful uploadRisk words list page showing the uploaded file as Completed, with 4 risk words listed under All uploads

Second step: Create your Screening Configuration including Risk Words List

  1. From the payment screening configuration, select ‘Reference Text (Custom Sources’ as your screening term



    A payment Screening Configuration with Reference Text (Custom Sources) as the screening term
  2. Select the Risk Words List you want to screen against, set your required fuzziness and click ‘add’



    The Risk Words List selection with its fuzziness setting and the add button
  3. The Source collection is added and the Risk Words LIst appears in the Source Breakdown



    Reference text is the only screenable dimension available for this collection type.

    The Screening Configuration Source Breakdown with the risk words list added
  4. Save the configuration. Subsequent payment transactions with reference text are screened against the attached risk word terms.


    Payment screening configuration with a Risk Words source collection under Reference text settings at 50 percent fuzziness
  5. If a transaction's reference text matches a configured term, the system generates a case with a Risk words risk type in the case list, showing the matched term, the triggering reference text, and the source list name.

    A Case with the Risk words risk type, showing the matched term and source list


What you need to know

  • Permissions: Risk word screening is gated behind a dedicated account-level permission. Users without the relevant permission will not be able to create, manage, see or select risk words lists. It is off by default and must be enabled per account.

  • Scope: This applies to Payment Screening on Mesh only. It is not available for CSOM screening.

  • Coverage: Risk word screening runs across all four monetary transaction schemas (bank payment, remittance, crypto, and card) wherever reference text is present. Transactions without reference text are processed without error and do not generate risk word matches.

  • Dimension: Risk words lists can only be screened against reference text. They cannot be used to screen name or BIC fields.

  • Matching behavior: Matching uses the same n-gram search used for sanctions screening today. Customers will be able to configure the fuzziness level for the risk word list.

Reference text settings with the Fuzziness dropdown open, listing 100 to 0 percent, with 50 percent (default) selected

API access:

Risk word lists can also be created, updated, and deleted via the Risk word API endpoints. See the API documentation for details.