KYT pour les plateformes d'échange et les rampes d'accès crypto : Guide de mise en œuvre (FR)

Une plateforme d'échange ou une rampe d'accès crypto n'a que deux moments où le risque on-chain entre ou sort de l'entreprise : un dépôt arrive, et un retrait part. Si vous effectuez correctement le filtrage à ces deux points, vous couvrez l'essentiel du Know Your Transaction (KYT). Si vous le faites mal — filtrez trop tard, filtrez la mauvaise chose, ou traitez chaque correspondance comme un ticket manuel — vous acceptez soit des fonds contaminés, soit vous submergez vos analystes.

Ceci est un guide de construction pour intégrer le filtrage de portefeuille de Didit dans un flux de dépôt/retrait. Il couvre où filtrer, comment coder la politique pour que la plupart des décisions soient automatiques, et comment gérer celles qui ne le sont pas — tout cela sur l'API unifiée /v3/ à 0,02 $ par filtrage avec votre propre clé (BYOK).

Points clés à retenir

• Deux points de filtrage : filtrez l'adresse de dépôt à l'entrée, filtrez l'adresse de destination à la sortie.
• Bloquez avant le règlement. Le filtrage avant le transfert vous permet de refuser un dépôt ou de bloquer un retrait avant que la valeur ne soit déplacée.
• Codez la politique sous forme de règles afin que les faibles/moyens passent automatiquement, les élevés soient acheminés pour examen, et les critiques soient refusés — les analystes ne traitent que les cas limites.
• Enregistrements post-transfert par hachage de transaction conservent une piste d'audit et détectent les désignations de sanctions rétroactives.
• Gestion de cas intégrée + flux de travail SAR — les alertes s'ouvrent dans la même console, pas besoin d'un outil séparé.
• 0,02 $ par filtrage avec BYOK (Crystal ou Merkle Science) ; paiement à la demande, sans minimum.

Ce que KYT signifie pour un échange

Le KYC vérifie l'identité de votre utilisateur lors de l'intégration. Le KYT surveille ce que fait son argent par la suite — plus précisément, d'où proviennent les cryptos qu'il dépose et où vont les cryptos qu'il retire. Pour un échange ou une rampe d'accès, l'obligation est concrète : n'acceptez pas de fonds exposés à des sanctions, des mixeurs, le darknet, des rançongiciels ou des fonds volés, et n'envoyez pas de fonds à des portefeuilles ayant les mêmes caractéristiques. Le filtrage des portefeuilles est le mécanisme qui applique cela transaction par transaction.

Pourquoi c'est important

Les dépôts et les retraits sont les deux seules portes qu'utilise la valeur, ce sont donc les deux seules portes qu'utilise le risque. Un dépôt contaminé accepté est une exposition au blanchiment sur vos livres ; un retrait envoyé à un portefeuille sanctionné est une violation de sanctions, quelle que soit l'intention. L'attente réglementaire pour les PSAN est un suivi continu explicite des transactions, et l'attente pratique est que vous détectiez cela avant le règlement, et non lors d'un examen de fin de mois.

La raison pour laquelle les équipes sous-filtraient historiquement est le coût : les abonnements aux analyses de blockchain héritées facturaient le filtrage comme un contrat d'entreprise. À 0,02 $ par filtrage avec BYOK, cette contrainte a disparu — vous pouvez filtrer chaque dépôt et chaque retrait et rester environ 10 fois moins cher que d'acheter les données directement.

Détails techniques

Tout fonctionne sur POST /v3/transactions/. Définissez currency_kind: "crypto", une direction et l'adresse que vous filtrez.

Dépôt (INBOUND) — filtrez l'adresse source avant de créditer :

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_a31f",
    "category": "finance",
    "amount": 8000,
    "currency": "USDT",
    "currency_kind": "crypto",
    "direction": "INBOUND",
    "wallet_address": "0x12ab...90cd",
    "include_crypto_screening": true,
    "subject": { "vendor_data": "user_2201", "role": "RECEIVER" }
  }'

Retrait (OUTBOUND) — filtrez la destination avant de libérer :

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_b58c",
    "category": "finance",
    "amount": 8000,
    "currency": "USDT",
    "currency_kind": "crypto",
    "direction": "OUTBOUND",
    "wallet_address": "0x44de...11ff",
    "include_crypto_screening": true,
    "subject": { "vendor_data": "user_2201", "role": "SENDER" }
  }'

Branchez-vous sur la bande du verdict :

{
  "transaction_id": "wd_b58c",
  "status": "APPROVED",
  "wallet_screening": {
    "risk_score": 12,
    "risk_band": "LOW",
    "exposure": [ { "category": "EXCHANGE", "type": "DIRECT", "share": 0.96 } ]
  }
}

Après le règlement, filtrez la transaction confirmée par hachage (payment_reference_id) pour conserver un enregistrement post-transfert vérifiable.

