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

# Fireblocks

Este guia explica como usar o Phalcon Compliance com [Fireblocks](https://www.fireblocks.com/) para analisar transações de saída e de entrada em busca de riscos de AML/CFT. Ao combinar as duas plataformas, você pode analisar transações de saída antes da execução e monitorar transações de entrada quando forem detectadas pelo Fireblocks.

## Pré-requisitos

**Necessário para a configuração básica:**

* Uma conta ativa do Phalcon Compliance com uma chave de API (consulte [Chaves de API](https://docs.compliance.phalcon.blocksec.com/pt-br/user-manual/account/api-keys.md))
* Um workspace do Fireblocks com acesso a Webhook ou API

**Necessário apenas para a configuração avançada:**

* **API Co-Signer** para analisar automaticamente as transações de saída por meio de um manipulador de retorno de chamada (consulte [Visão geral do Fireblocks Co-Signer](https://developers.fireblocks.com/docs/use-cosigners-for-signing-automation))
* **Vereditos de análise manual** para o fluxo de trabalho de vereditos manuais de entrada (entre em contato com o gerente de Sucesso do Cliente do Fireblocks para ativar esse recurso)

## Analisar transações de saída

Quando sua organização envia fundos pelo Fireblocks, você pode usar o Phalcon Compliance para analisar o endereço de destino **antes** de a transação ser assinada e transmitida. Há dois métodos:

### Opção 1: Análise prévia pela API do Phalcon

Antes de enviar uma transação ao Fireblocks, use a API do Phalcon Compliance para analisar o endereço de destino. Com base na avaliação de risco, sua equipe decide se deve prosseguir.

**Como funciona:**

1. Sua equipe envia o endereço de destino ao Phalcon Compliance pela API [Analisar um único endereço](https://docs.compliance.phalcon.blocksec.com/pt-br/api-documentation/address-screening/screen-a-single-address.md) ou pelo painel da Phalcon.
2. O Phalcon Compliance retorna uma avaliação de risco, incluindo o nível de risco, os indicadores de risco e os detalhes de exposição.
3. Sua equipe analisa os resultados e toma uma decisão com base nas políticas internas de conformidade:
   * **Risco inaceitável** — Rejeite a transação. Não a envie ao Fireblocks.
   * **Risco aceitável** — Prossiga com a criação da transação no Fireblocks.
4. Se aprovada, envie a transação ao Fireblocks pela API ou pelo console do Fireblocks.

<figure><img src="https://506894602-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzD66AI0kygFWXLyKlwt%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>

**Pontos principais:**

* Não é necessária infraestrutura adicional. Você só precisa da sua chave de API do Phalcon.
* Você pode configurar os [Canais de notificação](https://docs.compliance.phalcon.blocksec.com/pt-br/user-manual/configure/notification-channels.md) do Phalcon para alertar as partes interessadas quando um endereço de alto risco for detectado.

### Opção 2: Análise automatizada usando um manipulador de retorno de chamada

Este método usa um [manipulador de retorno de chamada do API Co-Signer](https://developers.fireblocks.com/docs/create-api-co-signer-callback-handler) para integrar o Phalcon Compliance diretamente ao fluxo de trabalho de assinatura de transações do Fireblocks. Todas as transações de saída são analisadas automaticamente antes de serem assinadas pelo Co-Signer.

**Como funciona:**

1. Inicie uma transação pela API do Fireblocks.
2. A transação passa pela Política de Autorização de Transações (TAP) do Fireblocks.
3. O API Co-Signer em execução no seu ambiente recebe os detalhes da transação do Co-Signer Gateway.
4. O Co-Signer encaminha os detalhes da transação ao seu **manipulador de retorno de chamada**, um servidor HTTPS personalizado que você implanta.
5. Seu manipulador de retorno de chamada chama a [API do Phalcon Compliance](https://docs.compliance.phalcon.blocksec.com/pt-br/api-documentation/address-screening/screen-a-single-address.md) para analisar o endereço de destino.
6. Com base na avaliação de risco do Phalcon, seu manipulador de retorno de chamada retorna uma decisão:
   * **Aprovar** — O Co-Signer assina a transação e envia a assinatura ao Co-Signer Gateway.
   * **Rejeitar** — O Co-Signer cancela a transação.

<figure><img src="https://506894602-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzD66AI0kygFWXLyKlwt%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>

**Pontos principais:**

* O API Co-Signer espera uma resposta do manipulador de retorno de chamada em até **30 segundos**.
* Você tem controle total sobre a lógica do limite de risco no manipulador de retorno de chamada.
* Para saber como configurar o Co-Signer, consulte a [Documentação do manipulador de retorno de chamada do Fireblocks](https://developers.fireblocks.com/docs/create-api-co-signer-callback-handler).

## Analisar transações de entrada

Quando seu workspace do Fireblocks recebe fundos, você pode usar o Phalcon Compliance para analisar o endereço do remetente e avaliar o risco. Há dois métodos:

### Opção 1: Análise automatizada via Webhook

Conecte um Webhook do Fireblocks ao Phalcon Compliance para analisar automaticamente eventos de transações de entrada. Você pode usar o endpoint de Webhook fornecido pelo Phalcon ou implantar seu próprio servidor de Webhook que chama a [API do Phalcon Compliance](https://docs.compliance.phalcon.blocksec.com/pt-br/api-documentation/address-screening/screen-a-single-address.md).

**Como funciona:**

1. Configure um endpoint de Webhook para receber eventos de transações do Fireblocks. Você pode usar a URL de Webhook fornecida pelo Phalcon Compliance ou implantar seu próprio servidor que chama a [API do Phalcon Compliance](https://docs.compliance.phalcon.blocksec.com/pt-br/api-documentation/address-screening/screen-a-single-address.md).
2. Registre a URL do Webhook no seu workspace do Fireblocks (consulte a [Documentação de Webhooks do Fireblocks](https://developers.fireblocks.com/reference/webhooks-overview)).
3. Quando uma transação de entrada é detectada, o Fireblocks envia o evento ao endpoint de Webhook.
4. O evento é analisado e o endereço relevante do remetente é verificado pelo Phalcon Compliance.
5. Com base na avaliação de risco:
   * **Risco detectado** — Um alerta é criado no Phalcon Compliance para análise pela sua equipe.
   * **Nenhum risco detectado** — O resultado da análise é registrado. Nenhuma outra ação é necessária.

<figure><img src="https://506894602-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzD66AI0kygFWXLyKlwt%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>

**Pontos principais:**

* A análise se baseia no mecanismo de risco e nos limites configurados no Phalcon Compliance.
* Configure os [Canais de notificação](https://docs.compliance.phalcon.blocksec.com/pt-br/user-manual/configure/notification-channels.md) para alertar sua equipe de conformidade quando um risco for detectado.
* Se precisar de ajuda para configurar a integração do Webhook, entre em contato conosco pelo endereço ***<phalcon_support@blocksec.com>***.

### Avançado: Vereditos de análise manual

> Para equipes de conformidade que precisam analisar manualmente e aprovar explicitamente todas as transações recebidas.

{% hint style="warning" %}
Este recurso tem disponibilidade limitada no Fireblocks. Entre em contato com o gerente de Sucesso do Cliente do Fireblocks para ativar os Vereditos de análise manual no seu workspace.
{% endhint %}

Quando os Vereditos de análise manual estão ativados, as transações de entrada permanecem com o status `PENDING_SCREENING` até que sua equipe de conformidade envie um veredito. Sua equipe usa o Phalcon Compliance para avaliar o risco e, em seguida, envia um veredito ao Fireblocks.

**Como funciona:**

1. Uma transação de entrada chega ao seu workspace do Fireblocks e recebe o status `PENDING_SCREENING`.
2. Sua equipe de conformidade é notificada sobre a transação pendente.
3. Sua equipe analisa o endereço do remetente no Phalcon Compliance e verifica a avaliação de risco.
4. Com base na análise, sua equipe envia um veredito à API do Fireblocks (`POST /aml/verdict/manual`):
   * **Aceitar** — A transação é liberada para processamento.
   * **Rejeitar** — A transação é sinalizada e congelada no Fireblocks.
5. Se nenhum veredito for enviado em **uma hora**, o Fireblocks rejeitará e congelará automaticamente a transação.

<figure><img src="https://506894602-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzD66AI0kygFWXLyKlwt%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>

**Pontos principais:**

* Os Vereditos de análise manual se aplicam apenas a transações de entrada. As transações de saída não são afetadas.
* O método de Webhook (Opção 1) e os Vereditos de análise manual **não podem ser usados simultaneamente** — você deve escolher um método para analisar transações de entrada.
* O limite de uma hora oferece uma proteção, mas sua equipe deve procurar analisar e responder prontamente.

## Próximas etapas

* [Mecanismo de risco](https://docs.compliance.phalcon.blocksec.com/pt-br/user-manual/configure/risk-engines.md): Personalize os limites e indicadores de risco para suas políticas de conformidade.
* [Canais de notificação](https://docs.compliance.phalcon.blocksec.com/pt-br/user-manual/configure/notification-channels.md): Configure alertas para quando atividades de alto risco forem detectadas.
* [Chaves de API](https://docs.compliance.phalcon.blocksec.com/pt-br/user-manual/account/api-keys.md): Gere credenciais para a API do Phalcon Compliance.
* [Documentação da API](https://docs.compliance.phalcon.blocksec.com/pt-br/api-documentation/introduction.md): Detalhes dos endpoints e exemplos de solicitações/respostas.
