> ## 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 Kirim Pesan Travel Rule > Gunakan endpoint ini untuk mengirim pesan atau permintaan dokumen ke VASP pihak lawan dalam transfer Travel Rule di Didit, dengan lampiran opsional. Prompt API untuk Mengirim Pesan Travel Rule Salin prompt ke papan klip \

\`Send a message or a document request to the counterparty VASP of a Travel Rule transfer, so a disputed transfer is resolved inside Didit.

Endpoint:
POST https://verification.didit.me/v3/transactions/{transaction_id}/travel-rule/messages/

Authentication:
Use the x-api-key header with my Didit API key. {transaction_id} is the Didit transaction uuid on my application.

Request body (JSON, or multipart/form-data when attaching files):
\- kind - MESSAGE (default) or DOCUMENT_REQUEST.
\- body - up to 5000 characters. A MESSAGE needs a body or a file.
\- requested_documents - up to 10 names. A DOCUMENT_REQUEST needs at least one; a MESSAGE must not have any.
\- reply_to - uuid of an earlier message of the same transfer. A reply carrying a document fulfils the request it answers.
\- files - multipart only, up to 5 files of 10 MB each.

Example call:
curl -X POST "https://verification.didit.me/v3/transactions/{transaction_id}/travel-rule/messages/" \
-H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"kind": "DOCUMENT_REQUEST", "body": "Please confirm the beneficiary date of birth.", "requested_documents": ["Proof of address"]}'

Behavior:
\- Works on INTERNAL transfers (the other Didit customer sees it on its side) and EMAIL transfers (the counterparty is emailed and answers in the pickup portal).
\- A transfer holds up to 100 messages.

Failure modes:
\- 400 - invalid body, file rejected, 100 messages reached, or reply_to is not a message of this transfer.
\- 404 - unknown transaction, or no Travel Rule transfer on it.
\- 409 - no message can reach the counterparty; detail gives the reason: a network rail (TRP, GTR, TRUST, VerifyVASP, Sygna) carries no messages, no counterparty yet, an INTERNAL transfer whose data did not match the wallet holder, an INTERNAL transfer whose recipient has not proved control of the wallet yet, an EMAIL transfer whose counterparty no longer has a compliance email address, or an EMAIL transfer whose pickup link expired or whose transfer is closed.

Full guide: /transaction-monitoring/travel-rule#messages-and-document-requests.`

