> ## 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：メッセージとの紐付け > Diditの本APIは、送金人データ待ちの着金を送金元VASPが送ったトラベルルールメッセージと紐付け、入金に送金人データを反映させます。 未照合のトラベルルール入金を照合するAPIプロンプト プロンプトをクリップボードにコピー \

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

\
貼り付け先 ## 使用するタイミング[未照合の入金を一覧表示](https://docs.didit.me/ja/management-api/travel-rule/list-unmatched-deposits.md)で取得した入金に、その入金に対応する受信済みのトラベルルールメッセージがあり、Diditが両者を自動で紐付けなかった場合に使用します。 入金にはメッセージの送金人データ、取引相手のVASP、レールが反映され、両方の送金のタイムラインに照合が記録されます。## リクエスト```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"}' ```## 注意事項- パスの`transaction_uuid`は入金を指します。ボディの`transaction_id`はメッセージを指します。 - メッセージは入金と同じアセットのものである必要があります。 - いずれかの側がすでに次の状態に進んでいる場合、呼び出しは`409`で失敗し、何も変更されません。 - Consoleから削除された取引は、どちらの側であっても`404`を返します。## 関連情報- [未照合の入金を一覧表示](https://docs.didit.me/ja/management-api/travel-rule/list-unmatched-deposits.md) - [トラベルルール送金を一覧表示](https://docs.didit.me/ja/management-api/travel-rule/list-transfers.md) - [トラベルルール](https://docs.didit.me/ja/transaction-monitoring/travel-rule.md) ## OpenAPI ````yaml ja/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。x-api-keyヘッダーで認証します。 servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/travel-rule/unmatched/{transaction_uuid}/match/: post: tags: - Travel Rule summary: トラベルルールの入金を受信済みメッセージと照合する description: >- 送金人データを待っている受信入金を、送金元VASPがその入金について送信したトラベルルールメッセージと照合します。入金にはメッセージの送金人データ、取引相手VASP、レールが反映され、両方の送金のタイムラインに照合が記録されます。`transaction_uuid`は、`GET /v3/travel-rule/unmatched/`から取得した入金の`transaction_id`です。ボディの`transaction_id`は受信メッセージの`transaction_id`で、`GET /v3/travel-rule/transfers/?kind=message`の行から取得します。送金自体の`id`を指定しても見つかりません。メッセージは入金と同じアセットのものである必要があります。Consoleから削除された入金またはメッセージには`404`が返され、すでに次の状態に進んだもの(照合済み、または待機中でなくなったもの)には`409`が返されます。 operationId: matchUnmatchedTravelRuleDeposit parameters: - name: transaction_uuid in: path required: true description: 未照合の入金の`transaction_id`。 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: 照合後の両方の送金。 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: >- バリデーションエラー: `transaction_id`がない、入金そのものである、受信したトラベルルールメッセージではない、または入金とは異なる資産のものである。あるいは、パス内の取引が受信入金ではありません。 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: 不明なデポジットまたはメッセージ、あるいはそのいずれかが削除されています。 content: application/json: schema: type: object properties: detail: type: string example: detail: No TravelRuleTransfer matches the given query. '409': description: 入金がすでに送金人データを待っていないか、メッセージがすでに入金と照合されています。 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: '受信したトラベルルールメッセージ（`kind: message`の行）の`transaction_id`です。' TravelRuleManualMatchResponse: type: object required: - deposit - message properties: deposit: $ref: '#/components/schemas/TravelRuleTransferRow' message: $ref: '#/components/schemas/TravelRuleTransferRow' TravelRuleTransferRow: type: object description: 送金一覧に表示されるトラベルルールの送金1件。VASP名、ウォレット、メモのみを含み、送金人や受取人の個人データは一切含みません。 properties: id: type: string format: uuid description: 送金のID。 transaction_id: type: string format: uuid description: この送金が属するDiditの取引。 txn_id: type: string nullable: true description: >- この取引に対するお客様独自のIDです。Didit Test VASPからの受信送金など、Diditがお客様に代わって記帳する送金には、生成されたIDが付与されます。 txn_date: type: string format: date-time kind: type: string enum: - withdrawal - deposit - message description: >- withdrawal: 送信。message: 取引相手のメッセージ(TRPの照会、INTERNALの受信レッグ、またはGTR、VerifyVASP、Sygna Bridgeのメッセージ)からレールが作成した受信送金。deposit: その他の受信送金。 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: >- `COUNTERPARTY_VASP_NOT_FOUND`または`COUNTERPARTY_VASP_NOT_REACHABLE`の送金が停止している理由で、送金自体の`reason`と同じ値です。そのため、各送金を開かなくても、一覧上でコンプライアンスメールの不達と、経路のない取引相手とを見分けられます。その他のステータスでは`""`です。[送金が停止する理由](/ja/transaction-monitoring/travel-rule#送金が停止している理由)を参照してください。 rail: type: string nullable: true enum: - INTERNAL - TRP - GTR - TRUST - VERIFYVASP - SYGNA - EMAIL - TEST_VASP - null asset: type: string description: 取引の通貨。 amount: type: string description: '通常の10進数で表した金額（例: "1.25"）。' originator_vasp: type: string description: >- 送信時：自社VASPの正式名称。受信時：取引相手の名称。ディレクトリエントリ、Diditネットワークのメンバー、TRP送信者、Didit Test VASP、または送金で申告された名称から取得します。不明な場合は空です。 beneficiary_vasp: type: string description: 送信時：取引相手の名称（同じ方法で特定されます）。受信時：自社VASPの正式名称。 originator_wallet: type: string beneficiary_wallet: type: string originator_memo: type: string description: メモまたは宛先タグです。これらがないチェーンでは空です。 beneficiary_memo: type: string originator_wallet_type: type: string enum: - vasp - self_hosted - own description: >- vasp、self_hosted(アンホステッドと申告されたもの)、またはown(アドレス帳でお客様のものとして記録されているウォレット)。お客様側は常にvaspです。 beneficiary_wallet_type: type: string enum: - vasp - self_hosted - own matched_transaction_id: type: string format: uuid nullable: true description: 予告済みの送金と手動で照合した入金の相手側。 deadline_at: type: string format: date-time nullable: true description: >- 取引相手の応答をまだ待っている場合に、送金が期限切れになる日時。`POST /v3/transactions/`で作成する送金のうち、送信・受信を問わず情報交換が必要なものすべてに設定されます。しきい値未満の場合、トラベルルールが適用されないLightning決済の場合、および取引相手から連絡があった際にDiditが作成する受信送金（受信TRP照会、ネットワークメッセージ、INTERNALの受信側）の場合はnullです。 created_at: type: string format: date-time responses: Unauthorized: description: 未認証 content: application/json: examples: Invalid API Key: summary: 無効なAPIキー value: detail: Invalid API Key. Forbidden: description: アクセス禁止 content: application/json: examples: No Permission: summary: 権限がありません value: detail: You do not have permission to perform this action. Not Enough Credits: summary: クレジット不足 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: >- お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権（なし、読み取り、書き込み）、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.