> ## 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. # Abbinare deposito Travel Rule: API di abbinamento manuale > Con Didit, abbina un deposito in attesa dei dati dell'ordinante al messaggio Travel Rule del VASP di origine, che ne eredita i dati. Prompt API per abbinare un deposito Travel Rule non abbinato Copia il prompt negli appunti \

\`Pair an inbound deposit that still waits for originator data with the Travel Rule message the originating VASP sent for it.

Endpoint:
POST https://verification.didit.me/v3/travel-rule/unmatched/{transaction_uuid}/match/

Authentication:
Use the x-api-key header with my Didit API key. A scoped API key needs the transactions privilege.

Path parameter:
\- transaction_uuid - the transaction_id of the unmatched deposit, from GET /v3/travel-rule/unmatched/.

Request body (JSON, required):
\- transaction_id (UUID) - the transaction_id of the received Travel Rule message: a row with kind "message" from GET /v3/travel-rule/transfers/?kind=message. The transfer's own id is not found.

curl example:
curl -X POST "https://verification.didit.me/v3/travel-rule/unmatched//match/" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"transaction_id": ""}'

Response 200:
\- deposit - the deposit row after the match: it now carries the message's originator data, counterparty VASP and rail, and matched_transaction_id points to the message.
\- message - the message row, with matched_transaction_id pointing to the deposit.

Failure modes:
\- 400 - transaction_id is missing, is the deposit itself, is not a received Travel Rule message, or is for a different asset than the deposit; or the transaction in the path is not an inbound deposit.
\- 401 - invalid API key.
\- 403 - the key lacks the transactions privilege.
\- 404 - the deposit or the message does not exist or was deleted.
\- 409 - the deposit no longer waits for originator data, or the message is already matched to a deposit. Nothing changes.

Full guide: /transaction-monitoring/travel-rule.`

