> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Transactions d'entreprise : historique KYT

> Récupérez l'historique des transactions d'une entité Business Didit. Découvrez comment cette activité alimente les règles de surveillance.

Chaque transaction que vous soumettez avec un identifiant `vendor_data` correspondant à une entité d'entreprise, en tant que demandeur, remetteur, bénéficiaire ou contrepartie, est liée à ce profil d'entreprise. L'entreprise devient un registre continu de son activité, et la Surveillance des transactions utilise cet historique pour alimenter, au niveau de l'entreprise, les règles de vélocité, comportementales et de filtrage.

## Récupérer les transactions d'une entreprise

Filtrez la liste des Transactions par le `vendor_data` de l'entreprise :

```bash theme={null}
curl -G https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=biz-acme" \
  --data-urlencode "page_size=50"
```

Renvoie toutes les transactions dans lesquelles l'entreprise apparaît en tant que demandeur. Pour l'historique côté contrepartie, filtrez dans la Business Console (l'endpoint de liste publique ne filtre que par demandeur).

## Comment les transactions sont liées aux entreprises

```mermaid theme={null}
flowchart LR
    T["Transaction<br/>txn_id=tx-0042"]
    A["applicant:<br/>vendor_data=biz-acme"]
    C["counterparty:<br/>vendor_data=biz-widgets"]
    B1[Business: biz-acme]
    B2[Business: biz-widgets]
    T --> A
    T --> C
    A -.-> B1
    C -.-> B2
```

Chaque transaction comprend jusqu'à quatre parties (`applicant`, `remitter`, `beneficiary`, `counterparty`). Lorsqu'une partie inclut un `vendor_data` qui correspond à une entité d'entreprise de votre application, Didit lie cette partie à l'entreprise. Les parties sans `vendor_data` sont enregistrées comme des instantanés externes (sans lien vers une entité).

Consultez [soumettre des transactions](https://docs.didit.me/fr/transaction-monitoring/transactions.md) pour le modèle complet des parties.

## Types de parties mixtes

Une même transaction peut associer des utilisateurs et des entreprises entre ses parties, par exemple un particulier qui paie une entreprise :

```json theme={null}
{
  "txn_id": "tx-0099",
  "direction": "OUTBOUND",
  "amount": "500.00",
  "currency": "EUR",
  "applicant": { "vendor_data": "user-42" },
  "counterparty": { "vendor_data": "biz-acme" }
}
```

Ou un virement B2B entre deux entreprises :

```json theme={null}
{
  "txn_id": "tx-0100",
  "direction": "OUTBOUND",
  "amount": "120000.00",
  "currency": "USD",
  "applicant": { "vendor_data": "biz-acme" },
  "counterparty": { "vendor_data": "biz-widgets" }
}
```

Didit résout chaque partie indépendamment à partir de `vendor_data`. La même transaction alimente ainsi les profils de chaque entité correspondante.

## Signaux de risque agrégés

Les transactions alimentent les signaux suivants au niveau de l'entreprise :

| Signal | Utilisé par |
| - | - |
| Volume total entrant / sortant | Règles de vélocité, seuillage |
| Nombre de transactions sur une période donnée | Règles de vélocité |
| Contreparties uniques | Règles comportementales |
| Juridictions à haut risque impliquées | Règles géographiques |
| Exposition à une contrepartie sous sanctions | Règles de filtrage |
| Diversité des moyens de paiement | Règles de fraude |

Ces signaux sont calculés en temps réel et évalués par rapport à vos [règles de transaction](https://docs.didit.me/fr/transaction-monitoring/rules.md) actives. Lorsqu'une règle correspond, l'entreprise peut passer automatiquement à `FLAGGED` ou `BLOCKED`, selon l'action de la règle.

## Comment les règles agissent sur les entreprises

Les `actions` d'une règle de transaction peuvent inclure :

* `add_score` : augmente le score de risque de la transaction.
* `change_status` : définit le statut de la transaction (`IN_REVIEW`, `DECLINED`, `AWAITING_USER`).
* `add_tags` : étiquette la transaction.
* `add_to_list` : ajoute le `vendor_data` de l'entreprise à une liste de blocage ou à une liste personnalisée.

Lorsqu'une règle ajoute l'entreprise à une liste de blocage, l'entité d'entreprise passe à `BLOCKED` et un webhook `business.status.updated` est déclenché.

## Surveiller le comportement d'une entreprise

Utilisez l'onglet Transactions de la page de détail de l'entreprise dans la Business Console pour :

* Voir toutes les transactions par ordre chronologique.
* Filtrer par statut, montant, direction et contrepartie.
* Ouvrir une transaction pour examiner les exécutions de règles, l'enrichissement IP et les résultats du filtrage crypto.
* Ouvrir un dossier sur l'entreprise pour suivre une enquête.

## Moyens de paiement détenus par une entreprise

Chaque transaction peut être associée à un ou plusieurs moyens de paiement (cartes bancaires, comptes bancaires, portefeuilles électroniques, portefeuilles crypto). Lorsqu'un moyen de paiement appartient à une entreprise, il est relié à elle via `vendor_data`. Vous voyez ainsi tous les moyens de paiement qu'une entreprise a utilisés, directement sur la page de détail de l'entreprise.

## Ingestion historique

Pour reconstituer l'historique des transactions d'une entreprise existante, transmettez un `txn_date` antérieur :

```bash theme={null}
curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "txn_id": "legacy-0001",
    "txn_date": "2024-03-15T10:00:00Z",
    "direction": "INBOUND",
    "amount": "25000.00",
    "currency": "EUR",
    "applicant": { "vendor_data": "biz-acme" },
    "counterparty": { "name": "Historic payer" }
  }'
```

> [!NOTE]
>
> Les transactions historiques passent toujours par le moteur de règles. Si vous souhaitez ingérer l'historique **sans** déclencher les règles, utilisez le flux d'import de la console, qui propose un mode « ingestion à blanc ».

## Étapes suivantes

> [card] [Soumettre des transactions](https://docs.didit.me/fr/transaction-monitoring/transactions.md)
>
> Référence complète du payload.

> [card] [Règles](https://docs.didit.me/fr/transaction-monitoring/rules.md)
>
> Comment les règles évaluent les transactions et agissent sur les entreprises.

> [card] [Statuts](https://docs.didit.me/fr/transaction-monitoring/statuses.md)
>
> Référence des statuts de transaction et de remédiation.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.