Blog · 21 mai 2026

Filtrage de Portefeuille Crypto : Avant ou Après le Transfert ? (FR)

Le filtrage pré-transfert examine une adresse de portefeuille avant le mouvement de valeur ; le filtrage post-transfert analyse une transaction réglée par son hachage.

Par Didit21 mai 2026Mis à jour le 21 mai 2026

Il y a deux moments pour filtrer une transaction crypto, et ils répondent à deux questions différentes. Avant que la valeur ne bouge, vous filtrez l'adresse du portefeuille pour décider si la transaction doit avoir lieu. Une fois la valeur réglée, vous filtrez le hachage de la transaction pour enregistrer ce qui a réellement bougé et le réévaluer par rapport aux dernières informations. Le premier est une porte d'accès ; le second est un registre.

L'API de filtrage de portefeuille de Didit prend en charge les deux. Le filtrage pré-transfert prend une adresse de portefeuille et renvoie un verdict de risque avant que vous n'acceptiez un dépôt ou ne libériez un retrait. Le filtrage post-transfert prend un hachage de transaction et évalue une transaction confirmée après coup. Les deux renvoient le même score de risque de 0 à 100 avec des bandes BAS/MOYEN/ÉLEVÉ/CRITIQUE et une ventilation de la source des fonds, et les deux coûtent 0,02 $ par filtrage.

Ce guide explique la différence et comment intégrer chacun dans un flux réel.

Points clés à retenir

Pré-transfert = adresse, avant le mouvement de valeur. Filtrez une adresse de portefeuille pour autoriser ou bloquer un dépôt ou un retrait avant qu'il ne se produise.
Post-transfert = hachage de transaction, après règlement. Filtrez une transaction confirmée (par payment_reference_id) pour la tenue des registres et l'examen continu.
Même format de verdict pour les deux — un score de risque de 0 à 100, une bande BAS/MOYEN/ÉLEVÉ/CRITIQUE et l'exposition par catégorie de source de fonds.
Utilisez les deux ensemble dans la plupart des flux : pré-transfert pour décider, post-transfert pour documenter et vérifier à nouveau.
Déclenché par currency_kind: "crypto" plus une direction (INBOUND / OUTBOUND) ; annulez par appel avec include_crypto_screening.
0,02 $ par filtrage avec BYOK (Crystal ou Merkle Science), quelle que soit la méthode utilisée.

Ce que chaque méthode filtre

Le filtrage pré-transfert évalue une adresse de portefeuille. Vous ne savez pas encore si une valeur va bouger — vous demandez : « si j'accepte des fonds de (ou envoie des fonds à) cette adresse, à quoi suis-je exposé ? » L'API trace l'historique entrant et sortant de l'adresse et renvoie son risque. C'est le point de décision : passer, mettre en attente pour examen, ou refuser avant que quoi que ce soit ne soit réglé.

Le filtrage post-transfert évalue une transaction spécifique par son hachage. La valeur a déjà bougé ; vous enregistrez le risque de ce qui s'est passé et le maintenez à jour. Parce que les étiquettes on-chain évoluent — une adresse peut être ajoutée à une liste de sanctions après que vous ayez effectué une transaction avec elle — le filtrage post-transfert (et le re-filtrage périodique) maintient vos registres précis pour l'audit et les obligations de surveillance continue.

Pourquoi c'est important

Choisir le mauvais moment crée de réelles lacunes. Si vous ne filtrez qu'après le transfert, vous avez déjà accepté les fonds avant de savoir qu'ils étaient risqués — vous êtes maintenant en train d'annuler une transaction réglée au lieu de refuser une transaction en attente. Si vous ne filtrez qu'avant le transfert, vos registres deviennent obsolètes : le verdict que vous avez capturé au moment du dépôt ne reflète pas les informations apparues par la suite, ce qui affaiblit toute piste d'audit et manque les désignations de sanctions rétroactives.

Les régulateurs et les bonnes pratiques convergent vers la même réponse : filtrez en amont avec le filtrage pré-transfert, puis maintenez un registre précis et vérifiable avec le filtrage post-transfert. L'exécution des deux est la raison pour laquelle le prix de 0,02 $ par filtrage est important — à ce coût, filtrer deux fois est toujours un ordre de grandeur moins cher qu'un seul filtrage sur un abonnement hérité.

Détails techniques

Les deux modes fonctionnent sur l'API unifiée /v3/ au sein de la surveillance des transactions. La différence réside dans le fait de passer une adresse de portefeuille ou une référence de transaction.

Pré-transfert — filtrer une adresse avant d'accepter un dépôt :

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "dep_61a0",
    "category": "finance",
    "currency_kind": "crypto",
    "direction": "INBOUND",
    "wallet_address": "0x4d2a...91bc",
    "include_crypto_screening": true,
    "subject": { "vendor_data": "user_5012", "role": "RECEIVER" }
  }'