Webhooks. Abonnez-vous à transaction.status.updated afin que votre grand livre reflète les décisions des analystes et toute remédiation AWAITING_USER.

Prix. 0,02 $ par filtrage avec BYOK (Crystal ou Merkle Science), par appel, sans minimum.

Un flux de référence

Demande de dépôt
   └─ POST /v3/transactions/ (INBOUND, wallet_address, screening)
        ├─ FAIBLE / MOYEN → créditer le dépôt
        ├─ ÉLEVÉ          → bloquer ; ouvrir alerte ; examen par l'analyste
        └─ CRITIQUE      → rejeter ; geler ; ouvrir alerte ; envisager une SAR

Demande de retrait
   └─ POST /v3/transactions/ (OUTBOUND, destination wallet_address, screening)
        ├─ FAIBLE / MOYEN → libérer
        ├─ ÉLEVÉ          → bloquer ; examen par l'analyste
        └─ CRITIQUE      → bloquer ; ouvrir alerte

Post-règlement
   └─ POST /v3/transactions/ (hash as payment_reference_id) → enregistrement d'audit

Codez le traitement FAIBLE/MOYEN/ÉLEVÉ/CRITIQUE une seule fois dans le bundle de règles Crypto screening afin que le statut revienne déjà décidé — votre backend n'a plus qu'à agir en conséquence.

Cas d'utilisation

• Échanges centralisés — filtrez chaque dépôt et retrait ; refusez automatiquement les CRITIQUES, mettez en file d'attente les ÉLEVÉS, enregistrez le reste.
• Rampes d'accès/de sortie — bloquez les conversions fiat↔crypto sur le portefeuille du contrepartie avant de régler sur les rails bancaires.
• Courtiers ajoutant des cryptos — réutilisez une intégration de surveillance des transactions existante ; le filtrage crypto utilise le même endpoint.
• Dépositaires — filtrez à l'entrée et refiltrez lors des mouvements, avec le graphe réseau comme preuve de gel.
• PSAN — associez le KYT à l'échange de données de la Règle de Voyage du GAFI sur le même moteur pour un risque de contrepartie de bout en bout.

Comment s'intégrer à Didit

1. Configurez le fournisseur + la valeur par défaut. Dans Console → Transactions → Paramètres, définissez Crystal ou Merkle Science (BYOK ou géré) et le comportement de filtrage par défaut.
2. Écrivez les règles de politique. Activez le bundle de filtrage Crypto et définissez les bandes → actions pour que la plupart des décisions soient automatiques.
3. Filtrez aux deux portes. Appelez POST /v3/transactions/ pour chaque dépôt (INBOUND) et retrait (OUTBOUND) avant le règlement.
4. Enregistrez après le règlement. Refiltrez la transaction confirmée par hachage pour la piste d'audit.
5. Gérez les cas limites. Les filtrages ÉLEVÉS/CRITIQUES ouvrent des alertes ; enquêtez, escaladez vers un cas et déposez des SAR dans la même Console.

Parce que tout est sur l'API unifiée /v3/, le même utilisateur qui dépose passe par la surveillance des transactions, une transaction signalée peut être mise en pause via AWAITING_USER et déclencher une étape de remédiation, et le KYC, le KYT et l'AML se combinent en une seule plateforme d'identité et de fraude.

Questions fréquemment posées

Où exactement dois-je filtrer ?

À deux points : l'adresse source de chaque dépôt (INBOUND) avant de créditer, et l'adresse de destination de chaque retrait (OUTBOUND) avant de libérer. Ajoutez un filtrage post-transfert par hachage pour les enregistrements.

Le filtrage de chaque transaction ne sera-t-il pas coûteux ?

Non. À 0,02 $ par filtrage avec BYOK — environ 10 fois moins cher que d'acheter des analyses directes — le filtrage de chaque dépôt et retrait est abordable, même à fort volume.

Comment éviter une révision manuelle à chaque correspondance ?

Codez la politique dans le bundle de règles de filtrage Crypto afin que les FAIBLES/MOYENS passent automatiquement, les ÉLEVÉS soient acheminés vers un analyste et les CRITIQUES soient refusés. Les analystes ne gèrent que les cas limites.

Cela couvre-t-il également la Règle de Voyage ?

Oui. Le même moteur de surveillance des transactions prend en charge la Règle de Voyage du GAFI, de sorte que l'échange de données avec les contreparties et le filtrage des portefeuilles fonctionnent ensemble.

Quels fournisseurs puis-je utiliser ?

Crystal et Merkle Science aujourd'hui (BYOK ou géré) ; Chainalysis et Elliptic arrivent bientôt à 0,02 $ BYOK.

Prêt à commencer ?

Lisez l'aperçu du filtrage de portefeuille dans la documentation, voyez comment cela 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 filtrage de portefeuille à 0,02 $ par filtrage avec BYOK.