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

# Fireblocks

Esta guía explica cómo usar Phalcon Compliance con [Fireblocks](https://www.fireblocks.com/) para analizar las transacciones salientes y entrantes en busca de riesgos de AML/CFT. Al combinar ambas plataformas, puede analizar las transacciones salientes antes de ejecutarlas y supervisar las transacciones entrantes cuando Fireblocks las detecte.

## Requisitos previos

**Requisitos para la configuración básica:**

* Una cuenta activa de Phalcon Compliance con una clave de API (consulta [Claves de API](https://docs.compliance.phalcon.blocksec.com/es/user-manual/account/api-keys.md))
* Un espacio de trabajo de Fireblocks con acceso a Webhook o API

**Requisitos solo para la configuración avanzada:**

* **API Co-Signer** para analizar automáticamente las transacciones salientes mediante un controlador de callback (consulta [Descripción general de Fireblocks Co-Signer](https://developers.fireblocks.com/docs/use-cosigners-for-signing-automation))
* **Veredictos de análisis manual** para el flujo de trabajo de veredictos manuales de transacciones entrantes (contacta con tu gerente de Éxito del Cliente de Fireblocks para habilitar esta función)

## Analizar transacciones salientes

Cuando tu organización envía fondos a través de Fireblocks, puedes usar Phalcon Compliance para analizar la dirección de destino **antes** de que se firme y difunda la transacción. Hay dos métodos:

### Opción 1: Análisis previo mediante la API de Phalcon

Antes de enviar una transacción a Fireblocks, usa la API de Phalcon Compliance para analizar la dirección de destino. Según la evaluación de riesgos, tu equipo decide si continúa.

**Cómo funciona:**

1. Tu equipo envía la dirección de destino a Phalcon Compliance mediante la API [Analizar una dirección individual](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/address-screening/screen-a-single-address.md) o el panel de Phalcon.
2. Phalcon Compliance devuelve una evaluación de riesgos, incluidos el nivel de riesgo, los indicadores de riesgo y los detalles de exposición.
3. Tu equipo revisa los resultados y toma una decisión conforme a sus políticas internas de cumplimiento:
   * **Riesgo inaceptable** — Rechaza la transacción. No la envíes a Fireblocks.
   * **Riesgo aceptable** — Continúa con la creación de la transacción en Fireblocks.
4. Si se acepta, envía la transacción a Fireblocks mediante la API o la consola de Fireblocks.

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

**Puntos clave:**

* No se requiere infraestructura adicional. Solo necesitas tu clave de API de Phalcon.
* Puedes configurar los [Canales de notificación](https://docs.compliance.phalcon.blocksec.com/es/user-manual/configure/notification-channels.md) de Phalcon para alertar a las partes interesadas cuando se detecte una dirección de alto riesgo.

### Opción 2: Análisis automatizado mediante un controlador de callback

Este método usa un [controlador de callback de API Co-Signer](https://developers.fireblocks.com/docs/create-api-co-signer-callback-handler) para integrar Phalcon Compliance directamente en el flujo de trabajo de firma de transacciones de Fireblocks. Cada transacción saliente se analiza automáticamente antes de que Co-Signer la firme.

**Cómo funciona:**

1. Inicia una transacción mediante la API de Fireblocks.
2. La transacción pasa por la Política de Autorización de Transacciones (TAP) de Fireblocks.
3. API Co-Signer, que se ejecuta en tu entorno, recibe los detalles de la transacción de Co-Signer Gateway.
4. Co-Signer reenvía los detalles de la transacción a tu **controlador de callback**, un servidor HTTPS personalizado que implementas.
5. Tu controlador de callback llama a la [API de Phalcon Compliance](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/address-screening/screen-a-single-address.md) para analizar la dirección de destino.
6. Según la evaluación de riesgos de Phalcon, tu controlador de callback devuelve una decisión:
   * **Aprobar** — Co-Signer firma la transacción y envía la firma a Co-Signer Gateway.
   * **Rechazar** — Co-Signer cancela la transacción.

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

**Puntos clave:**

* API Co-Signer espera una respuesta del controlador de callback en un plazo de **30 segundos**.
* Tienes control total sobre la lógica del umbral de riesgo en el controlador de callback.
* Para obtener más información sobre cómo configurar Co-Signer, consulta la [Documentación del controlador de callback de Fireblocks](https://developers.fireblocks.com/docs/create-api-co-signer-callback-handler).

## Analizar transacciones entrantes

Cuando tu espacio de trabajo de Fireblocks recibe fondos, puedes usar Phalcon Compliance para analizar la dirección del remitente y evaluar su riesgo. Hay dos métodos:

### Opción 1: Análisis automatizado mediante Webhook

Conecta un Webhook de Fireblocks a Phalcon Compliance para analizar automáticamente los eventos de transacciones entrantes. Puedes usar el endpoint de Webhook proporcionado por Phalcon o implementar tu propio servidor de Webhook que llame a la [API de Phalcon Compliance](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/address-screening/screen-a-single-address.md).

**Cómo funciona:**

1. Configura un endpoint de Webhook para recibir los eventos de transacciones de Fireblocks. Puedes usar la URL de Webhook proporcionada por Phalcon Compliance o implementar tu propio servidor que llame a la [API de Phalcon Compliance](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/address-screening/screen-a-single-address.md).
2. Registra la URL del Webhook en tu espacio de trabajo de Fireblocks (consulta la [Documentación de Webhooks de Fireblocks](https://developers.fireblocks.com/reference/webhooks-overview)).
3. Cuando se detecta una transacción entrante, Fireblocks envía el evento al endpoint de Webhook.
4. Se analiza el evento y Phalcon Compliance analiza la dirección del remitente correspondiente.
5. Según la evaluación de riesgos:
   * **Riesgo detectado** — Se crea una alerta en Phalcon Compliance para que tu equipo la revise.
   * **No se detectó riesgo** — Se registra el resultado del análisis. No se requiere ninguna otra acción.

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

**Puntos clave:**

* El análisis se basa en el motor de riesgo y los umbrales configurados en Phalcon Compliance.
* Configura los [Canales de notificación](https://docs.compliance.phalcon.blocksec.com/es/user-manual/configure/notification-channels.md) para alertar a tu equipo de cumplimiento cuando se detecte un riesgo.
* Si necesitas ayuda para configurar la integración de Webhook, contáctanos en ***<phalcon_support@blocksec.com>***.

### Avanzado: Veredictos de análisis manual

> Para equipos de cumplimiento que requieren una revisión manual y aprobación explícita de cada transacción entrante.

{% hint style="warning" %}
Esta función tiene disponibilidad limitada en Fireblocks. Contacta con tu gerente de Éxito del Cliente de Fireblocks para habilitar los veredictos de análisis manual en tu espacio de trabajo.
{% endhint %}

Cuando se habilitan los veredictos de análisis manual, las transacciones entrantes permanecen en el estado `PENDING_SCREENING` hasta que tu equipo de cumplimiento envía un veredicto. Tu equipo usa Phalcon Compliance para evaluar el riesgo y luego envía un veredicto a Fireblocks.

**Cómo funciona:**

1. Llega una transacción entrante a tu espacio de trabajo de Fireblocks y se coloca en el estado `PENDING_SCREENING`.
2. Se notifica a tu equipo de cumplimiento que hay una transacción pendiente.
3. Tu equipo analiza la dirección del remitente en Phalcon Compliance y revisa la evaluación de riesgos.
4. Según la revisión, tu equipo envía un veredicto a la API de Fireblocks (`POST /aml/verdict/manual`):
   * **Aceptar** — La transacción se libera para su procesamiento.
   * **Rechazar** — La transacción se marca y se congela en Fireblocks.
5. Si no se envía ningún veredicto en el plazo de **una hora**, Fireblocks rechaza y congela automáticamente la transacción.

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

**Puntos clave:**

* Los veredictos de análisis manual se aplican solo a las transacciones entrantes. Las transacciones salientes no se ven afectadas.
* El método de Webhook (Opción 1) y los veredictos de análisis manual **no se pueden usar simultáneamente**; debes elegir un método para analizar las transacciones entrantes.
* El tiempo de espera de una hora ofrece una medida de seguridad, pero tu equipo debe procurar revisar y responder con prontitud.

## Próximos pasos

* [Motor de riesgo](https://docs.compliance.phalcon.blocksec.com/es/user-manual/configure/risk-engines.md): Personaliza los umbrales e indicadores de riesgo para tus políticas de cumplimiento.
* [Canales de notificación](https://docs.compliance.phalcon.blocksec.com/es/user-manual/configure/notification-channels.md): Configura alertas cuando se detecte actividad de alto riesgo.
* [Claves de API](https://docs.compliance.phalcon.blocksec.com/es/user-manual/account/api-keys.md): Genera credenciales para la API de Phalcon Compliance.
* [Documentación de la API](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/introduction.md): Detalles de los endpoints y ejemplos de solicitudes y respuestas.
