> 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/user-manual/screening/transactions.md).

# Filtrage des transactions

Dans Phalcon, le module Transactions permet aux utilisateurs de filtrer les transactions on-chain afin d’y détecter les risques, généralement liés aux interactions entre les clients et votre plateforme. En analysant en temps réel chaque transaction entrante ou sortante, Phalcon vous aide à détecter rapidement les fonds à risque et à assurer une atténuation efficace des risques.

La plus petite unité de filtrage des transactions est un transfert individuel. Si une transaction contient plusieurs transferts, vous pouvez les filtrer individuellement ou par lots afin d’évaluer de manière exhaustive le risque global de la transaction.

<figure><img src="https://2814209252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA1hiCzqdM5xM2e3ClwFX%2Fuploads%2Fgit-blob-1b8dad20b48097600f7f3bbc930b6d5714ad92c2%2Fimage%20(81).png?alt=media" alt="Transaction screening page overview"><figcaption></figcaption></figure>

## Concepts clés

### Direction

La direction d’une transaction ou d’un transfert détermine la stratégie de filtrage appliquée.

* **Dépôt** : Lorsqu’une transaction implique le dépôt de fonds d’un client sur la plateforme, définissez la direction sur Deposit.
* **Retrait** : Lorsqu’une transaction implique le retrait des fonds d’un client de la plateforme, définissez la direction sur Withdrawal.

Remarque : La spécification d’une direction a une incidence sur la stratégie de filtrage des risques. Par exemple :

* Si un moteur de risque est configuré pour les transactions **Deposit**, il ne s’appliquera pas aux transactions dont la direction est **Withdrawal**.
* Pour les transactions **Deposit**, seuls les flux de fonds entrants sont tracés et filtrés.
* Pour les transactions **Withdrawal**, seuls les flux de fonds sortants et les adresses de destination sont tracés et filtrés.
* La définition correcte de la direction permet d’appliquer des règles de risque personnalisées aux flux de fonds entrants et sortants, réduisant ainsi les faux positifs.

Si aucune direction n’est spécifiée, les transactions sont filtrées par défaut à la fois comme des dépôts et des retraits.

### Remarques

Les utilisateurs peuvent ajouter des remarques à toute transaction ou à tout transfert afin d’y consigner du contexte ou des observations supplémentaires.

## Filtrer des transactions

Phalcon prend en charge deux méthodes d’importation des transactions :

1. Filtrer un seul hash de transaction.
2. Filtrer des transactions par lots au moyen d’un fichier CSV.

Toutes les transactions sont automatiquement filtrées par rapport aux moteurs de risque actifs et affichées dans la liste des transactions.

### Filtrer une seule transaction

Pour filtrer une seule transaction :

1. Saisissez le hash de transaction que vous souhaitez ajouter. Phalcon récupérera automatiquement les données des transferts associés à la transaction.
2. Sélectionnez les transferts à traiter.
3. Vous pouvez :

   * Définir la direction (Deposit ou Withdrawal) pour déterminer le périmètre du filtrage.
   * Attribuer des libellés pour fournir du contexte supplémentaire.
   * Associer le transfert ou la transaction à un client spécifique.

   <figure><img src="https://2814209252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA1hiCzqdM5xM2e3ClwFX%2Fuploads%2Fgit-blob-7e8deb4476a07eabf10a579788d640dcdd78a67d%2Fimage%20(11).png?alt=media" alt="Screening a single transaction with direction and label options"><figcaption></figcaption></figure>

### Filtrage par lots au moyen d’un fichier CSV

<figure><img src="https://2814209252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA1hiCzqdM5xM2e3ClwFX%2Fuploads%2Fgit-blob-767067e96512b3836ee28117bab3b08c58f4b30e%2Fimage%20(12).png?alt=media" alt="Bulk transaction screening via CSV upload"><figcaption></figcaption></figure>

Les utilisateurs peuvent importer plusieurs transactions à la fois à l’aide d’un fichier CSV.