\
Incolla in ## Quando usarloUsalo quando un deposito di [depositi non abbinati](https://docs.didit.me/it/management-api/travel-rule/list-unmatched-deposits.md) ha un messaggio Travel Rule ricevuto che gli appartiene e Didit non ha abbinato i due automaticamente. Il deposito assume i dati dell'ordinante del messaggio, il VASP controparte e il canale di pagamento, e su entrambi i trasferimenti la corrispondenza viene registrata nella cronologia.## Richiesta```bash theme={null} curl -X POST "https://verification.didit.me/v3/travel-rule/unmatched/DEPOSIT_TRANSACTION_ID/match/" \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"transaction_id": "MESSAGE_TRANSACTION_ID"}' ```## Note- `transaction_uuid` nel percorso è il deposito. `transaction_id` nel corpo è il messaggio. - Il messaggio deve riguardare lo stesso asset del deposito. - La chiamata restituisce `409` quando uno dei due lati è già avanzato allo stato successivo, e in quel caso non modifica nulla. - Una transazione eliminata dalla Console restituisce `404` su uno dei due lati.## Correlati- [depositi non abbinati](https://docs.didit.me/it/management-api/travel-rule/list-unmatched-deposits.md) - [trasferimenti Travel Rule](https://docs.didit.me/it/management-api/travel-rule/list-transfers.md) - [Travel Rule](https://docs.didit.me/it/transaction-monitoring/travel-rule.md) ## OpenAPI ````yaml it/openapi-25.json POST /v3/travel-rule/unmatched/{transaction_uuid}/match/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API di verifica dell'identità. Autenticati con l'intestazione x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/travel-rule/unmatched/{transaction_uuid}/match/: post: tags: - Travel Rule summary: Abbina un deposito Travel Rule a un messaggio ricevuto description: >- Associa un deposito in entrata ancora in attesa dei dati dell'ordinante al messaggio Travel Rule che il VASP ordinante ha inviato per esso. Il deposito acquisisce i dati dell'ordinante, il VASP di controparte e il canale del messaggio, ed entrambi i trasferimenti registrano la corrispondenza sulle rispettive cronologie. `transaction_uuid` è il `transaction_id` del deposito da `GET /v3/travel-rule/unmatched/`. `transaction_id` nel corpo è il `transaction_id` del messaggio ricevuto, da una riga di `GET /v3/travel-rule/transfers/?kind=message`; l'`id` del trasferimento stesso non viene trovato. Il messaggio deve riguardare lo stesso asset del deposito. Un deposito o un messaggio eliminato dalla Console restituisce `404`; uno che è già avanzato (associato o non più in attesa) restituisce `409`. operationId: matchUnmatchedTravelRuleDeposit parameters: - name: transaction_uuid in: path required: true description: Il `transaction_id` del deposito non abbinato. schema: type: string format: uuid requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TravelRuleManualMatchRequest' example: transaction_id: e90a4d7b-1c2f-4b83-a6d5-8f0e3c1b7a24 responses: '200': description: Entrambi i trasferimenti dopo la corrispondenza. content: application/json: schema: $ref: '#/components/schemas/TravelRuleManualMatchResponse' example: deposit: id: 7d3a1c55-0b9e-4d52-8a3c-1f6e2b9d4a08 transaction_id: c41f9b2e-5a8d-4e0c-9f17-3b6d8a2e5c91 txn_id: dep-2026-10-20-0007 txn_date: '2026-10-19T08:41:12Z' kind: deposit direction: INBOUND status: AWAITING_COUNTERPARTY rail: TRP asset: ETH amount: '1.25' originator_vasp: Example Counterparty VASP beneficiary_vasp: Example Counterparty VASP originator_wallet: '0x77ccff0cc624a53cd8b8d8703ced826710211ec7' beneficiary_wallet: '0xede2d7e4f5b097e6391ab6bbcf2f47a53f4778cb' originator_memo: '' beneficiary_memo: '' originator_wallet_type: vasp beneficiary_wallet_type: vasp matched_transaction_id: e90a4d7b-1c2f-4b83-a6d5-8f0e3c1b7a24 deadline_at: null created_at: '2026-10-19T08:41:13Z' message: id: 2b8e6f10-9c3a-47d1-b5e2-0a4c7d9f3e66 transaction_id: e90a4d7b-1c2f-4b83-a6d5-8f0e3c1b7a24 txn_id: msg-2026-10-20-0003 txn_date: '2026-10-19T08:41:12Z' kind: message direction: INBOUND status: COMPLETED rail: TRP asset: ETH amount: '1.25' originator_vasp: Origin CASP SL beneficiary_vasp: Example Counterparty VASP originator_wallet: '0x77ccff0cc624a53cd8b8d8703ced826710211ec7' beneficiary_wallet: '0xede2d7e4f5b097e6391ab6bbcf2f47a53f4778cb' originator_memo: '' beneficiary_memo: '' originator_wallet_type: vasp beneficiary_wallet_type: vasp matched_transaction_id: null deadline_at: '2026-10-21T08:41:13Z' created_at: '2026-10-19T08:41:13Z' '400': description: >- Errore di validazione: `transaction_id` è mancante, corrisponde al deposito stesso, non è un messaggio Travel Rule ricevuto o si riferisce a un asset diverso rispetto al deposito; oppure la transazione nel percorso non è un deposito in entrata. content: application/json: schema: type: object properties: detail: type: string examples: Error: value: transaction_id: - >- The travel rule message is for a different asset than the deposit. '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': description: >- Deposito o messaggio sconosciuto, oppure uno di essi è stato eliminato. content: application/json: schema: type: object properties: detail: type: string example: detail: No TravelRuleTransfer matches the given query. '409': description: >- Il deposito non è più in attesa dei dati dell'ordinante, oppure il messaggio è già associato a un deposito. content: application/json: schema: type: object properties: detail: type: string examples: Error: value: detail: This deposit is no longer waiting for originator data. security: - ApiKeyAuth: [] x-codeSamples: - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.travel_rule.unmatched_deposits.match( "11111111-2222-3333-4444-555555555555", transaction_id="e90a4d7b-1c2f-4b83-a6d5-8f0e3c1b7a24", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.travelRule.unmatchedDeposits.match("11111111-2222-3333-4444-555555555555", { transaction_id: "e90a4d7b-1c2f-4b83-a6d5-8f0e3c1b7a24", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.TravelRule.UnmatchedDeposits.Match(ctx, \"11111111-2222-3333-4444-555555555555\", didit.TravelRuleManualMatchRequest{\n\tTransactionID: \"e90a4d7b-1c2f-4b83-a6d5-8f0e3c1b7a24\",\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; import me.didit.types.TravelRuleManualMatchRequest; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.travelRule().unmatchedDeposits().match("11111111-2222-3333-4444-555555555555", TravelRuleManualMatchRequest.builder() .transactionId("e90a4d7b-1c2f-4b83-a6d5-8f0e3c1b7a24") .build()); System.out.println(result); - lang: php label: PHP source: >- travelRule->unmatchedDeposits->match('11111111-2222-3333-4444-555555555555', [ 'transaction_id' => 'e90a4d7b-1c2f-4b83-a6d5-8f0e3c1b7a24', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.travel_rule.unmatched_deposits.match( "11111111-2222-3333-4444-555555555555", transaction_id: "e90a4d7b-1c2f-4b83-a6d5-8f0e3c1b7a24" ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.TravelRule.UnmatchedDeposits.MatchAsync("11111111-2222-3333-4444-555555555555", new TravelRuleManualMatchRequest { TransactionId = "e90a4d7b-1c2f-4b83-a6d5-8f0e3c1b7a24", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: TravelRuleManualMatchRequest: type: object required: - transaction_id properties: transaction_id: type: string format: uuid description: >- Il `transaction_id` del messaggio Travel Rule ricevuto (una riga con `kind: message`). TravelRuleManualMatchResponse: type: object required: - deposit - message properties: deposit: $ref: '#/components/schemas/TravelRuleTransferRow' message: $ref: '#/components/schemas/TravelRuleTransferRow' TravelRuleTransferRow: type: object description: >- Un trasferimento Travel Rule così come mostrato nell'elenco dei trasferimenti: solo nomi dei VASP, wallet e memo, mai i dati personali dell'ordinante o del beneficiario. properties: id: type: string format: uuid description: L'id del trasferimento. transaction_id: type: string format: uuid description: La transazione Didit a cui appartiene il trasferimento. txn_id: type: string nullable: true description: >- Il tuo ID per la transazione. I trasferimenti che Didit registra per te, come un trasferimento in entrata di un Test VASP Didit, ne includono uno generato automaticamente. txn_date: type: string format: date-time kind: type: string enum: - withdrawal - deposit - message description: >- withdrawal: in uscita. message: un trasferimento in entrata creato da un rail a partire dal messaggio di una controparte (una richiesta TRP, la tratta in entrata INTERNAL o un messaggio GTR, VerifyVASP o Sygna Bridge). deposit: qualsiasi altro trasferimento in entrata. direction: type: string enum: - INBOUND - OUTBOUND status: type: string enum: - AWAITING_COUNTERPARTY - ON_HOLD - COMPLETED - FINISHED - CANCELLED - EXPIRED - COUNTERPARTY_MISMATCHED_DATA - COUNTERPARTY_VASP_NOT_FOUND - COUNTERPARTY_VASP_NOT_REACHABLE - UNCONFIRMED_OWNERSHIP - COUNTERPARTY_VASP_GENERAL_DECLINE - NOT_ENOUGH_COUNTERPARTY_DATA - NOT_APPLICABLE reason: type: string description: >- Il motivo per cui un trasferimento `COUNTERPARTY_VASP_NOT_FOUND` o `COUNTERPARTY_VASP_NOT_REACHABLE` è bloccato, lo stesso valore di `reason` del trasferimento stesso, così che l'elenco distingua un'email di compliance rimbalzata da una controparte senza rotta senza dover aprire ciascun trasferimento. `""` per qualsiasi altro stato. Consulta [Perché un trasferimento è bloccato](/it/transaction-monitoring/travel-rule#perché-un-trasferimento-è-bloccato). rail: type: string nullable: true enum: - INTERNAL - TRP - GTR - TRUST - VERIFYVASP - SYGNA - EMAIL - TEST_VASP - null asset: type: string description: La valuta della transazione. amount: type: string description: L'importo come valore decimale semplice, ad esempio "1.25". originator_vasp: type: string description: >- In uscita: la ragione sociale del tuo VASP. In entrata: il nome della controparte, dalla relativa voce di directory, dal membro della rete Didit, dal mittente TRP, dal Didit Test VASP o dal nome dichiarato dal trasferimento. Vuoto se non è noto alcun nome. beneficiary_vasp: type: string description: >- In uscita: il nome della controparte, ricavato nello stesso modo. In entrata: la ragione sociale del tuo VASP. originator_wallet: type: string beneficiary_wallet: type: string originator_memo: type: string description: >- Memo o tag di destinazione, vuoto sulle blockchain che non ne prevedono uno. beneficiary_memo: type: string originator_wallet_type: type: string enum: - vasp - self_hosted - own description: >- vasp, self_hosted (dichiarato non custodito) o own (un wallet registrato come tuo nella tua rubrica). La tua parte è sempre vasp. beneficiary_wallet_type: type: string enum: - vasp - self_hosted - own matched_transaction_id: type: string format: uuid nullable: true description: >- La controparte di un deposito associata manualmente a un trasferimento annunciato. deadline_at: type: string format: date-time nullable: true description: >- Quando scade il trasferimento se è ancora in attesa della controparte. Viene impostato su ogni trasferimento creato con `POST /v3/transactions/` che richiede uno scambio, in uscita o in entrata. Null al di sotto della soglia, su un pagamento Lightning a cui non si applica la Travel Rule e sui trasferimenti in entrata creati da Didit quando una controparte ti contatta (un'indagine TRP in entrata, un messaggio di rete o la tratta in entrata INTERNAL). created_at: type: string format: date-time responses: Unauthorized: description: Non autorizzato content: application/json: examples: Invalid API Key: summary: Chiave API non valida value: detail: Invalid API Key. Forbidden: description: Vietato content: application/json: examples: No Permission: summary: Nessuna autorizzazione value: detail: You do not have permission to perform this action. Not Enough Credits: summary: Crediti insufficienti value: error: >- You don't have enough credits to perform this request. Please top up at https://business.didit.me securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.