> ## 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. # Pemicu Uji Transfer Masuk VASP Travel Rule API > Khusus sandbox: minta Didit Test VASP kirim transfer Travel Rule masuk ke aplikasi Anda, lalu pantau alur keputusan, kotak masuk, dan kepemilikan. Prompt API untuk Memicu Uji Transfer Masuk VASP Salin prompt ke papan klip \

\`Make the Didit Test VASP send my sandbox application an inbound Travel Rule transfer, to exercise the receiving side of an exchange before going live.

Endpoint:
POST https://verification.didit.me/v3/travel-rule/test-vasp/inbound/

Authentication:
Use the x-api-key header with my SANDBOX application's API key. A live application receives 400.

Request body (application/json):
\{
"beneficiary_wallet_address": "0xYourSandboxWallet",  // required: the destination wallet address
"scenario": "accept",                                // optional: accept (default) or name_mismatch
"chain": "ETH",                                      // optional
"amount": "1",                                       // optional, decimal string
"currency": "ETH",                                   // optional
"reference": "demo-001"                              // optional: repeat calls with it return the first transfer
}

Behavior:
\- The transfer is decided by the same logic a real inbound transfer runs, against my wallet address book: a verified wallet with the holder's name completes, an unverified wallet waits for ownership, a wallet with no matching address book entry is booked ON_HOLD, and name_mismatch ends as COUNTERPARTY_MISMATCHED_DATA.
\- Nothing leaves Didit. travel_rule.status.updated webhooks fire with environment "sandbox", test_vasp true and the scenario name.

What to read from the response:
\- transaction_id, txn_id - the booked inbound transaction.
\- travel_rule_status and detail - how my application decided it.
\- travel_rule - the full transfer.

Full guide: /transaction-monitoring/travel-rule#testing-without-network-credentials.`

\
Tempel ke ## OpenAPI ````yaml id/openapi-25.json POST /v3/travel-rule/test-vasp/inbound/ 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/travel-rule/test-vasp/inbound/: post: tags: - Travel Rule summary: Picu transfer masuk dari VASP Pengujian Didit (sandbox) description: >- Khusus aplikasi sandbox. Test VASP Didit mengirimkan transfer Travel Rule masuk ke aplikasi Anda, sehingga Anda dapat menguji sisi penerimaan dari bursa secara menyeluruh sebelum masuk ke lingkungan produksi. Transfer dibukukan dan diputuskan dengan logika yang sama yang dijalankan transfer masuk nyata dari jaringan terhadap buku alamat dompet Anda, sehingga kotak masuk, keputusan, dan alur kepemilikan dompet berperilaku persis seperti di lingkungan produksi. Tidak ada yang keluar dari Didit. Aplikasi di lingkungan produksi menerima 400. Kirimkan `reference` yang sama lagi untuk mendapatkan transfer yang dibukukan pada panggilan pertama, alih-alih membuat transfer kedua. operationId: triggerTravelRuleTestVaspInbound requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TravelRuleTestVaspInboundRequest' example: beneficiary_wallet_address: 0xYourSandboxWallet scenario: accept amount: '1' reference: demo-001 responses: '201': description: >- Transfer masuk telah dibukukan dan diputuskan. Pengulangan dengan `reference` yang sama akan mengembalikan body yang sama. content: application/json: schema: $ref: '#/components/schemas/TravelRuleTestVaspInboundResponse' '400': description: >- Body tidak valid, `scenario` yang tidak dikenal atau tidak didukung, atau aplikasi merupakan aplikasi produksi. content: application/json: schema: type: object '409': description: >- Transfer tidak dapat dibukukan, misalnya karena Travel Rule tidak diaktifkan untuk aplikasi ini. 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/travel-rule/test-vasp/inbound/ \ -H 'x-api-key: YOUR_SANDBOX_API_KEY' -H 'Content-Type: application/json' \ -d '{"beneficiary_wallet_address":"0xYourSandboxWallet","scenario":"accept","reference":"demo-001"}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.transactions.travel_rule.trigger_test_vasp_inbound( beneficiary_wallet_address="0xYourSandboxWallet", scenario="accept", amount="1", reference="demo-001", ) 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.triggerTestVaspInbound({ beneficiary_wallet_address: "0xYourSandboxWallet", scenario: "accept", amount: "1", reference: "demo-001", }); 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.TriggerTestVASPInbound(ctx, didit.TravelRuleTestVASPInboundRequest{\n\tBeneficiaryWalletAddress: \"0xYourSandboxWallet\",\n\tScenario: didit.Some(didit.TravelRuleTestVASPInboundRequestScenario(\"accept\")),\n\tAmount: didit.String(\"1\"),\n\tReference: didit.String(\"demo-001\"),\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.TravelRuleTestVaspInboundRequest; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.transactions().travelRule().triggerTestVaspInbound(TravelRuleTestVaspInboundRequest.builder() .beneficiaryWalletAddress("0xYourSandboxWallet") .scenario(TravelRuleTestVaspInboundRequest.Scenario.of("accept")) .amount("1") .reference("demo-001") .build()); System.out.println(result); - lang: php label: PHP source: |- transactions->travelRule->triggerTestVaspInbound([ 'beneficiary_wallet_address' => '0xYourSandboxWallet', 'scenario' => 'accept', 'amount' => '1', 'reference' => 'demo-001', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.transactions.travel_rule.trigger_test_vasp_inbound( beneficiary_wallet_address: "0xYourSandboxWallet", scenario: "accept", amount: "1", reference: "demo-001" ) 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.TriggerTestVaspInboundAsync(new TravelRuleTestVaspInboundRequest { BeneficiaryWalletAddress = "0xYourSandboxWallet", Scenario = new TravelRuleTestVaspInboundRequestScenario("accept"), Amount = "1", Reference = "demo-001", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: TravelRuleTestVaspInboundRequest: type: object required: - beneficiary_wallet_address properties: beneficiary_wallet_address: type: string description: >- Alamat dompet tujuan. Didit Test VASP mengirimkan ke alamat tersebut, dicocokkan dengan buku alamat dompet Anda pada rantai aset tersebut. Dompet tanpa entri yang cocok tetap diterima dan transaksi masuk dicatat ON_HOLD. scenario: type: string enum: - accept - name_mismatch default: accept description: >- Pernyataan Didit Test VASP mengenai siapa penerimanya. `accept` menyatakan nama pemilik sendiri; `name_mismatch` menyatakan nama yang tidak disetujui oleh pemilik mana pun. Keputusan itu sendiri selalu menjadi milik Anda. chain: type: string default: ETH description: Chain dari aset. amount: type: string default: '1' description: Jumlah sebagai string desimal. currency: type: string default: ETH description: Kode aset. reference: type: string description: >- Kunci idempotensi opsional. Pengulangan dengan nilai yang sama mengembalikan transfer yang telah dibukukan oleh panggilan pertama. TravelRuleTestVaspInboundResponse: type: object properties: transaction_id: type: string format: uuid description: UUID transaksi Didit dari transfer masuk. txn_id: type: string description: txn_id yang dibuat oleh Didit. scenario: type: string description: Skenario yang dijalankan. travel_rule_status: type: string description: Status yang dihasilkan dari keputusan aplikasi Anda sendiri. detail: type: string description: Alasan mengapa transfer berakhir dengan status tersebut. test_vasp: type: boolean description: 'Selalu true: pengirimnya adalah Didit Test VASP.' travel_rule: $ref: '#/components/schemas/TravelRuleTransferDetail' 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.