* Téléchargez le modèle CSV fourni.
* Importez jusqu’à 400 transactions par lot.
* Remplissez le modèle à l’aide des champs suivants :

| Champ            | Description                                                                                 |
| ---------------- | ------------------------------------------------------------------------------------------- |
| Chain            | Nom de la blockchain spécifié dans le modèle                                                |
| Transaction Hash | Hash de la transaction sur la blockchain.                                                   |
| Label            | Libellé privé défini par l’utilisateur (facultatif)                                         |
| Direction        | Indiquez « Deposit » ou « Withdrawal » pour définir la direction du transfert. (Facultatif) |
| Customer ID      | Identifiant d’un client existant ou nouveau (facultatif)                                    |
| Transfer From    | À utiliser avec « Transfer To » pour localiser un transfert spécifique (facultatif)         |
| Transfer To      | À utiliser avec « Transfer From » pour localiser un transfert spécifique (facultatif)       |

* Importez le fichier CSV.
* Vérifiez les résultats de l’importation dans la fenêtre contextuelle et assurez-vous que toutes les transactions requises ont bien été importées.

## Liste des transactions

Toutes les transactions filtrées sont affichées sur la page de la liste des transactions avec les informations suivantes :

* Hash de transaction
* Résumé des risques
* Direction du filtrage
* Alertes non résolues
* Heure du dernier filtrage
* Valeur (USD)
* Montant du jeton
* Actifs concernés
* Adresses source et de destination
* Horodatage de la transaction
* Client
* Libellés
* Horodatage d’ajout

Pour les transactions contenant plusieurs transferts, ceux-ci sont réduits par défaut. Cliquez pour les développer et afficher les détails de chaque transfert.

<figure><img src="https://2814209252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA1hiCzqdM5xM2e3ClwFX%2Fuploads%2Fgit-blob-feaf67be23ffc79fa963b78cfe40984981319083%2Fimage%20(14).png?alt=media" alt="Transaction list with expandable transfer details"><figcaption></figcaption></figure>

## Exporter des transactions

Vous pouvez exporter la liste des transactions sous forme de fichier CSV en cliquant sur le bouton **Exporter** de la page de la liste des transactions. Cette fonctionnalité est disponible uniquement pour les utilisateurs disposant d’un forfait payant.

Le fichier CSV exporté contient les champs suivants :

| Champ                           | Description                                                                                                                                   | Exemple                                                |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
| Chain                           | Réseau blockchain                                                                                                                             | ETH                                                    |
| Tx Hash                         | Hash de transaction                                                                                                                           | 0xa51fa6e0ccc6b9b3...                                  |
| Transfer Index                  | Index du transfert au sein de la transaction. `0` s’il n’y a qu’un seul transfert                                                             | 0                                                      |
| Risk Level                      | Niveau de risque du transfert                                                                                                                 | Critique                                               |
| Participant Risk Tags           | Étiquettes de risque des adresses participantes. Plusieurs étiquettes sont séparées par `;`                                                   | Arnaque; Bloqué                                        |
| Interaction Risk Breakdown      | Indicateurs et détails du risque d’interaction. Format : `{Risk Tag}: {Direction} {Value} ({Ratio})`. Plusieurs entrées sont séparées par `;` | Plateforme d’échange sans KYC : Incoming $0.02 (0.08%) |
| Participant Risk Details (JSON) | Données JSON structurées sur les risques liés aux participants, utilisées pour l’analyse programmatique                                       | Voir ci-dessous                                        |
| Interaction Risk Details (JSON) | Données JSON structurées sur les risques d’interaction, utilisées pour l’analyse programmatique                                               | Voir ci-dessous                                        |
| Screen Direction                | Direction du filtrage                                                                                                                         | Both                                                   |
| Unresolved Alerts               | Nombre d’alertes non résolues                                                                                                                 | 2                                                      |
| Last Screening Time             | Heure du filtrage le plus récent                                                                                                              | 2026-03-31 10:23:45                                    |
| Value (USD)                     | Valeur du transfert (USD)                                                                                                                     | 5478.25                                                |
| Token                           | Adresse du jeton ou identifiant de l’actif                                                                                                    | BTC                                                    |
| Amount                          | Montant du jeton                                                                                                                              | 0.08199                                                |
| From Address                    | Adresse de l’expéditeur                                                                                                                       | bc1qhva56p9cnsc9d8j96...                               |
| From Label                      | Libellé système de l’adresse de l’expéditeur                                                                                                  | Binance Hot Wallet                                     |
| To Address                      | Adresse du destinataire                                                                                                                       | 3LhsVdFsMeSZhn...                                      |
| To Label                        | Libellé système de l’adresse du destinataire                                                                                                  | ChangeNow Hot Wallet                                   |
| Transaction Time                | Heure à laquelle la transaction a eu lieu                                                                                                     | 2026-03-31 09:58:02                                    |
| Customer                        | ID du client associé                                                                                                                          | Customer123                                            |
| Note                            | Remarque ajoutée par l’utilisateur                                                                                                            | Adresse de dépôt VIP                                   |
| Added Time                      | Heure à laquelle les données ont été ajoutées                                                                                                 | 2026-03-30 15:20:11                                    |

