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

# Blocklist aziendale: blocca KYB e paesi

> Blocca le entità Didit Business per vendor_data o paese: come viene verificato un blocco e le rotte di console e API per aggiungerlo o rimuoverlo.

Le aziende che non hanno superato i controlli di compliance, o che hanno sede in una giurisdizione pericolosa, vengono bloccate: le blocklist impediscono loro di avviare nuove sessioni di Verifica aziendale (KYB) o di effettuare transazioni sulla tua piattaforma.

## Tipi di identificativo supportati per le aziende

| Tipo | Chiave | Corrisponde quando… |
| - | - | - |
| Azienda | `BUSINESS` | Una nuova sessione o transazione usa il `vendor_data` presente in blocklist |
| Paese | (configurato separatamente) | Il paese dell'azienda corrisponde a un elenco di paesi pericolosi |
| IP | `IP_ADDRESS` | L'IP di chi invia la richiesta (o un intervallo CIDR) corrisponde |
| Impronta del dispositivo | `DEVICE_FINGERPRINT` | Il dispositivo di chi invia la richiesta corrisponde |
| Indirizzo | `WALLET_ADDRESS` | Il wallet crypto collegato all'azienda corrisponde |
| Conto bancario | `BANK_ACCOUNT` | L'IBAN o il conto bancario corrisponde |

> [!NOTE]
>
> Le blocklist di volti e documenti operano a livello **individuale** (Utente), non a livello aziendale. Per bloccare amministratori o UBO, inseriscili in blocklist come Utenti: il loro coinvolgimento con qualsiasi azienda passa poi alla revisione delle persone chiave dell'azienda.

## Come avviene l'inserimento in blocklist

> [!NOTE]
>
> Una sessione di Verifica aziendale (KYB) rifiutata non inserisce in blocklist l'azienda. La sessione termina con stato `Declined` (rifiutata), l'azienda resta `ACTIVE` e non viene scritta alcuna voce nella lista. L'inserimento in blocklist è un passaggio manuale: aggiungi la voce dalla [pagina Blocklist](https://docs.didit.me/it/console/blocklist-users.md) o con la [Lists API](https://docs.didit.me/it/management-api/lists/overview.md). Una voce `BUSINESS` (il `vendor_data`) imposta inoltre lo stato dell'azienda su `BLOCKED`.

**1. Automatico: paese pericoloso**

Se il paese di costituzione dell'azienda compare nell'elenco dei paesi pericolosi configurato, la sessione di Verifica aziendale (KYB) viene rifiutata.

**2. Automatico: entità sanzionata**

Un riscontro AML aziendale sopra la soglia di rifiuto fa rifiutare la sessione. Non viene scritta alcuna voce nella lista; se vuoi che il `vendor_data` dell'azienda venga respinto da quel momento in poi, inseriscilo tu stesso in blocklist.

**3. Manuale: dalla console**

Un analista inserisce in blocklist un'azienda da *Businesses → \[azienda] → Actions → Add to blocklist*.

**4. Programmatico: tramite la Lists API**

Usa la [Lists API](https://docs.didit.me/it/management-api/lists/overview.md) per aggiungere direttamente voci alla blocklist delle aziende.

## Paesi pericolosi

Ogni applicazione include un elenco predefinito di **paesi pericolosi** (configurabile da *Settings → Blocklist → Countries*). Esempi di codici ISO inclusi di default: `IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR` (soggetti a modifiche: l'elenco predefinito segue le indicazioni di FATF e OFAC).

Quando viene creata un'azienda con un `country_code` corrispondente:

* La sessione di Verifica aziendale (KYB) viene rifiutata.
* Non viene emesso alcun link di sessione.
* L'entità aziendale viene creata con stato `BLOCKED`.

## Aggiungere un'azienda alla blocklist tramite API

Usa la [Lists API](https://docs.didit.me/it/management-api/lists/overview.md) per aggiungere una voce alla blocklist in modo programmatico:

1. [Elenca tutte le liste](https://docs.didit.me/it/management-api/lists/list.md) filtrando per `entry_type=business` e `is_system=true` per trovare la blocklist di sistema delle aziende.
2. [Crea una voce](https://docs.didit.me/it/management-api/lists/create-entry.md) in quella lista, con `value` impostato sul `vendor_data` dell'azienda, più un `display_label` e un `comment` opzionali per finalità di audit.

## Applicazione al momento della transazione

Le aziende in blocklist vengono automaticamente incluse nel Monitoraggio delle transazioni:

* Le transazioni con un'**azienda richiedente in blocklist** vengono rifiutate automaticamente.
* Le transazioni con un'**azienda controparte in blocklist** vengono segnalate o rifiutate a seconda della configurazione delle regole.

Le regole predefinite, come "Controparte sanzionata", si attivano su questi riscontri.

## Rimuovere un'azienda dalla blocklist

* **Console**: *Blocklist → Businesses → azioni di riga → Remove*.
* **API**: usa l'endpoint [Elimina voce](https://docs.didit.me/it/management-api/lists/delete-entry.md) con l'UUID della lista e l'UUID della voce.

La rimozione non modifica automaticamente lo `status` dell'azienda. Usa `PATCH /v3/businesses/{vendor_data}/update-status/` per riportare l'azienda su `ACTIVE`.

## Traccia di audit

Ogni inserimento e rimozione viene registrato nel [registro di audit](https://docs.didit.me/it/console/audit-logs.md) con:

* Attore (email dell'utente oppure `'system'`, `'api'`).
* Data e ora.
* Commento facoltativo.
* Sessione di riferimento, se generata automaticamente.

## Passi successivi

> [card] [Lists API](https://docs.didit.me/it/management-api/lists/overview.md)
>
> Riferimento completo dell'API delle blocklist.

> [card] [Blocklist da console](https://docs.didit.me/it/console/blocklist-users.md)
>
> Gestisci le blocklist dall'interfaccia.

> [card] [Operazioni](https://docs.didit.me/it/entities/businesses/operations.md)
>
> Modifica lo stato delle aziende.


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