{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-user-guide/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"redocly_category":"User Guide","type":"markdown"},"seo":{"title":"Set Policy Rules on Screening Results"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"set-policy-rules-on-screening-results","__idx":0},"children":["Set Policy Rules on Screening Results"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Screening results are a first-class input to the Fordefi policy engine. A policy"," ","rule can use a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transaction Screening"]}," condition to act on what a screening provider found, so"," ","that a flagged transaction is blocked or an approved transaction is allowed."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Transaction Screening condition is part of the regular transaction policy, alongside the"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/policies/policy-rules-conditions-and-actions"},"children":["other rule conditions"]},". It"," ","is not part of the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/aml/aml-policies"},"children":["AML policy"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"transaction-screening-condition","__idx":1},"children":["Transaction Screening condition"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A Transaction Screening condition selects a provider and one or more of that provider's results."," ","The result field is multi-select, so a single condition can cover several"," ","severities for the same provider:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Provider"},"children":["Provider"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Selectable results"},"children":["Selectable results"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Blockaid"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Benign"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Malicious"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Warning"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Hypernative"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accept"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Auto Accept"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Deny"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Warn"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To match on both providers, add a Transaction Screening condition for each one, or write a"," ","separate rule per provider."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"availability","__idx":2},"children":["Availability"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Transaction Screening condition depends on the providers your organization has"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/screening/config-screening"},"children":["activated"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If your organization has no credentials for a given provider, that provider is"," ","greyed out in the condition and cannot be selected."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If your organization has no credentials for any provider, the Transaction Screening condition"," ","is greyed out in the conditions list and cannot be added to a rule."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You also cannot deactivate a provider while a policy rule still uses a Transaction Screening"," ","condition for it. Remove or edit those rules first."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-rule-on-a-screening-result","__idx":3},"children":["Create a rule on a screening result"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Follow the instructions in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/policies/create-a-policy-rule#create-a-new-policy"},"children":["Create a policy rule"]},". When adding a condition, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transaction Screening"]}," from the condition categories."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-rules","__idx":4},"children":["Example rules"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Hard block on a denied transaction:"]}," A rule whose only condition is"," ","for the provider Hypernative and value ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Deny"]},", and whose action is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Block"]},", stops any transaction"," ","that Hypernative denies."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Stronger approvals for flagged transactions above a threshold:"]}," A rule with"," ","the condition on the provider Blockaid and value ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Warning"]}," and a transaction amount over"," ","USD 100,000, and an action of ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Require Approval"]}," with an admin quorum, lets"," ","small flagged transactions through the normal flow while escalating large"," ","ones."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Escalate anything either provider flags:"]}," Two rules, one per provider, each"," ","selecting both of that provider's results and requiring approval."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Allow verified transactions:"]}," A rule with a condition on the provider ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Hypernative"]}," and the values ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Approve"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Autoapprove"]},", or on the provider Blockaid with the value ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Benign"]},", and an action of ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Allow"]},", will allow every transaction the provider deemed safe."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-a-screening-result-is-unavailable","__idx":5},"children":["When a screening result is unavailable"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A transaction with no usable screening result is still evaluated against your"," ","policy. What a Transaction Screening condition does then depends on why the result is missing:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Unsupported chain:"]}," The Transaction Screening condition does not match, and policy"," ","evaluation continues to the next rule."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Timeout, or provider error:"]}," The result is"," ","indeterminate, and Fordefi falls back to the default policy rule, as it does"," ","when ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/manage-transactions/override-simulation#policy-enforcement"},"children":["simulation data is missing"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Because an unavailable provider falls back to the default rule, a permissive"," ","default rule weakens every screening rule above it. We recommend"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/policies/sample-policies#set-basic-approvals"},"children":["setting a strict default rule"]},"."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Skipping prediction skips screening"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A transaction created through the API with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["skip_prediction"]}," set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," is"," ","not screened, so no Transaction Screening condition can match it. See"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/developers/transaction-screening"},"children":["Transaction screening in the API"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Learn more:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/policies/policy-rules-conditions-and-actions"},"children":["Rule Conditions and Actions"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/policies/create-a-policy-rule"},"children":["Create a policy rule"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/screening/screening-results"},"children":["View transaction screening results"]}]}]}]},"headings":[{"value":"Set Policy Rules on Screening Results","id":"set-policy-rules-on-screening-results","depth":1},{"value":"Transaction Screening condition","id":"transaction-screening-condition","depth":2},{"value":"Availability","id":"availability","depth":3},{"value":"Create a rule on a screening result","id":"create-a-rule-on-a-screening-result","depth":2},{"value":"Example rules","id":"example-rules","depth":3},{"value":"When a screening result is unavailable","id":"when-a-screening-result-is-unavailable","depth":2}],"frontmatter":{"seo":{"title":"Set Policy Rules on Screening Results"}},"lastModified":"2026-09-17T11:28:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/user-guide/screening/screening-policy-rules","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}