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

# Reti Travel Rule: stato e copertura

> Copertura attuale di ogni rete e rail Travel Rule con Didit, requisiti dal tuo lato e adesioni ancora in attesa che Didit non ha.

Uno scambio [Travel Rule](https://docs.didit.me/it/transaction-monitoring/travel-rule.md) raggiunge la VASP controparte su un solo canale. Tre canali non richiedono l'adesione di nessuno: `INTERNAL` tra due clienti Didit, il Travel Rule Protocol aperto (`TRP`) e `EMAIL`. I quattro canali di rete (`GTR`, `TRUST`, `VERIFYVASP`, `SYGNA`) richiedono un'adesione a quella rete dal lato del mittente.

Questa pagina descrive cosa fa oggi ciascun canale, così sai dove le tue controparti sono raggiungibili prima di fare affidamento su un percorso.

> [!WARNING]
>
> **Didit non dispone ancora di un'adesione attiva a nessuna rete Travel Rule.** Un canale di rete funziona oggi solo con un'adesione che colleghi tu stesso nel **Marketplace** della console. Nessuno scambio raggiunge una controparte su GTR, TRUST, VerifyVASP o Sygna Bridge tramite l'adesione di Didit, e questa pagina cambierà il giorno in cui ciò accadrà.

## Stato in breve

| Canale | Cosa serve | Invio a una controparte | Ricezione da una controparte |
| - | - | - | - |
| `INTERNAL` | Nulla | Funziona | Funziona |
| `TRP` | Nulla | Funziona quando la controparte risponde subito | Non ancora disponibile |
| `EMAIL` | Un indirizzo di compliance | Funziona | Non è un canale di ricezione |
| `GTR` | La tua adesione | Implementato, non ancora verificato in produzione | Non ancora attivato |
| `VERIFYVASP` | La tua adesione | Implementato, non ancora verificato in produzione | Non ancora attivato |
| `SYGNA` | La tua adesione | Implementato, non ancora verificato in produzione | Non ancora attivato |
| `TRUST` | La tua adesione | Solo invio, non si completa mai | Non disponibile |
| CODE, TRISA, Notabene, Veriscope | - | Non integrato | Non integrato |

"Funziona" significa che Didit invia lo scambio e legge la risposta. "Implementato, non ancora verificato in produzione" significa che Didit invia lo scambio e legge la risposta della rete, ma nessuno scambio su quella rete si è ancora completato con una rete in produzione. Nessuna delle due indicazioni significa che una data controparte è raggiungibile: questo dipende dalla controparte, e i `routes` di ciascuna VASP nella [directory](https://docs.didit.me/it/transaction-monitoring/travel-rule.md#directory) indicano quali canali la tua applicazione può usare per essa oggi.

`EMAIL` trasporta solo le tue richieste in uscita: la pagina di risposta è il punto in cui una controparte risponde a una di esse, e nessuna VASP può inviarti un trasferimento via email.

Prima di fare affidamento su GTR, VerifyVASP, Sygna Bridge o TRUST, collega la tua adesione ed esegui un primo scambio con una controparte che conosci.

## Canali che non richiedono adesione

### INTERNAL

Entrambe le VASP operano su Didit, quindi lo scambio si regola all'interno della piattaforma senza alcuna chiamata in uscita. Il destinatario deve essere un cliente Didit attivo con Travel Rule abilitato, che ha dimostrato il controllo del wallet di destinazione con un messaggio firmato o un deposito di prova. Un wallet solo dichiarato, dimostrato esclusivamente tramite una schermata o non verificato, non riceve nulla. Vedi [Invio di un trasferimento](https://docs.didit.me/it/transaction-monitoring/travel-rule.md#invio-di-un-trasferimento).

### TRP

Didit supporta nativamente il Travel Rule Protocol. Un trasferimento passa su `TRP` quando contiene il Travel Address della controparte, quando la voce della rubrica del wallet di destinazione ne memorizza uno, oppure quando la controparte si risolve nella directory con un endpoint TRP che la directory ha verificato.

Ogni scambio TRP che non si conclude in una singola chiamata richiede l'host TRP pubblico di Didit, quello a cui puntano i Travel Address:

* **Invio.** Una controparte che risponde subito alla tua richiesta, nella sua risposta, completa o rifiuta il trasferimento. Una controparte che risponde più tardi pubblica la sua risposta sull'host TRP di Didit, quindi quello scambio non può completarsi finché l'host non è attivo: il trasferimento resta in attesa e scade alla scadenza prevista. Didit invia la richiesta una sola volta e non la ripete. Quando l'host TRP della controparte non è raggiungibile o rifiuta la richiesta, il trasferimento diventa immediatamente `COUNTERPARTY_VASP_NOT_REACHABLE` e puoi riprovarlo con `action: "resend"`.
* **Ricezione.** Le altre VASP ti raggiungono al tuo Travel Address su quell'host, quindi nessuna controparte può inviarti una richiesta TRP finché l'host non sarà attivo.

L'host TRP pubblico di Didit non espone ancora questi endpoint. [Interoperabilità Travel Rule](https://docs.didit.me/it/transaction-monitoring/travel-rule-interoperability.md) documenta gli endpoint che le controparti chiameranno quando l'host sarà attivo.

### EMAIL

Quando nessun protocollo raggiunge la controparte, Didit invia ai suoi indirizzi di compliance un link monouso a una pagina ospitata, dove accettano o rifiutano. Non serve alcun account né alcuna integrazione dalla loro parte. Vedi [Ritiro via email](https://docs.didit.me/it/transaction-monitoring/travel-rule.md#invio-via-email-alle-controparti-non-raggiungibili).

## Infrastrutture di rete

### Con una propria affiliazione

Collega la tua affiliazione nel **Marketplace** della console (categoria Travel Rule networks). I tuoi trasferimenti viaggeranno poi con la tua identità di rete, e un'affiliazione collegata ha sempre la precedenza su quella di Didit.

| Rete | Cosa chiede il Marketplace | Come arriva a Didit la risposta della controparte |
| - | - | - |
| `GTR` | URL base dell'API, codice VASP GTR, chiave di accesso, chiave segreta e la chiave privata ed25519 (base64) la cui chiave pubblica è registrata nel portale di GTR | Nella risposta di GTR alla richiesta, oppure interrogando lo stato della richiesta ogni 5 minuti mentre il trasferimento è in attesa |
| `VERIFYVASP` | L'URL del tuo Enclave VerifyVASP, il tuo ID VerifyVASP e il token che il tuo Enclave presenta a Didit | Interrogando lo stato della verifica ogni 5 minuti |
| `SYGNA` | Codice VASP Sygna, chiave API e chiave privata di firma. L'URL base dell'API è facoltativo: lascialo vuoto per il Sygna Bridge di produzione | Interrogando lo stato del trasferimento ogni 5 minuti. Il callback di autorizzazione di Sygna punta all'host TRP pubblico di Didit, che non è ancora attivo, quindi oggi l'interrogazione è l'unico modo in cui la risposta arriva a Didit |
| `TRUST` | URL base, ID membro TRUST e chiave API. Una chiave privata di cifratura X25519 (esadecimale) è facoltativa | Mai: TRUST non invia nulla che Didit possa leggere, quindi un trasferimento consegnato resta in attesa fino alla scadenza del termine |

GTR, TRUST e VerifyVASP accettano anche, in modo facoltativo, un certificato client per mutual TLS, la relativa chiave client e un bundle CA (PEM), per un'affiliazione che usa mutual TLS o una CA privata.

* Didit invia in background e riprova con una rete che non risponde, o che risponde con un errore temporaneo (nessuna risposta in tempo, connessione non riuscita, HTTP `408`, `429` o `5xx`): dopo 30 secondi, poi dopo 2, 10, 30 e 60 minuti. Dopo il sesto tentativo fallito il trasferimento passa a `COUNTERPARTY_VASP_NOT_REACHABLE`. Un rifiuto, come un'altra risposta `4xx` o un reindirizzamento, non viene ritentato: il trasferimento passa subito a `COUNTERPARTY_VASP_NOT_REACHABLE`.
* Un trasferimento la cui risposta non arriva mai resta in `AWAITING_COUNTERPARTY` finché non trascorrono `confirmation_timeout_hours`, poi scade e applica il tuo `timeout_outcome`.
* La ricezione di un trasferimento che un altro VASP ti invia tramite GTR, VerifyVASP o Sygna Bridge non è ancora attiva: Didit la attiva rete per rete, e fino ad allora queste reti non possono consegnarti un trasferimento.
* Il salvataggio di un'affiliazione restituisce `400` quando il suo codice partecipante è il codice di Didit su quella rete, oppure un codice già in uso da un'altra applicazione.
* Le richieste di rete trasmettono le tue credenziali solo all'host di quella rete e non seguono mai un reindirizzamento. Il pacchetto dati TRUST va al beneficiario senza la tua chiave API, il tuo ID membro o il tuo certificato client.

### Tramite l'affiliazione di Didit

Una volta che Didit detiene un'affiliazione a una rete, un cliente che non ne ha una può raggiungere la rete come proprio partecipante tramite l'affiliazione di Didit, con il codice partecipante che la rete gli assegna: i messaggi in uscita indicano il tuo codice, mai quello di Didit. Questa modalità è offerta solo per GTR e Sygna Bridge. TRUST ammette i membri un VASP alla volta e un Enclave VerifyVASP serve un solo VASP, quindi per entrambe si accede solo con una propria affiliazione.

L'adesione richiede tre passaggi: rispondere al questionario di due diligence di Didit sulla rete, far approvare il questionario da Didit, quindi richiedere l'accesso alla rete. Didit ti registra presso la rete, e il tuo partecipante diventa attivo una volta che la rete gli assegna un codice.

Questo flusso non è ancora aperto. Finché non lo sarà, il salvataggio o l'invio del questionario e la richiesta di accesso a una rete restituiscono `403` con `code: travel_rule_platform_networks_disabled`, e `GET /v3/travel-rule/networks/` riporta `platform_networks_enabled: false`.

## Lettura dello stato della tua applicazione

`GET /v3/travel-rule/settings/` e `GET /v3/travel-rule/networks/` restituiscono `networks`, indicizzato per `gtr`, `trust`, `verifyvasp` e `sygna`. Ogni voce indica cosa la rete può fare oggi per la tua applicazione:

| `state` | `reason` | Significato |
| - | - | - |
| `own_membership` | `own_membership_connected` | Hai collegato la tua adesione. Su un'applicazione in produzione invia per tuo conto. |
| `live_through_didit` | `participant_active` | L'adesione di Didit include la tua applicazione come proprio partecipante attivo. |
| `off` | `platform_network_switched_off` | Hai disattivato la rete in `disabled_networks`. |
| `didit_onboarding` | `didit_membership_not_live` | L'adesione di Didit alla rete non è ancora attiva. |
| `questionnaire_needed` | `questionnaire_not_submitted`, `questionnaire_changes_requested` | Il questionario di Didit per la rete non è stato inviato, oppure Didit ha richiesto modifiche. |
| `questionnaire_in_review` | `questionnaire_submitted` | Didit sta esaminando il tuo questionario. |
| `request_access` | `participant_not_requested` | Il tuo questionario è approvato: richiedi l'accesso alla rete. |
| `request_sent` | `questionnaire_pending`, `submitted_to_network` | La tua richiesta è in attesa che Didit ti registri, oppure dell'onboarding della rete. |
| `unavailable` | `own_membership_only`, `sandbox_application`, `questionnaire_rejected`, `participant_suspended`, `participant_rejected` | Nessun invio è possibile su questa rete per la tua applicazione: TRUST e VerifyVASP sono raggiungibili solo con la tua adesione, Didit non registra mai un'applicazione sandbox su una rete, Didit ha rifiutato il tuo questionario, oppure la rete ha sospeso o rifiutato il tuo partecipante. |
| `error` | `provisioning_failed`, `participant_key_missing`, `participant_key_unresolved` | La rete ha rifiutato la tua registrazione, oppure manca la chiave necessaria al tuo partecipante. Richiedere di nuovo la rete ritenta l'operazione. |

`mode` riassume lo stato come `own`, `didit`, `off` o `unavailable`. Viene verificata per prima la tua adesione, poi `disabled_networks`, quindi l'adesione di Didit. Oggi una rete risulta `own_membership` una volta collegata la tua adesione. Altrimenti GTR e Sygna Bridge risultano `didit_onboarding` (`unavailable` con `sandbox_application` su un'applicazione sandbox), mentre TRUST e VerifyVASP risultano `unavailable` con `own_membership_only`, anche in sandbox.

Un'applicazione sandbox non invia mai su una rete, nemmeno con la tua adesione collegata e in stato `own_membership`: i suoi trasferimenti vanno al [Didit Test VASP](https://docs.didit.me/it/transaction-monitoring/travel-rule-sandbox.md).

`connected` significa che la tua adesione salvata ha superato la validazione locale, non che uno scambio sia andato a buon fine. Il primo scambio in produzione lo verifica presso la rete.

## Cosa cambia quando una rete va in produzione

Questa pagina, lo stato `networks` e tutti i percorsi della directory cambiano insieme. Nella tua integrazione non cambia nulla: un trasferimento inizia a passare dalla rete non appena la tua applicazione ha un'adesione su di essa, secondo l'ordine dei canali descritto in [Come Didit instrada uno scambio](https://docs.didit.me/it/transaction-monitoring/travel-rule-interoperability.md#come-didit-instrada-un-exchange).

Per richiedere una rete che Didit non raggiunge ancora, usa il riquadro **Richiedi accesso** nel **Marketplace**. Ogni richiesta mostra il proprio stato (**Aperta**, **Contattata**, **In corso**, **Attiva** o **Rifiutata**) con l'ultima nota di Didit. Quando Didit cambia lo stato o la nota, invia un'email al membro del team che ha fatto la richiesta, finché fa ancora parte della tua organizzazione. Una richiesta fatta con una chiave API non genera alcuna email, quindi segui l'avanzamento nel **Marketplace**.

## Prossimi passi

> [card] [Travel Rule](https://docs.didit.me/it/transaction-monitoring/travel-rule.md)
>
> Il ciclo di vita dello scambio, le impostazioni, i canali e l'API /v3/.

> [card] [Test in sandbox](https://docs.didit.me/it/transaction-monitoring/travel-rule-sandbox.md)
>
> Testa ogni esito con il Didit Test VASP prima di andare in produzione.

> [card] [Interoperabilità](https://docs.didit.me/it/transaction-monitoring/travel-rule-interoperability.md)
>
> Gli endpoint che i VASP delle controparti usano per raggiungerti.

> [card] [Directory](https://docs.didit.me/it/transaction-monitoring/travel-rule.md#directory)
>
> Trova un VASP e i percorsi che la tua applicazione può usare per raggiungerlo.


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