Post-transfert — filtrer une transaction réglée par son hachage :

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "wd_77f3",
    "category": "finance",
    "currency_kind": "crypto",
    "direction": "OUTBOUND",
    "payment_reference_id": "0xabc123...def",
    "include_crypto_screening": true,
    "subject": { "vendor_data": "user_5012", "role": "SENDER" }
  }'

Les deux renvoient la même structure de verdict :

{
  "wallet_screening": {
    "risk_score": 41,
    "risk_band": "MEDIUM",
    "exposure": [
      { "category": "HIGH_RISK_EXCHANGE", "type": "DIRECT", "share": 0.27 }
    ]
  }
}

Le déclencheur. Le filtrage se déclenche lorsque currency_kind est "crypto" et qu'une direction (INBOUND ou OUTBOUND) est définie. Le comportement par défaut — si les transactions crypto sont filtrées automatiquement — est configuré dans Console → Transactions → Paramètres, et include_crypto_screening l'annule par appel.

Le champ clé. Passez une wallet_address pour le pré-transfert ; passez le hachage de la transaction comme payment_reference_id pour le post-transfert.

Prix. 0,02 $ par filtrage, quel que soit le mode, avec BYOK (Crystal ou Merkle Science).

Quand utiliser chaque méthode

Scénario	Utilisation	Pourquoi
Acceptation d'un dépôt	Pré-transfert (adresse)	Décider avant que les fonds ne soient les vôtres
Libération d'un retrait	Pré-transfert (adresse de destination)	Bloquer l'envoi vers un portefeuille risqué
Enregistrement d'un transfert réglé	Post-transfert (hachage)	Piste d'audit précise de ce qui a bougé
Re-filtrage périodique	Post-transfert (hachage)	Détecter les désignations de sanctions rétroactives
À la fois filtrage et tenue de registres	Les deux	Filtrer en amont, documenter après

Cas d'utilisation

Échanges de crypto-monnaies — pré-transfert sur chaque dépôt et retrait pour filtrer le flux ; post-transfert pour maintenir un registre complet et vérifiable.
Passerelles fiat-crypto — pré-transfert pour bloquer les conversions impliquant des portefeuilles à haut risque avant le règlement.
Dépositaires — pré-transfert à l'entrée, re-filtrage post-transfert sur les actifs stockés à mesure que les étiquettes évoluent.
Portefeuilles — pré-transfert pour avertir un utilisateur avant qu'il n'envoie à une adresse signalée.
PSAN — registres post-transfert associés aux données de la Règle de Voyage pour une piste de conformité défendable.

Comment s'intégrer à Didit

Définissez le comportement par défaut dans Transactions → Paramètres — choisissez si les transactions crypto sont filtrées automatiquement et quelle clé de fournisseur utiliser.
Filtrez en amont. Avant d'accepter un dépôt ou de libérer un retrait, POST /v3/transactions/ avec la wallet_address et agissez sur la bande de risque.
Enregistrez après le règlement. Une fois qu'une transaction est confirmée, filtrez-la à nouveau avec le hachage comme payment_reference_id.
Gérez les alertes. Les filtrages ÉLEVÉ/CRITIQUE ouvrent des alertes dans le gestionnaire de cas intégré pour enquête et déclaration de soupçon.

Questions fréquemment posées

Quelle est la différence pratique entre le filtrage pré- et post-transfert ?

Le filtrage pré-transfert examine une adresse de portefeuille avant le mouvement de valeur, afin que vous puissiez refuser. Le filtrage post-transfert examine une transaction réglée par son hachage, de sorte que vous disposez d'un enregistrement précis et vérifiable.

Dois-je faire les deux ?

La plupart des équipes devraient. Le pré-transfert filtre le flux ; le post-transfert maintient les registres à jour — y compris la détection des adresses ajoutées aux listes de sanctions après que vous ayez effectué une transaction.

Comment filtrer un hachage de transaction ?

Passez le hachage comme payment_reference_id sur POST /v3/transactions/ avec currency_kind: "crypto" et une direction.

L'exécution des deux coûte-t-elle deux fois plus cher ?

Oui — 0,02 $ chacun — mais à ce prix, deux filtrages sont toujours bien moins chers qu'un seul filtrage sur un abonnement d'analyse de blockchain hérité.

Puis-je activer le filtrage uniquement pour certaines transactions ?

Oui. Définissez une valeur par défaut dans Console → Transactions → Paramètres et annulez-la par appel avec include_crypto_screening.

Prêt à commencer ?

Lisez l'aperçu du filtrage de portefeuille dans la documentation, voyez comment il s'intègre à la plateforme sur la page produit du filtrage de portefeuille, et vérifiez les prix par appel sur la page de tarification. Lorsque vous êtes prêt, commencez gratuitement — 500 vérifications KYC gratuites chaque mois, et le filtrage de portefeuille à 0,02 $ par filtrage.