{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-user-guide/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img","admonition"]},"redocly_category":"User Guide","type":"markdown"},"seo":{"title":"Configure a Transaction Screening Provider"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"configure-a-transaction-screening-provider","__idx":0},"children":["Configure a Transaction Screening Provider"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only organization admins can configure transaction screening providers. A"," ","provider becomes active for your organization the moment valid credentials for"," ","it are successfully configured."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Screening is applied to new transactions as soon as the provider is"," ","activated. Transactions created before activation are not screened"," ","retroactively."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-you-start","__idx":1},"children":["Before you start"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Obtain credentials from the provider you want to use:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Blockaid:"]}," An API key. Refer to the"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.blockaid.io/"},"children":["Blockaid documentation"]}," for how to create one."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Hypernative:"]}," A client ID and a client secret. Refer to the"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.hypernative.xyz/"},"children":["Hypernative documentation"]}," for how to create"," ","them."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"activate-a-provider","__idx":2},"children":["Activate a provider"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open the Fordefi web console."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the side menu, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Screening"]},". The"," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transaction screening"]}," section lists Blockaid and Hypernative, each with a"," ","status of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Inactive"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Active"]},"."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/transaction-screening.35c2fe7051673f20ccb6f71eaefe2fb819b31e8a166e08797692b0f9267018c6.9c1bb791.png","alt":"alt","framed":false,"withLightbox":false,"width":"700","border":"1px solid lightgray"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the row of the provider you want to activate, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Configure"]},"."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/transaction-screening-config.ee83a15d4a92a2fac435651b2b044e5a36d151ff1d247b3db0fbd7501d42b65d.9c1bb791.png","alt":"alt","framed":false,"withLightbox":false,"width":"300","border":"1px solid lightgray"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enter the provider's credentials in the secure input fields."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Configure"]},". Fordefi validates the credentials against the provider's API"," ","before storing them:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If validation succeeds, the credentials are saved and the provider's status"," ","changes to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Active"]},"."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"manage-an-active-provider","__idx":3},"children":["Manage an active provider"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the row of an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Active"]}," provider, click the ellipsis menu ⋮ to access the"," ","following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit credentials:"]}," Replace the stored credentials. The new credentials must"," ","pass validation before they replace the existing ones, so a failed validation"," ","leaves the provider working with its previous credentials."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Test connection:"]}," Re-validate the stored credentials against the provider's"," ","API and show the result. Use this to confirm that credentials that worked when"," ","saved are still valid, for example after rotating a key on the provider's"," ","side."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Deactivate:"]}," Stop screening transactions with this provider."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"deactivate-a-provider","__idx":4},"children":["Deactivate a provider"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["On the row of an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Active"]}," provider, click the ellipsis menu ⋮ and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Deactivate"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm the deactivation."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The provider's credentials are removed and its status returns to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Inactive"]},". New"," ","transactions are no longer screened by that provider."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Remove policy rules first"},"children":[" If any policy rule"," ","uses a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/screening/screening-policy-rules"},"children":["Transaction Screening"]}," for the provider, the"," ","deactivation is blocked and Fordefi shows you which rules to change. Remove or"," ","edit those rules, then deactivate the provider. "]}]},{"$$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/screening/screening-results"},"children":["View transaction screening results"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/screening/screening-policy-rules"},"children":["Set policy rules on screening results"]}]}]}]},"headings":[{"value":"Configure a Transaction Screening Provider","id":"configure-a-transaction-screening-provider","depth":1},{"value":"Before you start","id":"before-you-start","depth":2},{"value":"Activate a provider","id":"activate-a-provider","depth":2},{"value":"Manage an active provider","id":"manage-an-active-provider","depth":2},{"value":"Deactivate a provider","id":"deactivate-a-provider","depth":2}],"frontmatter":{"seo":{"title":"Configure a Transaction Screening Provider"}},"lastModified":"2026-09-17T11:28:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/user-guide/screening/config-screening","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}