**Exemple de Participant Risk Details (JSON) :**

```json
[
  {
    "riskIndicator": "Scam",
    "appliesTo": "from",
    "riskLevel": "critical"
  },
  {
    "riskIndicator": "Blocked",
    "appliesTo": "to",
    "riskLevel": "high"
  }
]
```

**Exemple de Interaction Risk Details (JSON) :**

```json
[
  {
    "riskIndicator": "No KYC Exchange",
    "direction": "incoming",
    "minHop": 1,
    "exposureValue": 0.02,
    "exposurePercentage": 0.0008,
    "riskLevel": "medium"
  }
]
```

## Page des détails de la transaction

<figure><img src="https://2814209252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA1hiCzqdM5xM2e3ClwFX%2Fuploads%2Fgit-blob-81a41c4b9b3e6c1fd443a70551162824d6073c5a%2Fimage%20(86).png?alt=media" alt="Transaction details page overview"><figcaption></figcaption></figure>

Cliquer sur une transaction dans la **Liste des transactions** ouvre sa **page de détails**.

### Informations de base

Affiche des informations clés telles que les actifs concernés, l’heure de la transaction, les libellés, le client et d’autres informations pertinentes.

### Résultats du filtrage

Les résultats du filtrage présentent l’analyse des risques du filtrage le plus récent, organisée dans les sections suivantes :

#### Résumé des risques

Aperçu rapide de tous les risques détectés, répartis en trois catégories : **Entity Risk**, **Interaction Risk** et risque comportemental. Chaque catégorie comporte un lien vers sa vue détaillée.

#### Entity Risk

Affiche les attributs de risque de toutes les adresses participantes à la transaction, regroupées par adresse. Chaque groupe d’adresses affiche :

* L’adresse (avec son libellé, le cas échéant) et son rôle dans la transaction (par exemple, « Transfert n° 1 · Expéditeur » ou « Transfert n° 2 · Destinataire »).
* Tous les attributs de risque de l’adresse — tels que les désignations de sanctions, l’implication connue dans des attaques ou l’appartenance à une liste noire ou blanche — y compris les indicateurs de risque, les détails et les règles déclenchées.

Les groupes d’adresses sont triés par niveau de risque, le risque le plus élevé apparaissant en premier.

<figure><img src="https://2814209252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA1hiCzqdM5xM2e3ClwFX%2Fuploads%2Fgit-blob-0c64b79f888391f9348197d512cf712bf392b982%2Ftx-entity-risk.png?alt=media" alt="Transaction Entity Risk showing participating addresses grouped with transfer roles"><figcaption></figcaption></figure>

