> ## 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. # Konfirmasi Kepemilikan Dompet API: Penerima Travel Rule > Konfirmasi atau tolak bahwa pelanggan Anda memiliki dompet penerima transfer Travel Rule masuk yang menunggu di UNCONFIRMED_OWNERSHIP di Didit. Prompt API Konfirmasi Kepemilikan Dompet Salin prompt ke papan klip \

\`Confirm or deny wallet ownership on a Travel Rule transfer waiting on the beneficiary side - typically the beneficiary leg of an INTERNAL-rail transfer whose wallet address book entry has not been ownership-verified yet, a transfer whose counterparty wallet was declared self-hosted (counterparty.payment_method.method_type: "unhosted_wallet"), an inbound transfer in ON_HOLD, or an inbound TRP inquiry a compliance officer resolves by hand.

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

Authentication:
Use the x-api-key header with my Didit API key. {transaction_id} is the Didit transaction uuid of the transfer your own application holds: on an INTERNAL-rail transfer that is your (beneficiary) side; on a declared self-hosted wallet it is the transaction you created, outbound or inbound.

Request body:
\{"confirmed": true}   or   {"confirmed": false}
Optionally {"confirmed": true, "wallet_address": "0x..."} - the payment address to return to the counterparty on an inbound TRP transfer.
On a declared self-hosted wallet transfer with no counterparty wallet on it, "wallet_address" supplies the wallet to verify; if neither the transfer nor the request names one, the request is rejected with 400.

Accepted states (anything else -> 409 "Transfer is not awaiting ownership confirmation."):
\- UNCONFIRMED_OWNERSHIP, in either direction.
\- ON_HOLD on an inbound transfer.
\- UNCONFIRMED_OWNERSHIP, ON_HOLD or COUNTERPARTY_MISMATCHED_DATA on an inbound TRP transfer.

Behavior on a transfer Didit created itself (INTERNAL rail, sunrise registration, declared self-hosted wallet):
\- confirmed: true - marks the matching wallet address book entry ownership-verified, then runs the beneficiary name match on both sides: COMPLETED on a pass, COUNTERPARTY_MISMATCHED_DATA on a fail.
An inbound transfer whose deposit already settled then moves on to FINISHED.
\- confirmed: true on a declared self-hosted wallet - records that the customer verified who controls the counterparty wallet and completes the transfer (COMPLETED), outbound or inbound; an inbound deposit whose on-chain hash is already known moves on to FINISHED. The wallet is the counterparty's: the destination of a withdrawal, the originator's source wallet of a deposit. If it is not in the wallet address book yet, it is added as ownership-verified under the counterparty's name; if the book already holds it under a different holder name, the transfer goes to COUNTERPARTY_MISMATCHED_DATA.
\- confirmed: false - moves both sides of the transfer to COUNTERPARTY_VASP_GENERAL_DECLINE.
\- Resolving an inbound ON_HOLD with no matching entry, or confirming a declared self-hosted wallet, creates the entry from the transfer's wallet address and marks it verified.

Behavior on an inbound TRP transfer (answering the counterparty's inquiry):
\- confirmed: true - needs a payment address, taken from the request's wallet_address, then the matched entry, then beneficiary_data.wallet_address.
Didit creates or verifies the entry, posts the inquiry-resolution callback to the counterparty, sets ownership_confirmed and moves the transfer to COMPLETED.
\- confirmed: false - posts a declined resolution and moves the transfer to COUNTERPARTY_VASP_GENERAL_DECLINE.

Transfers a network delivered (GTR or Sygna Bridge):
\- An inbound transfer that waits for your review (UNCONFIRMED_OWNERSHIP, ON_HOLD or COUNTERPARTY_MISMATCHED_DATA) is decided here: confirmed: true approves it (send wallet_address when the transfer names none), confirmed: false declines it. Didit answers the network after the response, with retries; the response's delivery field shows that answer.
\- VerifyVASP takes its answer when it asks, so a VerifyVASP transfer that would need your review is declined at once and cannot be decided here.
\- Receiving over a network is switched on by Didit per network, and none is switched on today.

What to read from the response:
\- The full transfer object. originator_data/beneficiary_data stay masked on inbound transfers (data_masked: true) until ownership is confirmed; data_unmasked then records when, why and by whom. data_match and mismatched_fields name the fields that differ after a mismatch.

Alternative: instead of this API call, send the end customer through the hosted wallet-ownership widget (POST /v3/travel-rule/widget-session/) and let them prove control cryptographically.

Failure modes:
\- 400 - on an inbound TRP approval with no payment address available: {"wallet_address": ["wallet_address is required to approve."]}.
\- 409 - the transfer is not in one of the accepted states, no entry in your wallet address book matches the transfer's wallet address (an inbound TRP approval, and an inbound ON_HOLD transfer that carries beneficiary_data.wallet_address, and a declared self-hosted wallet, create the missing entry instead), an INTERNAL transfer from another Didit customer needs a control proof (signed message or test deposit) first, or a network transfer was already answered over its network (a VerifyVASP transfer, or a GTR or Sygna Bridge transfer already decided).
\- 502 - the counterparty's TRP inquiry-resolution callback could not be delivered; the transfer keeps its current status.
\- 404 - unknown transaction or no Travel Rule transfer attached.

Full guide: /transaction-monitoring/travel-rule#confirming-wallet-ownership.`