\
Tempel ke ## OpenAPI ````yaml id/openapi-25.json POST /v3/transactions/{transaction_id}/travel-rule/messages/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API Verifikasi Identitas. Lakukan autentikasi dengan header x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/transactions/{transaction_id}/travel-rule/messages/: post: tags: - Travel Rule summary: Kirim pesan Travel Rule atau permintaan dokumen description: >- Mengirim pesan atau permintaan dokumen ke VASP pihak lawan. Berfungsi pada transfer INTERNAL (pelanggan Didit lainnya melihatnya di sisi pasangannya) dan transfer EMAIL (pihak lawan menerima email dan menjawab di portal pengambilan). Transfer melalui TRP, GTR, TRUST, VerifyVASP, atau Sygna tidak membawa pesan, karena protokol tersebut tidak memilikinya. Batas: 100 pesan per transfer, 5000 karakter per isi pesan, 10 dokumen yang diminta, 5 file masing-masing 10 MB. operationId: createTravelRuleMessage parameters: - name: transaction_id in: path required: true description: >- UUID transaksi yang stabil dari Didit yang memiliki transfer tersebut. schema: type: string format: uuid requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TravelRuleMessageCreateRequest' example: kind: DOCUMENT_REQUEST body: Please confirm the date of birth of the beneficiary. requested_documents: - Proof of address multipart/form-data: schema: $ref: '#/components/schemas/TravelRuleMessageCreateRequest' responses: '201': description: Pesan yang tersimpan. content: application/json: schema: $ref: '#/components/schemas/TravelRuleMessage' '400': description: >- Body tidak valid, tipe atau ukuran file yang tidak diterima, lebih dari 100 pesan pada transfer, atau `reply_to` yang bukan merupakan pesan dari transfer ini. content: application/json: schema: type: object example: requested_documents: - Name at least one document the counterparty should send. '404': description: >- Transaksi atau token tidak dikenal, atau tidak ada transfer Travel Rule pada transaksi tersebut. '409': description: >- Tidak ada pesan yang dapat mencapai pihak lawan. `detail` memberikan alasannya: transfer berjalan melalui rel jaringan (TRP, GTR, TRUST, VerifyVASP, atau Sygna), transfer belum memiliki pihak lawan, data transfer INTERNAL tidak cocok dengan pemegang dompet sehingga tidak ada yang sampai ke penerima, atau tautan pengambilan transfer EMAIL telah kedaluwarsa atau transfer ditutup. content: application/json: schema: type: object properties: detail: type: string security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X POST https://verification.didit.me/v3/transactions/{transaction_id}/travel-rule/messages/ \ -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \ -d '{"kind": "DOCUMENT_REQUEST", "body": "Please confirm the date of birth of the beneficiary.", "requested_documents": ["Proof of address"]}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.transactions.travel_rule.create_message( "11111111-2222-3333-4444-555555555555", kind="DOCUMENT_REQUEST", body="Please confirm the date of birth of the beneficiary.", requested_documents=["Proof of address"], ) 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.transactions.travelRule.createMessage("11111111-2222-3333-4444-555555555555", { kind: "DOCUMENT_REQUEST", body: "Please confirm the date of birth of the beneficiary.", requested_documents: ["Proof of address"], }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Transactions.TravelRule.CreateMessage(ctx, \"11111111-2222-3333-4444-555555555555\", didit.TravelRuleMessageCreateRequest{\n\tKind: didit.Some(didit.TravelRuleMessageCreateRequestKind(\"DOCUMENT_REQUEST\")),\n\tBody: didit.String(\"Please confirm the date of birth of the beneficiary.\"),\n\tRequestedDocuments: didit.Some([]string{\"Proof of address\"}),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import java.util.List; import me.didit.Didit; import me.didit.types.TravelRuleMessageCreateRequest; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.transactions().travelRule().createMessage("11111111-2222-3333-4444-555555555555", TravelRuleMessageCreateRequest.builder() .kind(TravelRuleMessageCreateRequest.Kind.of("DOCUMENT_REQUEST")) .body("Please confirm the date of birth of the beneficiary.") .requestedDocuments(List.of("Proof of address")) .build()); System.out.println(result); - lang: php label: PHP source: >- transactions->travelRule->createMessage('11111111-2222-3333-4444-555555555555', [ 'kind' => 'DOCUMENT_REQUEST', 'body' => 'Please confirm the date of birth of the beneficiary.', 'requested_documents' => ['Proof of address'], ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.transactions.travel_rule.create_message( "11111111-2222-3333-4444-555555555555", kind: "DOCUMENT_REQUEST", body: "Please confirm the date of birth of the beneficiary.", requested_documents: ["Proof of address"] ) 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.Transactions.TravelRule.CreateMessageAsync("11111111-2222-3333-4444-555555555555", new TravelRuleMessageCreateRequest { Kind = new TravelRuleMessageCreateRequestKind("DOCUMENT_REQUEST"), Body = "Please confirm the date of birth of the beneficiary.", RequestedDocuments = new string[] { "Proof of address" }, }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: TravelRuleMessageCreateRequest: type: object description: >- Kirim sebagai JSON, atau sebagai multipart/form-data dengan lampiran di `files`. properties: kind: type: string enum: - MESSAGE - DOCUMENT_REQUEST default: MESSAGE body: type: string maxLength: 5000 description: Wajib untuk MESSAGE kecuali jika file dilampirkan. requested_documents: type: array items: type: string maxLength: 255 maxItems: 10 description: >- Wajib (setidaknya satu) untuk DOCUMENT_REQUEST, dan hanya diizinkan di sana. reply_to: type: string format: uuid nullable: true description: >- Pesan dari transfer yang sama. Balasan yang menyertakan dokumen memenuhi permintaan dokumen yang dijawabnya. files: type: array items: type: string format: binary maxItems: 5 description: Hanya multipart. Hingga 5 file masing-masing berukuran 10 MB. TravelRuleMessage: type: object properties: id: type: string format: uuid kind: type: string enum: - MESSAGE - DOCUMENT_REQUEST direction: type: string enum: - INBOUND - OUTBOUND description: >- `OUTBOUND` adalah apa yang dikirim oleh pihak pembaca sendiri. Di portal penjemputan, arahnya adalah dari pihak lawan. author: type: string description: >- Pihak yang menulisnya dari pihaknya sendiri: email pengguna konsol atau label kunci API, atau nama VASP lainnya. body: type: string requested_documents: type: array items: type: string description: Apa yang diminta oleh DOCUMENT_REQUEST, dalam kata-kata pemohon. reply_to: type: string format: uuid nullable: true fulfilled_at: type: string format: date-time nullable: true description: >- Ditetapkan pada DOCUMENT_REQUEST setelah balasan untuknya membawa dokumen. attachment: $ref: '#/components/schemas/TravelRuleMessageAttachment' created_at: type: string format: date-time TravelRuleMessageAttachment: type: object nullable: true description: >- Dokumen yang dilampirkan ke pesan, disimpan seperti dokumen transaksi lainnya. properties: uuid: type: string format: uuid label: type: string nullable: true note: type: string nullable: true uploaded_by: type: string nullable: true description: >- Pihak yang melampirkannya. Di portal pengambilan, file yang Anda kirim menampilkan nama VASP Anda, tidak pernah menampilkan orang atau kunci API di baliknya. created_at: type: string format: date-time files: type: array items: type: object properties: uuid: type: string format: uuid file_url: type: string nullable: true description: URL unduhan dengan batas waktu. original_filename: type: string file_size: type: integer securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.