> ## 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. # API Travel Rule: vincular un dipòsit amb un missatge > Aparella un dipòsit entrant que espera dades de l'ordenant amb el missatge Travel Rule enviat pel VASP d'origen, perquè el dipòsit rebi les seves dades. Didit. Prompt de l'API per a associar un dipòsit de Travel Rule sense coincidència Copia el prompt al porta-retalls \

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

\
Enganxa a ## Quan utilitzar-loUtilitza-la quan un dipòsit de [Llista de dipòsits sense coincidència](https://docs.didit.me/ca/management-api/travel-rule/list-unmatched-deposits.md) tingui un missatge de Travel Rule rebut que li correspongui i Didit no els hagi associat automàticament. El dipòsit pren les dades de l'ordenant del missatge, el VASP de la contrapart i la via, i totes dues transferències registren la coincidència a les seves cronologies.## Sol·licitud```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"}' ```## Notes- `transaction_uuid` al camí és el dipòsit. `transaction_id` al cos és el missatge. - El missatge ha de correspondre al mateix actiu que el dipòsit. - La crida falla amb `409` quan qualsevol de les dues parts ja ha avançat, i no canvia res. - Una transacció eliminada de la Console respon amb `404`, en qualsevol de les dues parts.## Relacionats- [Llista de dipòsits sense coincidència](https://docs.didit.me/ca/management-api/travel-rule/list-unmatched-deposits.md) - [Llista de transferències de Travel Rule](https://docs.didit.me/ca/management-api/travel-rule/list-transfers.md) - [Travel Rule](https://docs.didit.me/ca/transaction-monitoring/travel-rule.md) ## OpenAPI ````yaml ca/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 de verificació d'identitat. Autentica't amb la capçalera x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/travel-rule/unmatched/{transaction_uuid}/match/: post: tags: - Travel Rule summary: Emparella un dipòsit de Travel Rule amb un missatge rebut description: >- Aparella un dipòsit entrant que encara està esperant les dades de l'ordenant amb el missatge de Travel Rule que el VASP ordenant va enviar per a aquest. El dipòsit adopta les dades de l'ordenant, el VASP contrapart i el rail del missatge, i ambdues transferències registren la coincidència a la seva cronologia. `transaction_uuid` és el `transaction_id` del dipòsit de `GET /v3/travel-rule/unmatched/`. El camp `transaction_id` del cos és el `transaction_id` del missatge rebut, obtingut d'una fila de `GET /v3/travel-rule/transfers/?kind=message`; el camp `id` propi de la transferència no es troba. El missatge ha de ser per al mateix actiu que el dipòsit. Si s'elimina un dipòsit o un missatge des de la Consola, es respon amb `404`; un que ja hagi canviat d'estat (aparellat o que ja no estigui en espera) respon amb `409`. operationId: matchUnmatchedTravelRuleDeposit parameters: - name: transaction_uuid in: path required: true description: El `transaction_id` del dipòsit no emparellat. 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: Totes dues transferències després de la coincidència. 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: >- Error de validació: falta `transaction_id`, és el mateix dipòsit, no és un missatge de Travel Rule rebut o és per a un actiu diferent del dipòsit; o la transacció a la ruta no és un dipòsit entrant. 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: Dipòsit o missatge desconegut, o un d'ells s'ha suprimit. content: application/json: schema: type: object properties: detail: type: string example: detail: No TravelRuleTransfer matches the given query. '409': description: >- El dipòsit ja no està esperant dades de l'ordenant, o el missatge ja està associat a un dipòsit. 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: >- El `transaction_id` del missatge de Travel Rule rebut (una fila amb `kind: message`). TravelRuleManualMatchResponse: type: object required: - deposit - message properties: deposit: $ref: '#/components/schemas/TravelRuleTransferRow' message: $ref: '#/components/schemas/TravelRuleTransferRow' TravelRuleTransferRow: type: object description: >- Una transferència de Travel Rule tal com la mostra la llista de transferències: només noms de VASP, carteres i memos, mai les dades personals de l'ordenant o del beneficiari. properties: id: type: string format: uuid description: L'id de la transferència. transaction_id: type: string format: uuid description: La transacció de Didit a la qual pertany la transferència. txn_id: type: string nullable: true description: >- El teu propi identificador per a la transacció. Les transferències que Didit registra per a tu, com ara una transferència entrant de Didit Test VASP, en porten un de generat. txn_date: type: string format: date-time kind: type: string enum: - withdrawal - deposit - message description: >- withdrawal: sortint. message: una transferència entrant que una via ha creat a partir d'un missatge d'una contrapart (una consulta TRP, el tram entrant INTERNAL o un missatge de GTR, VerifyVASP o Sygna Bridge). deposit: qualsevol altra transferència entrant. 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: >- Per què una transferència `COUNTERPARTY_VASP_NOT_FOUND` o `COUNTERPARTY_VASP_NOT_REACHABLE` està encallada, el mateix valor que el `reason` de la pròpia transferència, de manera que la llista distingeix un correu electrònic de compliment rebotat d'una contrapart sense ruta sense obrir cada transferència. `""` per a qualsevol altre estat. Consulta [Per què una transferència està encallada](/ca/transaction-monitoring/travel-rule#per-què-una-transferència-està-bloquejada). rail: type: string nullable: true enum: - INTERNAL - TRP - GTR - TRUST - VERIFYVASP - SYGNA - EMAIL - TEST_VASP - null asset: type: string description: La moneda de la transacció. amount: type: string description: L'import com a decimal simple, per exemple "1.25". originator_vasp: type: string description: >- Sortint: la raó social del teu VASP. Entrant: el nom de la contrapart, a partir de la seva entrada de directori, del membre de la xarxa Didit, del remitent TRP, del Didit Test VASP o del nom declarat a la transferència. Buit quan no se'n coneix cap. beneficiary_vasp: type: string description: >- Sortint: el nom de la contrapart, calculat de la mateixa manera. Entrant: la raó social del teu VASP. originator_wallet: type: string beneficiary_wallet: type: string originator_memo: type: string description: Memo o etiqueta de destinació, buit en cadenes que no en tinguin. beneficiary_memo: type: string originator_wallet_type: type: string enum: - vasp - self_hosted - own description: >- vasp, self_hosted (declarada no allotjada) o own (una cartera que la teva llibreta d'adreces registra com a teva). La teva part sempre és vasp. beneficiary_wallet_type: type: string enum: - vasp - self_hosted - own matched_transaction_id: type: string format: uuid nullable: true description: >- L'altra part d'un dipòsit que has emparellat manualment amb una transferència anunciada. deadline_at: type: string format: date-time nullable: true description: >- Quan caduca la transferència si encara està esperant la contrapart. S'estableix a cada transferència que creïs amb `POST /v3/transactions/` que requereixi un intercanvi, de sortida o d'entrada. És null per sota del llindar, en pagaments de Lightning als quals no s'aplica la Travel Rule i en transferències d'entrada que Didit crea quan una contrapart contacta amb tu (una consulta TRP d'entrada, un missatge de xarxa o el tram d'entrada INTERNAL). created_at: type: string format: date-time responses: Unauthorized: description: No autoritzat content: application/json: examples: Invalid API Key: summary: Clau d'API no vàlida value: detail: Invalid API Key. Forbidden: description: Prohibit content: application/json: examples: No Permission: summary: Sense permís value: detail: You do not have permission to perform this action. Not Enough Credits: summary: No hi ha prou crèdits 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 clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.