> 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/ru/integrations/fireblocks.md).

# Fireblocks

В этом руководстве объясняется, как использовать Phalcon Compliance вместе с [Fireblocks](https://www.fireblocks.com/) для проверки исходящих и входящих транзакций на риски AML/CFT. Объединив две платформы, вы сможете проверять исходящие транзакции до их выполнения и отслеживать входящие транзакции сразу после того, как Fireblocks обнаружит их.

## Предварительные требования

**Необходимо для базовой настройки:**

* Активная учетная запись Phalcon Compliance с API-ключом (см. раздел [API Keys](https://docs.compliance.phalcon.blocksec.com/ru/user-manual/account/api-keys.md))
* Рабочая область Fireblocks с доступом к webhook или API

**Необходимо только для расширенной настройки:**

* **API Co-Signer** для автоматической проверки исходящих транзакций через callback handler (см. раздел [Fireblocks Co-Signer Overview](https://developers.fireblocks.com/docs/use-cosigners-for-signing-automation))
* **Manual Screening Verdicts** для процесса вынесения вердиктов по входящим транзакциям вручную (обратитесь к своему менеджеру по работе с клиентами Fireblocks, чтобы включить эту функцию)

## Проверка исходящих транзакций

Когда ваша организация отправляет средства через Fireblocks, вы можете использовать Phalcon Compliance для проверки адреса назначения **до** подписания и трансляции транзакции. Есть два способа:

### Вариант 1: Предварительная проверка через API Phalcon

Перед отправкой транзакции в Fireblocks используйте API Phalcon Compliance, чтобы проверить адрес назначения. На основе оценки риска ваша команда решает, следует ли продолжать.

**Как это работает:**

1. Ваша команда отправляет адрес назначения в Phalcon Compliance через API [Проверка одного адреса](https://docs.compliance.phalcon.blocksec.com/ru/api-documentation/address-screening/screen-a-single-address.md) или панель управления Phalcon.
2. Phalcon Compliance возвращает оценку риска, включая уровень риска, индикаторы риска и сведения о подверженности риску.
3. Ваша команда изучает результаты и принимает решение на основе внутренних политик комплаенса:
   * **Неприемлемый риск** — Отклоните транзакцию. Не отправляйте ее в Fireblocks.
   * **Приемлемый риск** — Перейдите к созданию транзакции в Fireblocks.
4. Если транзакция одобрена, отправьте ее в Fireblocks через API или консоль Fireblocks.

<figure><img src="https://3440913522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdOfakg6W4j11rMNKDDMB%2Fuploads%2Fgit-blob-510225c099a70cfdc6aa2f3c3295359e4fd524d6%2Ffireblocks-outgoing-option1-pre-screening.png?alt=media" alt="Outgoing transaction pre-screening flow: You screen the address through Phalcon Compliance before submitting the transaction to Fireblocks"><figcaption><p>Pre-screening flow: screen the destination address through Phalcon before submitting the transaction to Fireblocks.</p></figcaption></figure>

**Основные моменты:**

* Дополнительная инфраструктура не требуется. Вам понадобится только API-ключ Phalcon.
* Вы можете настроить [Каналы уведомлений](https://docs.compliance.phalcon.blocksec.com/ru/user-manual/configure/notification-channels.md) Phalcon, чтобы оповещать ответственных сотрудников об обнаружении адреса с высоким уровнем риска.

### Вариант 2: Автоматическая проверка с помощью callback handler

В этом методе используется [API Co-Signer Callback Handler](https://developers.fireblocks.com/docs/create-api-co-signer-callback-handler), чтобы интегрировать Phalcon Compliance непосредственно в процесс подписания транзакций Fireblocks. Каждая исходящая транзакция автоматически проверяется до того, как Co-Signer подпишет ее.

**Как это работает:**

1. Инициируйте транзакцию через API Fireblocks.
2. Транзакция проходит через Transaction Authorization Policy (TAP) Fireblocks.
3. API Co-Signer, работающий в вашей среде, получает сведения о транзакции от Co-Signer Gateway.
4. Co-Signer передает сведения о транзакции вашему **callback handler** — развернутому вами пользовательскому HTTPS-серверу.
5. Ваш callback handler вызывает [API Phalcon Compliance](https://docs.compliance.phalcon.blocksec.com/ru/api-documentation/address-screening/screen-a-single-address.md), чтобы проверить адрес назначения.
6. На основе оценки риска Phalcon ваш callback handler возвращает решение:
   * **Одобрить** — Co-Signer подписывает транзакцию и отправляет подпись в Co-Signer Gateway.
   * **Отклонить** — Co-Signer отменяет транзакцию.

<figure><img src="https://3440913522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdOfakg6W4j11rMNKDDMB%2Fuploads%2Fgit-blob-38672a87ea0db3d283458130f5e2478f84893be7%2Ffireblocks-outgoing-option2-callback-handler.png?alt=media" alt="Automated outgoing transaction screening flow: Callback Handler integrates Phalcon Compliance into the Fireblocks Co-Signer signing process"><figcaption><p>Automated screening flow: the Callback Handler screens transactions through Phalcon Compliance before the Co-Signer signs.</p></figcaption></figure>

**Основные моменты:**

* API Co-Signer ожидает ответ от callback handler в течение **30 секунд**.
* Вы полностью контролируете логику пороговых значений риска в callback handler.
* Подробные сведения о настройке Co-Signer см. в [документации Fireblocks по Callback Handler](https://developers.fireblocks.com/docs/create-api-co-signer-callback-handler).

## Проверка входящих транзакций

Когда рабочая область Fireblocks получает средства, вы можете использовать Phalcon Compliance, чтобы проверить адрес отправителя и оценить связанный с ним риск. Есть два способа:

### Вариант 1: Автоматическая проверка через Webhook

Подключите webhook Fireblocks к Phalcon Compliance, чтобы автоматически проверять события входящих транзакций. Вы можете использовать конечную точку webhook, предоставленную Phalcon, или развернуть собственный сервер webhook, который вызывает [API Phalcon Compliance](https://docs.compliance.phalcon.blocksec.com/ru/api-documentation/address-screening/screen-a-single-address.md).

**Как это работает:**

1. Настройте конечную точку webhook для получения событий транзакций Fireblocks. Вы можете использовать URL webhook, предоставленный Phalcon Compliance, или развернуть собственный сервер, который вызывает [API Phalcon Compliance](https://docs.compliance.phalcon.blocksec.com/ru/api-documentation/address-screening/screen-a-single-address.md).
2. Зарегистрируйте URL webhook в рабочей области Fireblocks (см. [документацию Fireblocks по Webhook](https://developers.fireblocks.com/reference/webhooks-overview)).
3. Когда обнаружена входящая транзакция, Fireblocks отправляет событие на конечную точку webhook.
4. Событие обрабатывается, а соответствующий адрес отправителя проверяется с помощью Phalcon Compliance.
5. На основе оценки риска:
   * **Обнаружен риск** — В Phalcon Compliance создается оповещение, которое ваша команда может изучить.
   * **Риск не обнаружен** — Результат проверки сохраняется. Дополнительные действия не требуются.

<figure><img src="https://3440913522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdOfakg6W4j11rMNKDDMB%2Fuploads%2Fgit-blob-946b6cf09c4c4be65219e737bd51a2b129fbb426%2Ffireblocks-incoming-option1-webhook.png?alt=media" alt="Automated incoming transaction screening flow: Fireblocks sends events to Phalcon Compliance via webhook for screening"><figcaption><p>Automated incoming screening: Fireblocks sends transaction events to Phalcon Compliance for screening.</p></figcaption></figure>

**Основные моменты:**

* Проверка выполняется на основе механизма оценки риска и пороговых значений, настроенных в Phalcon Compliance.
* Настройте [Каналы уведомлений](https://docs.compliance.phalcon.blocksec.com/ru/user-manual/configure/notification-channels.md), чтобы оповещать команду по комплаенсу об обнаружении риска.
* Если вам нужна помощь с настройкой интеграции webhook, свяжитесь с нами по адресу ***<phalcon_support@blocksec.com>***.

### Дополнительно: вердикты по результатам ручной проверки

> Для команд по комплаенсу, которым требуется вручную проверять и явно одобрять каждую входящую транзакцию.

{% hint style="warning" %}
Эта функция доступна не во всех рабочих областях Fireblocks. Обратитесь к своему менеджеру по работе с клиентами Fireblocks, чтобы включить Manual Screening Verdicts для вашей рабочей области.
{% endhint %}

Когда функция Manual Screening Verdicts включена, входящие транзакции остаются в статусе `PENDING_SCREENING`, пока ваша команда по комплаенсу не отправит вердикт. Ваша команда оценивает риск с помощью Phalcon Compliance, а затем отправляет вердикт в Fireblocks.

**Как это работает:**

1. В рабочую область Fireblocks поступает входящая транзакция, которая получает статус `PENDING_SCREENING`.
2. Ваша команда по комплаенсу получает уведомление об ожидающей транзакции.
3. Ваша команда проверяет адрес отправителя в Phalcon Compliance и изучает оценку риска.
4. На основе результатов проверки ваша команда отправляет вердикт в API Fireblocks (`POST /aml/verdict/manual`):
   * **Принять** — Транзакция передается на обработку.
   * **Отклонить** — Транзакция помечается и замораживается в Fireblocks.
5. Если вердикт не отправлен в течение **одного часа**, Fireblocks автоматически отклоняет и замораживает транзакцию.

<figure><img src="https://3440913522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdOfakg6W4j11rMNKDDMB%2Fuploads%2Fgit-blob-ff841d6e61f27e4c54e709879510fda256561c60%2Ffireblocks-incoming-option2-manual-verdict.png?alt=media" alt="Manual incoming transaction screening flow: Compliance team reviews in Phalcon Compliance and submits a verdict to Fireblocks"><figcaption><p>Manual screening: your compliance team reviews the risk in Phalcon Compliance and submits a verdict to Fireblocks.</p></figcaption></figure>

**Основные моменты:**

* Manual Screening Verdicts применяются только к входящим транзакциям. Исходящие транзакции не затрагиваются.
* Метод с webhook (вариант 1) и Manual Screening Verdicts **нельзя использовать одновременно** — для проверки входящих транзакций необходимо выбрать один из этих методов.
* Тайм-аут в один час служит дополнительной мерой защиты, но вашей команде следует стремиться оперативно проверять транзакции и отправлять ответы.

## Следующие шаги

* [Механизм оценки риска](https://docs.compliance.phalcon.blocksec.com/ru/user-manual/configure/risk-engines.md): Настройте пороговые значения и индикаторы риска в соответствии с политиками комплаенса.
* [Каналы уведомлений](https://docs.compliance.phalcon.blocksec.com/ru/user-manual/configure/notification-channels.md): Настройте оповещения об обнаружении действий с высоким уровнем риска.
* [API Keys](https://docs.compliance.phalcon.blocksec.com/ru/user-manual/account/api-keys.md): Создайте учетные данные для API Phalcon Compliance.
* [Документация API](https://docs.compliance.phalcon.blocksec.com/ru/api-documentation/introduction.md): Описание конечных точек и примеры запросов и ответов.
