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

# Transacciones de empresas: historial KYT

> Consulta el historial de transacciones de una empresa en Didit y cómo su actividad alimenta las reglas de velocidad, comportamiento y cribado.

Cada transacción que envías con un identificador de `vendor_data` que coincide con una empresa (como solicitante, remitente, beneficiario o contraparte) queda vinculada a ese perfil de empresa. La empresa se convierte en un registro actualizado de su actividad, y la Monitorización de transacciones usa este historial para alimentar las reglas de velocidad, de comportamiento y de análisis a nivel de empresa.

## Obtener las transacciones de una empresa

Filtra la lista de transacciones por el `vendor_data` de la 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"
```

Devuelve todas las transacciones en las que la empresa aparece como solicitante. Para el historial como contraparte, filtra en la Business Console (el endpoint público de listado solo filtra por solicitante).

## Cómo se vinculan las transacciones a las empresas

```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ón incluye hasta cuatro partes (`applicant`, `remitter`, `beneficiary`, `counterparty`). Cuando una parte incluye un `vendor_data` que coincide con una entidad Business de tu aplicación, Didit vincula esa parte a esa empresa. Las partes sin `vendor_data` se guardan como instantáneas externas (sin vínculo a ninguna entidad).

Consulta [el envío de transacciones](https://docs.didit.me/es/transaction-monitoring/transactions.md) para ver el modelo completo de partes.

## Tipos de partes combinados

Una misma transacción puede combinar usuarios y empresas entre sus partes; por ejemplo, un usuario 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 transferencia B2B entre dos empresas:

```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 identifica cada parte de forma independiente a partir de `vendor_data`: la misma transacción se incorpora a los perfiles de todas las entidades coincidentes.

## Señales de riesgo agregadas

Las transacciones alimentan estas señales a nivel de empresa:

| Señal | Usada por |
| - | - |
| Volumen total entrante / saliente | Reglas de velocidad, establecimiento de umbrales |
| Número de transacciones en una ventana de tiempo | Reglas de velocidad |
| Contrapartes únicas | Reglas de comportamiento |
| Jurisdicciones de alto riesgo involucradas | Reglas geográficas |
| Exposición a contrapartes sancionadas | Reglas de detección |
| Variedad de métodos de pago | Reglas de fraude |

Estas señales se calculan en tiempo real y se evalúan frente a tus [reglas de transacciones](https://docs.didit.me/es/transaction-monitoring/rules.md) activas. Cuando se cumple una regla, la empresa puede pasar automáticamente a `FLAGGED` o `BLOCKED`, según la acción de la regla.

## Cómo actúan las reglas sobre las empresas

Las `actions` de una regla de transacciones pueden incluir:

* `add_score`: aumenta la puntuación de riesgo de la transacción.
* `change_status`: establece el estado de la transacción (`IN_REVIEW`, `DECLINED`, `AWAITING_USER`).
* `add_tags`: etiqueta la transacción.
* `add_to_list`: añade el `vendor_data` de la empresa a una lista de bloqueo o a una lista personalizada.

Cuando una regla añade la empresa a una lista de bloqueo, la entidad de empresa pasa a `BLOCKED` y se dispara un webhook `business.status.updated`.

## Monitorizar el comportamiento de una empresa

Usa la pestaña Transacciones de la página de detalle de la empresa en la Business Console para:

* Ver todas las transacciones en orden cronológico.
* Filtrar por estado, importe, dirección y contraparte.
* Abrir cualquier transacción para revisar las ejecuciones de reglas, el enriquecimiento de IP y los resultados del análisis de criptomonedas.
* Abrir un caso contra la empresa para hacer seguimiento de una investigación.

## Métodos de pago de una empresa

Cada transacción puede incluir uno o varios métodos de pago (tarjetas bancarias, cuentas bancarias, monederos electrónicos, wallets de criptomonedas). Cuando un método de pago pertenece a una empresa, se vincula a ella mediante `vendor_data`, así que ves todos los métodos de pago que una empresa ha usado a lo largo del tiempo directamente en su página de detalle.

## Ingesta histórica

Para cargar transacciones históricas de una empresa existente, pasa un `txn_date` en el pasado:

```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]
>
> Las transacciones históricas también pasan por el motor de reglas. Si quieres ingerir el historial **sin** disparar reglas, usa el flujo de importación de la consola, que admite un modo de "dry ingest".

## Próximos pasos

> [card] [Enviar transacciones](https://docs.didit.me/es/transaction-monitoring/transactions.md)
>
> Referencia completa del payload.

> [card] [Reglas](https://docs.didit.me/es/transaction-monitoring/rules.md)
>
> Cómo las reglas evalúan las transacciones y actúan sobre las empresas.

> [card] [Estados](https://docs.didit.me/es/transaction-monitoring/statuses.md)
>
> Referencia de los estados de transacción y de remediación.


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