> ## 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.

# Transaccions d'empreses: historial KYT

> Consulta l'historial de transaccions d'una entitat de Didit Business i veu com l'activitat alimenta les regles de Monitoratge de transaccions.

Cada transacció que envies amb un identificador `vendor_data` que coincideixi amb una entitat Business (com a sol·licitant, remitent, beneficiari o contrapart) queda vinculada a aquest perfil d'empresa. L'empresa esdevé un registre acumulatiu de la seva activitat, i el monitoratge de transaccions utilitza aquest historial per alimentar les regles de velocitat, de comportament i de cribratge a nivell d'empresa.

## Recuperar les transaccions d'una empresa

Filtra la llista de Transactions pel `vendor_data` de l'empresa:

```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"
```

Retorna totes les transaccions on l'empresa apareix com a sol·licitant. Per consultar l'historial com a contrapart, filtra a la Business Console (l'endpoint de llista pública només filtra per sol·licitant).

## Com s'enllacen les transaccions amb les empreses

```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
```

Cada transacció inclou fins a quatre parts (`applicant`, `remitter`, `beneficiary`, `counterparty`). Quan una part inclou un `vendor_data` que coincideix amb una entitat Business de la teva aplicació, Didit vincula la part a aquesta empresa. Les parts sense `vendor_data` es desen com a instantànies externes (sense enllaç a cap entitat).

Consulta [enviar transaccions](https://docs.didit.me/ca/transaction-monitoring/transactions.md) per veure el model complet de parts.

## Parts de tipus mixt

Una mateixa transacció pot combinar usuaris i empreses entre les seves parts, per exemple un usuari particular que paga a una empresa:

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

O una transferència B2B entre dues empreses:

```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 resol cada part de manera independent segons el `vendor_data`: la mateixa transacció passa als perfils de totes les entitats coincidents.

## Senyals de risc agregats

Les transaccions alimenten aquests senyals a nivell d'empresa:

| Senyal | Utilitzat per |
| - | - |
| Volum total entrant / sortint | Regles de velocitat, llindars |
| Nombre de transaccions en una finestra de temps | Regles de velocitat |
| Contraparts úniques | Regles de comportament |
| Jurisdiccions d'alt risc implicades | Regles de geografia |
| Exposició a contraparts sancionades | Regles de cribratge |
| Varietat de mètodes de pagament | Regles de frau |

Aquests senyals es calculen en temps real i s'avaluen contra les teves [regles de transaccions](https://docs.didit.me/ca/transaction-monitoring/rules.md) actives. Quan es compleix una regla, l'empresa pot passar automàticament a `FLAGGED` o `BLOCKED`, segons l'acció de la regla.

## Com actuen les regles sobre les empreses

Les `actions` d'una regla de transacció poden incloure:

* `add_score`: augmenta la puntuació de risc de la transacció.
* `change_status`: estableix l'estat de la transacció (`IN_REVIEW`, `DECLINED`, `AWAITING_USER`).
* `add_tags`: etiqueta la transacció.
* `add_to_list`: afegeix el `vendor_data` de l'empresa a una llista de bloqueig o a una llista personalitzada.

Quan una regla afegeix l'empresa a una llista de bloqueig, l'entitat Business passa a `BLOCKED` i s'activa el webhook `business.status.updated`.

## Supervisar el comportament d'una empresa

Utilitza la pestanya Transactions de la pàgina de detall de l'empresa a la Business Console per:

* Veure totes les transaccions en ordre cronològic.
* Filtrar per estat, import, direcció o contrapart.
* Obrir qualsevol transacció per inspeccionar les execucions de regles, l'enriquiment d'IP i els resultats del cribratge de criptoactius.
* Obrir un cas contra l'empresa per fer el seguiment d'una investigació.

## Mètodes de pagament d'una empresa

Cada transacció pot adjuntar un o més mètodes de pagament (targetes bancàries, comptes bancaris, carteres electròniques, carteres de criptoactius). Quan un mètode de pagament pertany a una empresa, s'enllaça de nou mitjançant `vendor_data`, de manera que pots veure tots els mètodes de pagament que una empresa ha utilitzat històricament, directament a la pàgina de detall de l'empresa.

## Ingestió històrica

Per carregar transaccions històriques en una empresa existent, passa `txn_date` amb una data passada:

```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 transaccions històriques continuen passant pel motor de regles. Si vols ingerir l'historial **sense** activar regles, utilitza el flux d'importació de la consola, que admet un mode "dry ingest".

## Següents passos

> [card] [Envia transaccions](https://docs.didit.me/ca/transaction-monitoring/transactions.md)
>
> Referència completa del payload.

> [card] [Regles](https://docs.didit.me/ca/transaction-monitoring/rules.md)
>
> Com les regles avaluen les transaccions i actuen sobre les empreses.

> [card] [Estats](https://docs.didit.me/ca/transaction-monitoring/statuses.md)
>
> Referència dels estats de transacció i de remediació.


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