Surveillance des transactions : démarrage en 10 min

Mettez en place la Surveillance des transactions en moins de 10 minutes. Vous allez soumettre une transaction de test, examiner son score, activer une règle prédéfinie, la soumettre à nouveau pour la déclencher, puis vérifier que le webhook est bien reçu.

Prérequis

Une application Didit avec la Surveillance des transactions activée (Settings → Transaction Monitoring → Enable).
Une clé API.
Un endpoint de webhook accessible depuis Internet.

Étapes

Soumettre une transaction de référence

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "baseline-0001",
    "transaction_category": "finance",
    "transaction_details": {
      "direction": "outbound",
      "amount": "500.00",
      "currency": "EUR"
    },
    "subject": { "entity_type": "person", "vendor_data": "user-42", "full_name": "Jane Doe" },
    "counterparty": { "entity_type": "company", "full_name": "Acme Supplier" }
  }'

La réponse contient :

status – APPROVED si aucune règle n’a été déclenchée, IN_REVIEW ou DECLINED si au moins une l’a été.
score – entier de 0 à 100+.
rule_runs – tableau de toutes les règles qui ont évalué cette transaction.

Activer une règle prédéfinie

Accédez à Transactions → Rules → Library dans la Business Console. Choisissez un préréglage, par exemple Structuring (outbound) : déclenché lorsque le même utilisateur envoie 20+ virements sortants, inférieurs à €10,000, en 30 jours. Activez-le et enregistrez.

Soumettre des transactions qui déclenchent la règle

Soumettez rapidement 20 transactions pour le même utilisateur, chacune inférieure à €10,000 :

for i in $(seq 1 20); do
  curl -X POST https://verification.didit.me/v3/transactions/ \
    -H "x-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{
      \"transaction_id\": \"struct-$i\",
      \"transaction_category\": \"finance\",
      \"transaction_details\": {
        \"direction\": \"outbound\",
        \"amount\": \"9500.00\",
        \"currency\": \"EUR\"
      },
      \"subject\": { \"entity_type\": \"person\", \"vendor_data\": \"user-42\", \"full_name\": \"Jane Doe\" },
      \"counterparty\": { \"entity_type\": \"company\", \"full_name\": \"Shell Co $i\" }
    }"
done

À la 20e soumission, la règle Structuring se déclenche. La transaction renvoie status: IN_REVIEW, et score reflète le score_delta de la règle.

S’abonner aux webhooks de transaction

curl -X POST https://verification.didit.me/v3/webhook/destinations/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "TM events",
    "url": "https://yourapp.com/webhooks/didit-tm",
    "subscribed_events": ["transaction.created", "transaction.status.updated"]
  }'

La réponse contient secret_shared_key : enregistrez-la immédiatement sous le nom DIDIT_WEBHOOK_SECRET dans votre .env :

DIDIT_WEBHOOK_SECRET=whsec_...   # signing secret returned from webhook registration

Vérifiez ensuite le HMAC X-Signature-V2 de chaque webhook reçu avant de lui faire confiance (recalculez le HMAC-SHA256 sur le corps canonique, comparez en temps constant, rejetez les horodatages périmés). Consultez les Webhooks TM pour les payloads et le code de vérification complet.Chaque transaction suivante est envoyée à votre endpoint en temps réel.

Consulter la console

Accédez à Transactions dans la console :

Vue liste : transactions récentes, filtres, actions groupées.
Détail d’une transaction : exécutions de règles, enrichissement IP, informations sur les parties, graphe de réseau (pour les crypto-actifs), alertes et dossiers liés.

Récupérer une transaction via l’API

curl https://verification.didit.me/v3/transactions/{transaction_id}/ \
  -H "x-api-key: YOUR_API_KEY"

Renvoie le schéma de réponse complet : score, règles correspondantes, enrichissement des parties, filtrage AML, et plus encore.

Ce que vous venez de configurer

Notation en temps réel – chaque transaction passe par toutes les règles actives.
Filtrage AML – les contreparties font automatiquement l’objet d’un filtrage au regard des sanctions et de la presse négative.
Enrichissement IP – chaque transaction est enrichie avec le pays associé à l’adresse IP, l’ASN et les indicateurs VPN/Tor.
Webhooks – notification en temps réel pour chaque transaction.
Piste d’audit – les exécutions de règles, les alertes et les transitions de statut sont interrogeables dans la console.

Prochaines étapes courantes

Guide d’intégration

Architecture complète et modèles d’intégration.

Règles en détail

Fonctionnement des règles, conditions, agrégations et actions.

Notation des risques

Comment les scores se combinent pour former les statuts.

Payload des transactions

Le schéma complet de soumission des transactions.

Statuts

États des transactions, des alertes et des dossiers.

Dossiers

Examiner et résoudre les dossiers.

Prise en main

Fonctionnalités

Référence

Console

Surveillance des transactions : démarrage en 10 min

Prérequis

Étapes

Ce que vous venez de configurer

Prochaines étapes courantes

Guide d’intégration

Règles en détail

Notation des risques

Payload des transactions

Statuts

Dossiers

​Prérequis

​Étapes

​Ce que vous venez de configurer

​Prochaines étapes courantes

Guide d’intégration

Règles en détail

Notation des risques

Payload des transactions

Statuts

Dossiers

Prérequis

Étapes

Ce que vous venez de configurer

Prochaines étapes courantes