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

# Fireblocks

Ce guide explique comment utiliser Phalcon Compliance avec [Fireblocks](https://www.fireblocks.com/) pour filtrer les transactions sortantes et entrantes afin de détecter les risques liés à AML/CFT. En combinant les deux plateformes, vous pouvez filtrer les transactions sortantes avant leur exécution et surveiller les transactions entrantes lorsqu’elles sont détectées par Fireblocks.

## Prérequis

**Requis pour la configuration de base :**

* Un compte Phalcon Compliance actif avec une clé API (voir [Clés API](https://docs.compliance.phalcon.blocksec.com/fr/user-manual/account/api-keys.md))
* Un espace de travail Fireblocks avec un accès par webhook ou API

**Requis uniquement pour la configuration avancée :**

* **API Co-Signer** pour filtrer automatiquement les transactions sortantes via un gestionnaire de rappel (voir [Présentation de Fireblocks Co-Signer](https://developers.fireblocks.com/docs/use-cosigners-for-signing-automation))
* **Manual Screening Verdicts** pour le processus de validation manuelle des transactions entrantes (contactez votre responsable de la réussite client Fireblocks pour activer cette fonctionnalité)

## Filtrer les transactions sortantes

Lorsque votre organisation envoie des fonds via Fireblocks, vous pouvez utiliser Phalcon Compliance pour filtrer l’adresse de destination **avant** que la transaction soit signée et diffusée. Il existe deux méthodes :

### Option 1 : Filtrage préalable via l’API Phalcon

Avant de soumettre une transaction à Fireblocks, utilisez l’API Phalcon Compliance pour filtrer l’adresse de destination. En fonction de l’évaluation des risques, votre équipe décide de poursuivre ou non.

**Fonctionnement :**

1. Votre équipe soumet l’adresse de destination à Phalcon Compliance via l’API [Filtrer une adresse unique](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/address-screening/screen-a-single-address.md) ou le tableau de bord Phalcon.
2. Phalcon Compliance renvoie une évaluation des risques, notamment le niveau de risque, les indicateurs de risque et les détails de l’exposition.
3. Votre équipe examine les résultats et prend une décision conformément à vos politiques internes de conformité :
   * **Risque inacceptable** — Rejeter la transaction. Ne pas la soumettre à Fireblocks.
   * **Risque acceptable** — Procéder à la création de la transaction dans Fireblocks.
4. Si la transaction est acceptée, soumettez-la à Fireblocks via l’API ou la console Fireblocks.

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

**Points clés :**

* Aucune infrastructure supplémentaire n’est nécessaire. Vous avez uniquement besoin de votre clé API Phalcon.
* Vous pouvez configurer les [canaux de notification](https://docs.compliance.phalcon.blocksec.com/fr/user-manual/configure/notification-channels.md) de Phalcon pour avertir les parties prenantes lorsqu’une adresse à haut risque est détectée.

### Option 2 : Filtrage automatisé à l’aide d’un Callback Handler

Cette méthode utilise un [API Co-Signer Callback Handler](https://developers.fireblocks.com/docs/create-api-co-signer-callback-handler) pour intégrer directement Phalcon Compliance au processus de signature des transactions Fireblocks. Chaque transaction sortante est automatiquement filtrée avant que le Co-Signer ne la signe.

**Fonctionnement :**

1. Initiez une transaction via l’API Fireblocks.
2. La transaction passe par la politique d’autorisation des transactions Fireblocks (TAP).
3. L’API Co-Signer exécuté dans votre environnement reçoit les détails de la transaction du Co-Signer Gateway.
4. Le Co-Signer transmet les détails de la transaction à votre **callback handler**, un serveur HTTPS personnalisé que vous déployez.
5. Votre callback handler appelle l’[API Phalcon Compliance](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/address-screening/screen-a-single-address.md) pour filtrer l’adresse de destination.
6. En fonction de l’évaluation des risques de Phalcon, votre callback handler renvoie une décision :
   * **Approuver** — Le Co-Signer signe la transaction et envoie la signature au Co-Signer Gateway.
   * **Rejeter** — Le Co-Signer annule la transaction.

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

**Points clés :**

* L’API Co-Signer attend une réponse du callback handler dans un délai de **30 secondes**.
* Vous contrôlez entièrement la logique de seuil de risque dans le callback handler.
* Pour en savoir plus sur la configuration du Co-Signer, consultez la [documentation du Callback Handler Fireblocks](https://developers.fireblocks.com/docs/create-api-co-signer-callback-handler).

## Filtrer les transactions entrantes

Lorsque votre espace de travail Fireblocks reçoit des fonds, vous pouvez utiliser Phalcon Compliance pour filtrer l’adresse de l’expéditeur et évaluer son risque. Il existe deux méthodes :

### Option 1 : Filtrage automatisé via un webhook

Connectez un webhook Fireblocks à Phalcon Compliance pour filtrer automatiquement les événements de transaction entrante. Vous pouvez utiliser le point de terminaison webhook fourni par Phalcon ou déployer votre propre serveur webhook qui appelle l’[API Phalcon Compliance](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/address-screening/screen-a-single-address.md).

**Fonctionnement :**

1. Configurez un point de terminaison webhook pour recevoir les événements de transaction Fireblocks. Vous pouvez utiliser l’URL du webhook fournie par Phalcon Compliance ou déployer votre propre serveur qui appelle l’[API Phalcon Compliance](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/address-screening/screen-a-single-address.md).
2. Enregistrez l’URL du webhook dans votre espace de travail Fireblocks (voir la [documentation sur les webhooks Fireblocks](https://developers.fireblocks.com/reference/webhooks-overview)).
3. Lorsqu’une transaction entrante est détectée, Fireblocks envoie l’événement au point de terminaison webhook.
4. L’événement est analysé et l’adresse de l’expéditeur concernée est filtrée par Phalcon Compliance.
5. En fonction de l’évaluation des risques :
   * **Risque détecté** — Une alerte est créée dans Phalcon Compliance pour que votre équipe l’examine.
   * **Aucun risque détecté** — Le résultat du filtrage est enregistré. Aucune autre action n’est requise.

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

**Points clés :**

* Le filtrage repose sur le moteur de risque et les seuils configurés dans Phalcon Compliance.
* Configurez les [canaux de notification](https://docs.compliance.phalcon.blocksec.com/fr/user-manual/configure/notification-channels.md) pour avertir votre équipe de conformité lorsqu’un risque est détecté.
* Si vous avez besoin d’aide pour configurer l’intégration du webhook, contactez-nous à l’adresse ***<phalcon_support@blocksec.com>***.

### Avancé : Manual Screening Verdicts

> Pour les équipes de conformité qui exigent un examen manuel et une approbation explicite de chaque transaction entrante.

{% hint style="warning" %}
Cette fonctionnalité est disponible de manière limitée dans Fireblocks. Contactez votre responsable de la réussite client Fireblocks pour activer Manual Screening Verdicts dans votre espace de travail.
{% endhint %}

Lorsque Manual Screening Verdicts est activé, les transactions entrantes restent au statut `PENDING_SCREENING` jusqu’à ce que votre équipe de conformité soumette un verdict. Votre équipe utilise Phalcon Compliance pour évaluer le risque, puis soumet un verdict à Fireblocks.

**Fonctionnement :**

1. Une transaction entrante arrive dans votre espace de travail Fireblocks et est placée au statut `PENDING_SCREENING`.
2. Votre équipe de conformité est informée de la transaction en attente.
3. Votre équipe filtre l’adresse de l’expéditeur dans Phalcon Compliance et examine l’évaluation des risques.
4. En fonction de l’examen, votre équipe soumet un verdict à l’API Fireblocks (`POST /aml/verdict/manual`) :
   * **Accepter** — La transaction est libérée pour traitement.
   * **Rejeter** — La transaction est signalée et gelée dans Fireblocks.
5. Si aucun verdict n’est soumis dans un délai d’**une heure**, Fireblocks rejette et gèle automatiquement la transaction.

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

**Points clés :**

* Manual Screening Verdicts s’applique uniquement aux transactions entrantes. Les transactions sortantes ne sont pas concernées.
* La méthode par webhook (option 1) et Manual Screening Verdicts **ne peuvent pas être utilisées simultanément** — vous devez choisir une méthode pour filtrer les transactions entrantes.
* Le délai d’une heure constitue une mesure de sécurité, mais votre équipe doit s’efforcer d’examiner les transactions et d’y répondre rapidement.

## Étapes suivantes

* [Moteur de risque](https://docs.compliance.phalcon.blocksec.com/fr/user-manual/configure/risk-engines.md) : Personnalisez les seuils et les indicateurs de risque en fonction de vos politiques de conformité.
* [Canaux de notification](https://docs.compliance.phalcon.blocksec.com/fr/user-manual/configure/notification-channels.md) : Configurez des alertes en cas de détection d’une activité à haut risque.
* [Clés API](https://docs.compliance.phalcon.blocksec.com/fr/user-manual/account/api-keys.md) : Générez des identifiants pour l’API Phalcon Compliance.
* [Documentation de l’API](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/introduction.md) : Détails des points de terminaison et exemples de requêtes/réponses.