\
Tempel ke ## Dompet swakelolaKetika dompet pihak lawan dinyatakan swakelola (`counterparty.payment_method.method_type: "unhosted_wallet"`), transfer menunggu di `UNCONFIRMED_OWNERSHIP`. Memanggil endpoint ini dengan `confirmed: true` mencatat bahwa pelanggan Anda telah memverifikasi siapa yang mengendalikan dompet tersebut, lalu transfer diselesaikan (`COMPLETED`), baik untuk penarikan keluar maupun setoran masuk. Setoran masuk yang hash on-chain-nya sudah diketahui akan beralih ke `FINISHED`.Dompet yang diverifikasi adalah milik pihak lawan: tujuan penarikan keluar, atau sumber (dompet pengirim) pada setoran masuk. Didit menambahkannya ke buku alamat dompet dengan status kepemilikan terverifikasi atas nama pihak lawan, sehingga dompet tersebut dicocokkan dengan nama pihak lawan (pengirim, untuk setoran masuk). Jika buku alamat sudah memuat dompet tersebut dengan nama pemegang yang berbeda, transfer beralih ke `COUNTERPARTY_MISMATCHED_DATA` sebagai gantinya.Jika transfer tidak menyebutkan dompet pihak lawan sama sekali, sertakan `wallet_address` di badan permintaan. Jika tidak ada alamat dompet yang diberikan, baik oleh transfer maupun oleh permintaan, permintaan ditolak dengan `400`.`confirmed: false` menolak transfer (`COUNTERPARTY_VASP_GENERAL_DECLINE`). ## OpenAPI ````yaml id/openapi-25.json POST /v3/transactions/{transaction_id}/travel-rule/ownership/ 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/ownership/: post: tags: - Travel Rule summary: Konfirmasi atau tolak kepemilikan dompet description: >- Selesaikan transfer yang menunggu kepemilikan dompet: panggil ini pada sisi transfer Anda sendiri saat statusnya UNCONFIRMED_OWNERSHIP, atau saat statusnya adalah transfer masuk dalam ON_HOLD. Mengonfirmasi akan menandai entri buku alamat dompet yang cocok sebagai terverifikasi kepemilikannya (untuk transfer masuk ON_HOLD tanpa entri, Didit membuat entri dari beneficiary_data.wallet_address) dan menjalankan pencocokan nama penerima di kedua sisi transfer; menolak akan menolak kedua sisi. Transfer masuk yang depositnya telah selesai akan berpindah ke FINISHED saat pencocokan berhasil. Ketika dompet pihak lawan dinyatakan sebagai dompet swakelola (counterparty.payment_method.method_type: unhosted_wallet), mengonfirmasi akan mencatat bahwa pelanggan memverifikasi siapa yang mengontrol dompet tersebut dan menyelesaikan transfer (COMPLETED) di kedua arah, atau FINISHED untuk deposit masuk yang hash on-chain-nya sudah diketahui. Dompet yang diverifikasi adalah milik pihak lawan: tujuan penarikan keluar, atau sumber (dompet pengirim) deposit masuk. Jika belum ada di buku alamat dompet Anda, Didit menambahkannya sebagai terverifikasi kepemilikannya di bawah nama pihak lawan; jika buku alamat telah menyimpannya dengan nama pemegang yang berbeda, transfer akan berpindah ke COUNTERPARTY_MISMATCHED_DATA. Untuk transfer TRP masuk dalam status UNCONFIRMED_OWNERSHIP, ON_HOLD, atau COUNTERPARTY_MISMATCHED_DATA, Didit mengirimkan keputusan Anda ke VASP pengirim: menyetujui akan mengembalikan alamat pembayaran (wallet_address, atau alamat entri yang cocok) dan memindahkan transfer ke COMPLETED, dan menolak akan menolaknya. Panggilan yang sama juga memutuskan transfer masuk yang dikirim oleh pihak lawan GTR atau Sygna Bridge dan menunggu peninjauan Anda (`UNCONFIRMED_OWNERSHIP`, `ON_HOLD`, atau `COUNTERPARTY_MISMATCHED_DATA`): `confirmed: true` menyetujuinya (sampaikan `wallet_address` ketika transfer tidak mencantumkan alamat dompet) dan `confirmed: false` menolaknya, dan jawaban akan dikirimkan ke jaringan setelah respons diberikan, dengan coba lagi. VerifyVASP mengambil jawabannya saat bertanya, sehingga transfer VerifyVASP yang memerlukan peninjauan Anda akan langsung ditolak dan tidak dapat diputuskan nanti. operationId: confirmTravelRuleOwnership parameters: - name: transaction_id in: path required: true description: >- UUID stabil dari Didit untuk transaksi yang disimpan aplikasi Anda untuk transfer ini: transaksi sisi penerima pada transfer jalur INTERNAL, atau transaksi yang Anda buat (keluar atau masuk) ketika dompet pihak lawan dinyatakan swakelola. schema: type: string format: uuid requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TravelRuleOwnershipConfirmRequest' example: confirmed: true responses: '200': description: >- Transfer yang diperbarui. Untuk transfer masuk, originator_data/beneficiary_data milik pihak lawan tetap disamarkan (`data_masked: true`) hingga kepemilikan dikonfirmasi, kemudian `data_unmasked` mencatat kapan, mengapa, dan oleh siapa. content: application/json: schema: $ref: '#/components/schemas/TravelRuleTransferDetail' '400': description: >- Kesalahan validasi: confirmed tidak ada, persetujuan TRP masuk tidak memiliki wallet_address dan tidak ada alamat cadangan, atau `confirmed: true` pada transfer dompet swakelola yang dideklarasikan yang tidak menyebutkan dompet pihak lawan dan tidak ada `wallet_address` yang dikirimkan. content: application/json: examples: No payment address: value: wallet_address: - wallet_address is required to approve. '404': description: >- Transaksi tidak dikenal, atau transaksi tidak memiliki transfer Travel Rule. '409': description: >- Transfer tidak sedang menunggu konfirmasi kepemilikan, tidak ada entri buku alamat dompet yang cocok dengan dompet pihak lawan, transfer INTERNAL dari pelanggan Didit lain memerlukan bukti kontrol (pesan bertanda tangan atau deposit uji) sebelum dapat dikonfirmasi, atau transfer jaringan sudah dijawab melalui jaringannya (transfer VerifyVASP, atau transfer GTR atau Sygna Bridge yang sudah Anda atau Didit putuskan). content: application/json: examples: Not awaiting confirmation: value: detail: Transfer is not awaiting ownership confirmation. No matching address book entry: value: detail: wallet address entry no longer available '502': description: >- Hanya transfer TRP masuk: Didit tidak dapat mengirimkan keputusan Anda ke VASP pengirim, sehingga status transfer tidak berubah. content: application/json: examples: Callback not delivered: value: detail: >- Counterparty inquiry-resolution callback could not be delivered. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X POST https://verification.didit.me/v3/transactions/{transaction_id}/travel-rule/ownership/ \ -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \ -d '{"confirmed": true}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.transactions.travel_rule.confirm_ownership( "11111111-2222-3333-4444-555555555555", confirmed=True, ) 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.confirmOwnership("11111111-2222-3333-4444-555555555555", { confirmed: true, }); 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.ConfirmOwnership(ctx, \"11111111-2222-3333-4444-555555555555\", didit.TravelRuleOwnershipConfirmRequest{\n\tConfirmed: true,\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.TravelRuleOwnershipConfirmRequest; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.transactions().travelRule().confirmOwnership("11111111-2222-3333-4444-555555555555", TravelRuleOwnershipConfirmRequest.builder() .confirmed(true) .build()); System.out.println(result); - lang: php label: PHP source: >- transactions->travelRule->confirmOwnership('11111111-2222-3333-4444-555555555555', [ 'confirmed' => true, ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.transactions.travel_rule.confirm_ownership( "11111111-2222-3333-4444-555555555555", confirmed: true ) 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.ConfirmOwnershipAsync("11111111-2222-3333-4444-555555555555", new TravelRuleOwnershipConfirmRequest { Confirmed = true, }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: TravelRuleOwnershipConfirmRequest: type: object required: - confirmed properties: confirmed: type: boolean description: true untuk mengonfirmasi kepemilikan, false untuk menolaknya. wallet_address: type: string default: '' description: >- Transfer TRP masuk: alamat pembayaran yang dikembalikan Didit ke VASP pengirim saat Anda menyetujuinya. Default-nya adalah alamat entri buku alamat yang cocok, lalu beneficiary_data.wallet_address. Pada transfer dompet swakelola yang dideklarasikan yang tidak menyebutkan dompet pihak lawan, dompet yang kepemilikannya Anda verifikasi; tanpanya permintaan ditolak dengan 400. Diabaikan untuk transfer lainnya. TravelRuleTransferDetail: type: object description: >- Objek transfer lengkap yang dikembalikan oleh endpoint konfirmasi kepemilikan dan penyelesaian/pembatalan. Selama kepemilikan dompet transfer masuk belum dikonfirmasi, `originator_data` dan `beneficiary_data` pihak lawan akan dikembalikan dalam kondisi disamarkan (huruf pertama dari setiap kata dipertahankan; dompet, blockchain, dan perutean VASP tetap dapat dibaca) dan `data_masked` bernilai true. properties: uuid: type: string format: uuid 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 direction: type: string enum: - INBOUND - OUTBOUND rail: type: string nullable: true enum: - INTERNAL - TRP - GTR - TRUST - VERIFYVASP - SYGNA - EMAIL - TEST_VASP - null description: >- Jalur yang digunakan untuk merutekan transfer, atau null ketika tidak ada jalur yang dipilih (misalnya di bawah ambang batas, dompet pihak lawan swakelola, registrasi setelah deposit, atau tidak ada pihak lawan yang dapat dijangkau). INTERNAL berarti kedua belah pihak adalah aplikasi Didit; EMAIL berarti pihak lawan dijangkau melalui tautan pengambilan yang dikirim lewat email. TEST_VASP berarti Test VASP Didit merespons transfer sandbox. Melalui GTR, VERIFYVASP, dan SYGNA, Didit membaca jawaban pihak lawan dari respons jaringan atau dengan melakukan polling setiap 5 menit. TRUST hanya mengirim, sehingga transfer TRUST tetap berstatus AWAITING_COUNTERPARTY hingga kedaluwarsa. Jalur jaringan hanya digunakan ketika Anda telah menghubungkan keanggotaan Anda sendiri untuk jaringan tersebut. Jalur dipilih setelah pembuatan transaksi menghasilkan respons, sehingga nilainya null dalam respons tersebut. protocol: type: string nullable: true ivms_version: type: string example: ivms101.2023 required: type: boolean ownership_confirmed: type: boolean nullable: true deadline_at: type: string format: date-time nullable: true timeline: type: array items: type: object properties: status: type: string at: type: string format: date-time detail: type: string name_match: allOf: - $ref: '#/components/schemas/TravelRuleNameMatch' nullable: true description: >- Perbandingan nama yang diputuskan oleh entri ini, di samping `detail`. Tidak ada pada entri yang tidak membandingkan nama. reason: type: string description: >- Hadir hanya pada entri transisi yang disebabkan oleh pengiriman yang gagal: `email_undeliverable` atau `delivery_failed`, nilai yang dilaporkan oleh `reason` transfer. counterparty_vasp: type: object nullable: true properties: name: type: string lei: type: string dd_score: type: integer description: >- Skor uji tuntas dari 0 hingga 100, dengan nilai lebih tinggi lebih baik. Skala yang sama seperti dalam direktori VASP. dd_score_breakdown: type: object description: >- Kontribusi per komponen ke dd_score, satu objek per komponen seperti di direktori VASP (jurisdiction, verification, protocol, lei, history, essentials, responsiveness), masing-masing {points, max, reason, detail}. {} sampai pihak lawan telah dinilai. additionalProperties: type: object properties: points: type: number description: Poin yang diberikan untuk komponen ini. max: type: integer description: Poin maksimum yang dapat diberikan komponen ini. reason: type: string description: Kode yang dapat dibaca mesin untuk keputusan komponen. detail: type: string description: Alasan yang dapat dibaca manusia atas poin yang diberikan. dd_assessed_at: type: string format: date-time nullable: true description: >- Waktu ketika penilaian uji tuntas terakhir kali dijalankan. Null hingga pihak lawan telah dinilai. originator_data: type: object description: >- Pihak pengirim. Untuk transfer masuk, nilai pihak lawan disamarkan sampai kepemilikan dikonfirmasi. beneficiary_data: type: object description: >- Pihak penerima. Untuk transfer masuk, nilai pihak lawan disamarkan hingga kepemilikan dikonfirmasi. name_match: allOf: - $ref: '#/components/schemas/TravelRuleNameMatch' nullable: true description: >- Perbandingan nama yang menentukan transfer, atau null hingga perbandingan dijalankan. Saat para pihak disamarkan, dan pada salinan pertukaran INTERNAL milik pelanggan lain, `transfer_name`, `compared_name`, `matched_names`, dan `mismatched_names` disembunyikan. `score` dan `matched` bisa tidak sejalan: `matched` mengikuti tingkat ketatnya, sedangkan `score` adalah kesamaan dari kedua nama lengkap tersebut. data_match: $ref: '#/components/schemas/TravelRuleDataMatch' mismatched_fields: type: array items: type: string description: >- Pintasan untuk `data_match.mismatched_fields`. Kosong jika tidak ada perbedaan. data_unmasked: $ref: '#/components/schemas/TravelRuleDataUnmasked' data_masked: type: boolean description: True selama data pribadi pihak lawan disamarkan dalam respons ini. created_at: type: string format: date-time delivery: nullable: true allOf: - $ref: '#/components/schemas/TravelRuleDelivery' description: >- Status pesan terbaru yang harus dikirimkan transfer ini ke pihak lain. Bernilai null jika transfer tidak pernah diharuskan mengirimkannya (misalnya di bawah `threshold_amount`, dompet swakelola yang dideklarasikan, atau registrasi sunrise). discovery: type: array description: >- Cara Didit mencari pihak lawan, satu entri per langkah yang dijalankan. Kosong jika tidak ada penemuan yang dijalankan, misalnya pada transfer masuk. items: $ref: '#/components/schemas/TravelRuleDiscoveryStep' reason: type: string description: >- Alasan transfer `COUNTERPARTY_VASP_NOT_FOUND` atau `COUNTERPARTY_VASP_NOT_REACHABLE` tertahan; `""` untuk status lainnya. Pengiriman yang gagal menentukannya terlebih dahulu, hanya pada `COUNTERPARTY_VASP_NOT_REACHABLE`: `email_undeliverable` (penyedia email menolak email kepatuhan dan tidak ada alamat tersisa untuk dicoba: saat dikirim, pada pengingat, atau sebagai pantulan permanen yang dilaporkan kemudian) atau `delivery_failed` (jalur pengiriman gagal total: jalur jaringan menolak pesan atau kehabisan percobaan coba lagi, host identitas `TRP` tidak menjawab, atau host `TRP` pihak lawan tidak menerima permintaan informasi). Jika tidak, jejak `discovery` yang menentukannya: `awaiting_end_user` (tidak ada langkah yang menyebutkan pihak lawan yang dapat dijangkau Didit), `directory_match_no_route` (suatu langkah menyebutkan VASP direktori yang tidak memiliki rute), `picked_member_without_proven_wallet` (pengguna akhir memilih pelanggan Didit yang belum membuktikan kendali atas dompet), atau `no_directory_match` saat jejak tidak memberikan alasan lain. Pengiriman ulang akan memajukan transfer, sehingga alasannya dihapus. Lihat [Mengapa transfer tertahan](/id/transaction-monitoring/travel-rule#mengapa-transfer-macet). next_actions: type: array description: >- Apa yang melanjutkan transfer; `[]` untuk status apa pun selain `COUNTERPARTY_VASP_NOT_FOUND` atau `COUNTERPARTY_VASP_NOT_REACHABLE`. `email_undeliverable` menawarkan `update_compliance_email`, lalu `resend`. `delivery_failed` menawarkan `resend`. Alasan penemuan menawarkan `select_counterparty_vasp`, `declare_self_hosted`, `add_vasp_hint`, dan `resend`. items: $ref: '#/components/schemas/TravelRuleNextAction' chain_details: $ref: '#/components/schemas/TravelRuleChainDetails' TravelRuleNameMatch: type: object nullable: true description: >- Perbandingan nama yang menentukan transfer, atau null hingga perbandingan dijalankan. Saat para pihak disamarkan, dan pada salinan pertukaran INTERNAL milik pelanggan lain, `transfer_name`, `compared_name`, `matched_names`, dan `mismatched_names` disembunyikan. `score` dan `matched` bisa tidak sejalan: `matched` mengikuti tingkat ketatnya, sedangkan `score` adalah kesamaan dari kedua nama lengkap tersebut. properties: score: type: integer minimum: 0 maximum: 100 description: >- Kemiripan antara kedua nama lengkap, 0 hingga 100. Bernilai 0 jika salah satu nama kosong. matched: type: boolean description: >- Apakah nama-nama tersebut memenuhi `strictness`. Hasil transfer mengikuti `data_match`, yang membandingkan setiap kolom, sehingga transfer dapat berstatus COUNTERPARTY_MISMATCHED_DATA meskipun ini bernilai true. method: type: string enum: - none - exact_token - token_subset - token_containment - sequence_ratio description: >- Cara `matched` ditentukan: none (`NONE`), exact_token (`STRICT`), token_subset (`DEFAULT`), token_containment (`CONTAINS`), atau sequence_ratio (`FUZZY`). strictness: type: string enum: - NONE - STRICT - CONTAINS - DEFAULT - FUZZY compared_with: type: string enum: - wallet_holder - counterparty_vasp description: >- wallet_holder: pemegang yang tercatat untuk dompet tersebut. counterparty_vasp: nama yang diberikan pihak lawan di halaman respons email, atau jawaban Didit Test VASP di sandbox. transfer_name: type: string description: Nama pada transfer. compared_name: type: string description: Nama yang dibandingkan dengannya. matched_names: type: array items: type: string description: Kata-kata dari `transfer_name` yang ditemukan di `compared_name`. mismatched_names: type: array items: type: string description: >- Kata-kata dari `transfer_name` yang tidak ditemukan di `compared_name`, lalu kata-kata dari `compared_name` yang tidak ditemukan di `transfer_name`. TravelRuleDataMatch: type: object nullable: true description: >- Perbandingan kolom demi kolom antara data pihak transfer dan apa yang diketahui pihak lain tentang pemegang dompet. Ini menyebutkan kolom dan hasil, tidak pernah nilai, sehingga tetap dapat dibaca sementara data pihak lawan disamarkan. Bernilai null sampai perbandingan dijalankan. properties: matched: type: boolean description: True saat tidak ada kolom yang dibandingkan yang berbeda. mismatched_fields: type: array items: type: string enum: - name - date_of_birth - address - account description: Kolom yang berbeda. fields: type: object description: >- Satu entri per kolom yang dibandingkan untuk tipe entitas pihak tersebut (`name`, `date_of_birth`, `address`, `account`; perusahaan tidak memiliki `date_of_birth`). additionalProperties: type: object properties: result: type: string enum: - matched - mismatched - not_compared description: >- `not_compared` saat aturan bernilai `NONE` atau salah satu pihak tidak memiliki nilai untuk kolom tersebut. strictness: type: string enum: - NONE - STRICT - CONTAINS - DEFAULT - FUZZY TravelRuleDataUnmasked: type: object nullable: true description: >- Catatan audit saat data pihak lawan dibuka penyamarannya. Bernilai null selama data masih disamarkan, dan untuk transfer keluar. properties: at: type: string format: date-time reason: type: string enum: - ownership_confirmed - wallet_proof - address_book_match - own_verified_wallet - inquiry_approved - known_payment_method - travel_address description: >- Hal yang mengonfirmasi kepemilikan: ownership_confirmed (konfirmasi Anda melalui konsol atau API), wallet_proof (bukti dompet di widget, atau transfer masuk INTERNAL, ditetapkan saat dibuat), address_book_match (dompet di buku alamat yang terverifikasi), own_verified_wallet (dompet terverifikasi milik pengguna Anda sendiri), inquiry_approved (persetujuan Anda atas permintaan masuk TRP atau pesan GTR atau Sygna), known_payment_method (dompet yang sudah digunakan pengguna Anda untuk membayar) atau travel_address (Travel Address per dompet mencantumkan dompet tersebut). actor: type: string description: >- Pihak yang mengonfirmasinya: email pengguna konsol atau label kunci API. Kosong untuk keputusan otomatis. TravelRuleDelivery: type: object description: >- Status pesan terbaru yang harus dikirimkan transfer ke pihak lain. Didit menghubungi pihak lawan setelah permintaan yang membuat atau mengubah transfer dikembalikan, sehingga objek ini menunjukkan apakah pesan tersebut berhasil terkirim: queued, being sent, waiting to be retried after an error, delivered, atau failed. Kegagalan yang masih dapat dipulihkan oleh jaringan (tidak ada jawaban tepat waktu, koneksi gagal, HTTP `408`, `429`, atau `5xx`) akan dicoba lagi setelah 30 detik, 2 menit, 10 menit, 30 menit, dan 1 jam. Saat pesan pertama (`kind: SEND`) gagal permanen, baik karena jaringan menolaknya atau percobaan keenam juga gagal, transfer berpindah ke `COUNTERPARTY_VASP_NOT_REACHABLE` dengan `last_error` di `timeline`-nya; pesan lain yang gagal permanen akan dicatat di `timeline`. `status` transfer tetap menjadi sumber kebenaran tunggal untuk pertukaran itu sendiri. required: - kind - status - rail - attempts - last_error - next_attempt_at - delivered_at properties: kind: type: string enum: - SEND - ANSWER - TXID - CANCEL - POLL description: >- Apa yang dibawa pesan. `SEND`: pesan pertama transfer ke pihak lawan (keluar; jalur pembayaran dipilih saat dikirim). `ANSWER`: persetujuan atau penolakan Anda, yang harus diberikan ke jaringan yang meminta (masuk). `TXID`: hash transaksi on-chain, setelah Anda menyelesaikan transfer. `CANCEL`: pembatalan, setelah Anda membatalkannya. `POLL`: kueri status ke jaringan yang menawarkannya, diulang setiap 5 menit saat transfer menunggu pihak lawan. status: type: string enum: - QUEUED - SENDING - RETRYING - DELIVERED - FAILED description: >- `QUEUED`: menunggu untuk dikirim. `SENDING`: percobaan sedang berjalan. `RETRYING`: percobaan gagal dan percobaan berikutnya berjalan pada `next_attempt_at`. `DELIVERED`: pihak lain menerima pesan. `FAILED`: pihak lain menolaknya, atau percobaan terakhir gagal. rail: type: string enum: - INTERNAL - TRP - GTR - TRUST - VERIFYVASP - SYGNA - EMAIL - '' description: >- Jalur yang membawa pesan. Kosong hingga Didit memilih salah satu untuk pesan pertama. attempts: type: integer minimum: 0 description: >- Percobaan yang dilakukan sejauh ini untuk pesan ini. Pesan yang bukan polling status dicoba paling banyak 6 kali. last_error: type: string description: >- Jenis kegagalan yang dialami pada upaya terakhir, `""` jika tidak ada: misalnya `email undeliverable`, `trp identity endpoint unreachable`, atau `trp transfer inquiry delivery failed`. Kolom ini tidak pernah membawa jawaban pihak lawan itu sendiri, yang tetap berada di `timeline` transfer. Ketika GTR merespons dengan kesalahan, kode status dan pesannya sendiri disertakan. Isi respons tidak pernah disertakan. example: email undeliverable next_attempt_at: type: string format: date-time nullable: true description: >- Waktu upaya berikutnya dijalankan saat pesan berstatus `QUEUED` atau `RETRYING`. delivered_at: type: string format: date-time nullable: true description: Waktu pihak lain menerima pesan. TravelRuleDiscoveryStep: type: object description: >- Satu langkah penemuan pihak lawan yang dijalankan Didit untuk transfer keluar, sesuai urutan eksekusinya. Langkah pertama yang menyebutkan VASP dengan rute akan mengakhiri rantai tersebut. properties: step: type: string enum: - internal_address_book - wallet_attribution - network_lookup - customer_hint - end_user description: >- `internal_address_book`: pelanggan Didit lain yang membuktikan kontrol atas dompet tujuan. `wallet_attribution`: atribusi analitik blockchain dompet tersebut. `network_lookup`: jaringan yang dapat menyatakan VASP mana yang memegang alamat tersebut. `customer_hint`: nama VASP, LEI, atau yurisdiksi yang Anda kirimkan di `beneficiary_data`. `end_user`: pihak lawan yang dipilih oleh pengguna akhir (atau Anda), atau permintaan untuk memilih salah satunya. outcome: type: string enum: - match - miss - skipped description: >- `match`: langkah tersebut menyebutkan pihak lawan. `miss`: langkah berjalan dan tidak menemukan apa pun. `skipped`: langkah tidak dapat berjalan, dan `reason` menjelaskan alasannya. reason: type: string description: >- Alasan yang dapat dibaca mesin, `""` pada kecocokan: `no_proven_internal_wallet`, `attribution_disabled`, `already_attributed`, `no_attributed_entity`, `directory_match_no_route`, `gtr_address_lookup_runs_on_dispatch`, `no_membership`, `network_switched_off`, `no_network_address_lookup`, `no_directory_match`, `awaiting_end_user` atau `picked_member_without_proven_wallet`. vasp: type: string format: uuid nullable: true description: VASP direktori yang disebutkan oleh langkah tersebut, jika ada. rail: type: string nullable: true description: >- Jalur yang menjangkau pihak lawan tersebut, ketika langkah menemukannya. at: type: string format: date-time TravelRuleNextAction: type: object description: >- Satu hal yang melanjutkan transfer `COUNTERPARTY_VASP_NOT_FOUND` atau `COUNTERPARTY_VASP_NOT_REACHABLE`. Lihat [Mengapa transfer terhenti](/id/transaction-monitoring/travel-rule#mengapa-transfer-macet). properties: action: type: string enum: - select_counterparty_vasp - declare_self_hosted - add_vasp_hint - update_compliance_email - resend description: >- `select_counterparty_vasp`: pengguna akhir memilih VASP tujuan di widget kepemilikan dompet, atau Anda melakukan PATCH `action=beneficiary_vasp`. `declare_self_hosted`: pengguna akhir menyatakan dompet tersebut swakelola di dalam widget. `add_vasp_hint`: beri tahu Didit siapa pihak lawannya, dengan nama VASP, LEI, atau Travel Address (misalnya `travel_address` pada entri buku alamat dompet tujuan), lalu kirim ulang. `update_compliance_email` dan `resend` adalah nilai `action` dari `PATCH /v3/transactions/{transaction_id}/travel-rule/`: berikan kembali email kepatuhan pihak lawan, dan jalankan perutean ulang. url: type: string format: uri description: >- Tautan widget kepemilikan dompet, pada `select_counterparty_vasp` dan `declare_self_hosted` saat transfer memiliki sesi widget yang terbuka. required: - action TravelRuleChainDetails: type: object description: >- Bagaimana rantai transfer menamai kedua dompetnya, ketika melibatkan lebih dari satu alamat yang membayar satu sama lain. Kosong (`{}`) untuk transfer rantai akun (EVM, Solana, Tron), di mana kedua alamat tersebut adalah dompetnya. Pencocokan, perutean, dan buku alamat membaca dompet dari sini terlebih dahulu. properties: chain: type: string description: >- Blockchain kanonis, misalnya `BTC`, `XRP`, atau `LIGHTNING` untuk transfer Lightning. shape: type: string enum: - utxo - memo - lightning originator: $ref: '#/components/schemas/TravelRuleChainSide' beneficiary: $ref: '#/components/schemas/TravelRuleChainSide' utxo: type: object description: >- Pada transfer UTXO: input dan output sebagaimana disimpan (jumlah dalam bentuk string desimal) dan output mana yang dibaca Didit sebagai apa. properties: inputs: type: array items: $ref: '#/components/schemas/TravelRuleUtxoEntry' outputs: type: array items: $ref: '#/components/schemas/TravelRuleUtxoEntry' change_output_indexes: type: array items: type: integer description: Output yang membayar kembali alamat input. beneficiary_output_index: type: integer nullable: true description: >- Output yang membayar penerima; null jika tidak ada yang dapat dibedakan. lightning: type: object description: >- Pada transfer Lightning: apa yang tertera pada permintaan pembayaran. Selalu berupa `kind` (`bolt11`, `bolt12_offer`, `bolt12_invoice`, `bolt12_invoice_request`, `lnurl`, `lightning_address`, `node_id`, atau `unknown`); faktur BOLT11 menambahkan `network`, `payee_node_id`, `payment_hash`, `amount_msat`, `created_at`, dan `expires_at`; string BOLT12 menambahkan `blinded_paths` dan `payee_node_id`; LNURL atau Lightning Address menambahkan `domain`-nya. Tidak ada yang di-resolve melalui jaringan: permintaan hanya didekode. additionalProperties: true warnings: type: array items: type: string enum: - declared_originator_not_an_input - declared_beneficiary_not_an_output - beneficiary_output_ambiguous - beneficiary_output_amount_differs description: >- Inkonsistensi UTXO yang perlu diperiksa: pengirim yang dideklarasikan bukan merupakan input, penerima yang dideklarasikan bukan merupakan output, tidak ada satu pun output penerima yang dapat dibedakan, atau output penerima membayar jumlah yang berbeda dari yang tertera pada transaksi. not_applicable_reason: type: string enum: - LIGHTNING_NO_PAYEE_IDENTIFIER - LIGHTNING_BOLT12_BLINDED_PAYEE - LIGHTNING_LNURL_NAMES_NO_PAYEE description: >- Pada transfer Lightning keluar yang permintaan pembayarannya tidak menyebutkan penerima: alasan transfer berstatus `NOT_APPLICABLE`. `LIGHTNING_NO_PAYEE_IDENTIFIER` (permintaan tidak menyebutkan node penerima, atau tidak dapat didekode), `LIGHTNING_BOLT12_BLINDED_PAYEE` (penawaran menyembunyikan penerimanya di balik blinded path), `LIGHTNING_LNURL_NAMES_NO_PAYEE` (LNURL menyebutkan nama layanan, bukan penerima). Kode yang sama membuka entri `timeline` terakhir dari transfer. TravelRuleChainSide: type: object description: >- Dompet salah satu pihak sebagaimana Didit menyelesaikannya dari data chain. properties: address: type: string description: >- Dompet. Pada jaringan memo berupa alamat klasik (alamat X XRP dipisahkan menjadi alamat klasik dan tag-nya); pada Lightning berupa ID node penerima pembayaran atau Lightning Address. memo: type: string description: >- Destination tag atau memo yang merupakan bagian dari dompet; `""` jika tidak ada. source: type: string enum: - declared - x_address - largest_input - only_non_change_output - amount_match - invoice_payee - updated description: >- Asal dompet: `declared` (permintaan Anda), `x_address` (dipisahkan dari X-address XRP), `largest_input` (alamat input UTXO yang berkontribusi paling banyak), `only_non_change_output` (satu-satunya output UTXO yang bukan kembalian), `amount_match` (satu output UTXO yang membayar jumlah transfer), `invoice_payee` (penerima pembayaran yang disebutkan dalam permintaan pembayaran Lightning), `updated` (ditetapkan kemudian dengan `action: update_originator_wallet`). TravelRuleUtxoEntry: type: object description: >- Satu input atau output dari transaksi UTXO, sebagaimana dicatat oleh rantai blockchain. required: - address properties: address: type: string maxLength: 128 amount: type: string nullable: true description: >- String desimal dalam unit koin itu sendiri (BTC, bukan satoshi). Opsional. example: '0.0125' txid: type: string maxLength: 128 description: Opsional. Transaksi yang digunakan oleh input. vout: type: integer nullable: true minimum: 0 description: Opsional. Indeks output yang digunakan oleh input. 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.