> For the complete documentation index, see [llms.txt](https://docs.compliance.phalcon.blocksec.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.compliance.phalcon.blocksec.com/integrations/cobo.md).

# Cobo

This guide explains how to use Phalcon Compliance as an AML screening service provider in [Cobo Portal](https://www.cobo.com/). Cobo's [Screening app](https://manuals.cobo.com/en/apps/screening/introduction) natively integrates with Phalcon Compliance (displayed as **BlockSec**) to automatically screen incoming and outgoing transactions in MPC wallets and Web3 wallets.

## Prerequisites

* An active Phalcon Compliance account with a **Scale** plan or higher (API access required). For details, see [Plans, Billing, and Payments](https://docs.compliance.phalcon.blocksec.com/manual/account/plans-billing-and-payment.md).
* A Phalcon Compliance API key (see [API Keys](https://docs.compliance.phalcon.blocksec.com/manual/account/api-keys.md))
* A Cobo Portal account with administrator access

## How It Works

Cobo's Screening app intercepts transactions in Cobo wallets and sends them to Phalcon Compliance for risk assessment. Based on the assessment results and your configured policies, transactions are automatically approved, flagged for review, or rejected.

1. Initiate or receive a transaction in your Cobo wallet.
2. The Screening app checks whether the transaction meets your screening criteria, such as transaction direction and amount thresholds.
3. If screening is required, Cobo sends the transaction details to Phalcon Compliance for risk assessment.
4. Phalcon Compliance returns a risk assessment result with one of four risk levels: **Critical**, **High**, **Medium**, or **Low**.
5. Cobo applies your post-screening policy based on the risk level:
   * **Approve** — Incoming: release the funds. Outgoing: allow the transaction to proceed.
   * **Approve and alert** — Same as “Approve,” but sends a risk notification to your compliance team.
   * **Reject** — Incoming: flag the transaction and freeze the funds (frozen funds are not automatically swept). Outgoing: block the transaction. The system always sends a risk notification.
   * **Manual review** — Pause the transaction and wait for your compliance team to manually approve or reject it.
6. For incoming transactions that have been rejected and frozen, your compliance team can take further action:
   * **Unfreeze** — Release the frozen funds so they can be used normally.
   * **Refund** — Return the funds to a specified address.
   * **Quarantine** — Transfer the funds to a specified quarantine address.

## Set Up the Integration

### Step 1: Install the Screening App

In Cobo Portal, go to the App Store and install the **Screening** app. Grant the required permissions for the wallets you want to monitor.

### Step 2: Select BlockSec as the AML Service Provider

1. Open the Screening app, then go to [**Screening Settings**](https://manuals.cobo.com/en/apps/screening/screening-settings).
2. Under **AML Service Provider**, select **BlockSec**.
3. Enter your Phalcon Compliance **API key**.
4. Save the configuration.

### Step 3: Configure Screening Policies

Configure screening behavior in Cobo:

* **Transaction screening policy** — Define tiered screening rules based on transaction amounts in USD. For each tier, choose to bypass screening, screen through Phalcon Compliance, or route to a custom API.
* **Internal and external transfers** — Configure different screening rules for transfers between your own wallets and transfers involving external addresses.
* **Screening timeout** — Choose how transactions are handled when an AML screening takes longer than expected.
* **Refund and quarantine screening** — Optionally enable AML checks for refund and quarantine transactions.

### Step 4: Set Up Post-Screening Rules

Configure [post-screening policies](https://manuals.cobo.com/en/apps/screening/risk-policies) to automatically handle transactions based on their risk levels. You can define different actions for incoming and outgoing transactions and set amount thresholds for each risk level.

### Step 5: Configure Notifications

Add notification recipients in the Screening app settings to ensure your compliance team receives alerts about screening events. You can also [view and manage screening results](https://manuals.cobo.com/en/apps/screening/viewscreening) in the Screening app.

## Next Steps

* [Risk Engine](https://docs.compliance.phalcon.blocksec.com/manual/configure/risk-engines.md): Customize the risk thresholds and indicators used by Phalcon Compliance.
* [Notification Channels](https://docs.compliance.phalcon.blocksec.com/manual/configure/notification-channels.md): Set up additional alerts in Phalcon Compliance.
* [API Keys](https://docs.compliance.phalcon.blocksec.com/manual/account/api-keys.md): Manage your API credentials.
* [Plans, Billing, and Payments](https://docs.compliance.phalcon.blocksec.com/manual/account/plans-billing-and-payment.md): View plan options that support API access.