#### Interaction Risk

Montre comment les adresses participantes à la transaction ont interagi avec des contreparties à risque par le biais des flux de fonds. Cette section comprend les trois mêmes sous-sections que la page des détails de l’adresse :

* **Répartition des indicateurs** — Un graphique à barres comparant l’exposition entrante et sortante pour chaque indicateur de risque, en distinguant l’exposition directe de l’exposition indirecte.
* **Adresses à risque** — Un tableau contenant les adresses des contreparties ayant déclenché des indicateurs de risque. Vous pouvez exporter la liste sous forme de fichier CSV.
* **Flux de fonds** — Une visualisation des flux de fonds. Cliquez sur **« Afficher les flux de fonds détaillés »** pour ouvrir l’analyse complète dans MetaSleuth.

{% hint style="info" %}
**Déclenché ou non déclenché** : Un indicateur est « déclenché » lorsque son exposition atteint le seuil d’une règle de votre moteur de risque actif, générant ainsi une alerte. « Non déclenché » signifie qu’une exposition a été détectée, mais qu’elle n’a atteint aucun seuil — elle est fournie à titre de référence uniquement.
{% endhint %}

#### Risque comportemental

Répertorie les schémas suspects détectés dans la transaction. Les types de comportement au niveau de la transaction incluent :

* **Transfert important** — Un transfert dont la valeur en USD est élevée. Affiche la valeur du transfert, le montant du jeton et le type de jeton.
* **Transit rapide** — Des fonds reçus puis envoyés dans un court laps de temps. Affiche la valeur et la fenêtre temporelle.

<figure><img src="https://2814209252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA1hiCzqdM5xM2e3ClwFX%2Fuploads%2Fgit-blob-204e7d243af0b1fe377918ff951e1ae8d59f212d%2Ftx-behavior-risk.png?alt=media" alt="Transaction Behavior Risk showing Large Transfer pattern"><figcaption></figcaption></figure>

### Transferts de jetons

Affiche tous les transferts de la transaction sous deux formats : un **graphique des flux de fonds** et une liste détaillée. Chaque transfert affiche les alertes qui lui sont associées. Les transferts non filtrés sont également répertoriés, ce qui vous permet de lancer directement leur filtrage.

### Aperçu des transferts

Fournit une liste de consultation rapide de tous les transferts de la transaction, avec des raccourcis permettant d’accéder aux détails de chacun d’entre eux.

### Alertes, journaux d’audit et commentaires

* **Alertes** — Toutes les alertes déclenchées par cette transaction. Filtrez par statut et cliquez sur une alerte pour accéder au Centre des alertes et en consulter les détails.
* **Journaux d’audit** — Enregistrements générés par le système des événements de filtrage, des changements de niveau de risque et d’autres activités.
* **Commentaires** — Les membres de l’équipe peuvent laisser des remarques et collaborer aux enquêtes.

### Actions disponibles

* **Relancer le filtrage** — Relancez le filtrage de l’ensemble de la transaction ou d’un transfert spécifique. Vous pouvez spécifier une direction pour chaque nouveau filtrage. Les résultats précédents restent visibles pendant le filtrage.
* **Rapport KYT** — Exportez les détails des risques de la transaction sous forme de rapport.
* **Rapport STR** — Exportez les données dans un format conforme aux exigences de signalement des transactions suspectes. Sélectionnez la juridiction de déclaration et assurez-vous que la direction du transfert a été spécifiée lors du filtrage. Un rapport STR distinct est généré pour chaque transfert.
* **Partager** — Générez un lien partageable vers les résultats du filtrage. Les destinataires peuvent consulter le rapport sans se connecter.
* **Supprimer** — Supprimez la transaction et tous les transferts qui lui sont associés.

## Supprimer des transactions

Pour supprimer une transaction et tous les transferts qui lui sont associés :

Cliquez sur le bouton de suppression sur la page des détails de la transaction ou dans la liste des transactions.
