Travel Rule FATF API: Kepatuhan VASP

​

Ikhtisar

• Anda mengirimkan transfer dengan transaction_category: "travelRule".
• Didit mencoba jalur sesuai urutan prioritas untuk menjangkau VASP pihak lawan, menjalankan pertukaran melalui jalur pertama yang berhasil menjangkaunya, dan, jika pihak lain mengembalikan nama penerima, mencocokkannya dengan nama yang Anda kirim.
• Anda hanya boleh menyiarkan transfer di on-chain setelah pertukaran mencapai COMPLETED.
• Anda kemudian melaporkan hash transaksi on-chain kembali ke Didit untuk menutup pertukaran dengan status FINISHED.

​

Apa yang dijalankan saat Anda mengirim transfer

1. Validasi dan pengikatan subjek. Payload divalidasi. transaction_id yang sudah dipakai di aplikasi Anda akan ditolak dengan 400, dan jika dua permintaan dengan id yang sama berjalan bersamaan, salah satunya menerima 409. subject ditautkan ke profil pengguna atau bisnis Anda melalui vendor_data, sehingga transfer muncul di profil tersebut untuk pemantauan. vendor_data subjek atau pihak lawan yang masuk daftar blokir ditolak dengan 400, dan tidak ada transaksi yang dibuat. Dompet, rekening bank, IP, dan perangkat yang masuk daftar blokir diperiksa pada langkah 6 dan menolak transaksi di sana, setelah routing dijalankan.
2. Pengayaan perangkat dan jaringan. IP pihak-pihak diperkaya dengan data geografis, dan konteks perangkat apa pun (otomatis saat pengiriman melalui SDK) dinormalisasi ke dalam graf perangkat. Ini adalah graf yang sama dengan yang diisi sesi KYC, sehingga “terkait berdasarkan perangkat” berlaku lintas onboarding dan transaksi.
3. Skrining kripto. Untuk transfer kripto dengan pemantauan aktif, dompet terkait (atau hash on-chain) diskrining terhadap analitik blockchain sebelum ada yang dipertukarkan: paparan sanksi, kedekatan dengan mixer, dana hasil curian. Lihat Skrining kripto & dompet.
4. Transfer Travel Rule. Mesin pertukaran memeriksa ambang batas dan menghormati deklarasi dompet swakelola, lalu menyimpan transfer: NOT_APPLICABLE di bawah ambang batas Anda, UNCONFIRMED_OWNERSHIP untuk dompet swakelola yang dideklarasikan, COMPLETED ketika dompet lawan adalah dompet terverifikasi milik Anda sendiri, dan AWAITING_COUNTERPARTY selain itu, dengan rail yang masih kosong. Setiap perubahan status memasukkan event travel_rule.status.updated ke antrean, dan Didit mengirimkannya setelah transaction.created milik transaksi (langkah 7).
5. Penerbitan widget kepemilikan dompet. Jika transfer membutuhkan bukti kontrol dari pengguna akhir dan auto_wallet_verification aktif, sesi widget kepemilikan dompet diterbitkan dan dikembalikan dalam action_required.
6. Evaluasi aturan. Setiap aturan aktif dijalankan. Bundel EU TFR bereaksi terhadap status transfer yang ditetapkan pada langkah 4, aturan kustom Anda melihat keluaran skrining dari langkah 3, dan sebuah aturan dapat menahan transaksi (IN_REVIEW), menolaknya, atau meminta verifikasi tingkat lanjut (AWAITING_USER).
7. Penagihan dan notifikasi. Transaksi keluar ditagihkan dalam satu baris: baris Travel Rule ketika transaksi memulai pertukaran data, dan Transaction Screening selain itu. Transfer masuk tidak dikenakan biaya apa pun, dan aplikasi sandbox tidak pernah ditagih. Respons dikembalikan, dan event transaction.created dikirim ke tujuan webhook Anda, diikuti event travel_rule.status.updated dari langkah 4.
8. Routing, setelah respons. Didit menelusuri tujuh rail sesuai urutan prioritas. Jika tidak ada yang berhasil, atribusi analitik blockchain mengidentifikasi pihak lawan dan rail dijalankan ulang sekali. Rail pertama yang dapat dijangkau membawa pertukaran data: transfer tetap AWAITING_COUNTERPARTY di rail tersebut selama pihak lawan belum menjawab, langsung diselesaikan ketika pihak lawan INTERNAL ditemukan (COMPLETED atau COUNTERPARTY_MISMATCHED_DATA), atau menjadi COUNTERPARTY_VASP_NOT_FOUND ketika tidak ada rail yang menjangkau pihak lawan. Setiap perubahan memicu travel_rule.status.updated, dan aturan Anda dijalankan ulang setiap kali status atau rail berubah. Transfer yang masih berstatus COUNTERPARTY_VASP_NOT_FOUND setelah routing menerima sesi widget kepemilikan dompetnya pada titik itu (jika auto_wallet_verification aktif). Bacalah dari action_required transaksi dengan Ambil transaksi.

​

Bagaimana setiap langkah memenuhi kewajiban Anda

​

Siklus hidup

​

Pengiriman dan coba lagi

​

Nilai status lama

​

Pengaturan

curl -X GET https://verification.didit.me/v3/travel-rule/settings/ \
  -H "x-api-key: YOUR_API_KEY"

{
  "is_enabled": false,
  "jurisdiction": "EU",
  "name_matching_strictness": "DEFAULT",
  "confirmation_timeout_hours": 48,
  "timeout_outcome": "HOLD",
  "threshold_amount": "0.00",
  "inbound_auto_accept": true,
  "allow_self_declaration": true,
  "allow_screenshot_proof": true,
  "auto_wallet_verification": true,
  "vasp_attribution_enabled": true,
  "counterparty_screening_enabled": false,
  "sunrise_policy": "",
  "sunrise_jurisdictions": ["CO", "KH", "VN"],
  "non_responsive_policy": "",
  "legal_name": "",
  "lei": "",
  "compliance_email": "",
  "is_discoverable": true,
  "travel_address": "",
  "disabled_networks": [],
  "networks": {
    "gtr": { "rail": "GTR", "mode": "unavailable", "platform_available": false, "connected": false },
    "trust": { "rail": "TRUST", "mode": "unavailable", "platform_available": false, "connected": false },
    "verifyvasp": { "rail": "VERIFYVASP", "mode": "unavailable", "platform_available": false, "connected": false },
    "sygna": { "rail": "SYGNA", "mode": "unavailable", "platform_available": false, "connected": false }
  }
}

curl -X PUT https://verification.didit.me/v3/travel-rule/settings/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "is_enabled": true,
    "legal_name": "Origin CASP SL",
    "jurisdiction": "EU",
    "name_matching_strictness": "DEFAULT",
    "confirmation_timeout_hours": 48,
    "timeout_outcome": "HOLD",
    "is_discoverable": true
  }'

​

Keketatan pencocokan nama

​

Mode validasi kepemilikan

​

Berbagi data

{
  "data_sharing_fields": {
    "individual": ["name", "wallet_address", "address", "date_of_birth"],
    "company": ["name", "wallet_address", "address"]
  }
}

• Individu dapat membagikan name, wallet_address, address, national_id, customer_identification, date_of_birth, dan place_of_birth. Perusahaan menggunakan lima yang pertama.
• name dan wallet_address selalu dikirim.
• Jenis entitas yang tidak pernah Anda pilih membagikan setiap kolom. Daftar kosong juga merupakan pilihan: hanya nama dan dompet yang dibagikan.
• PUT digabungkan per jenis entitas, sehingga mengirim individual tidak mengubah pilihan company yang tersimpan.
• Pilihan yang tidak dapat memenuhi kewajiban pengirim dari rezim jurisdiction Anda (EU TFR atau FATF Recommendation 16), termasuk daftar kosong, ditolak dengan 400. Galatnya berada di bawah data_sharing_fields, dengan kunci berdasarkan jenis entitas.

​

Pencocokan per kolom

{
  "matching_rules": {
    "individual": { "name": "DEFAULT", "date_of_birth": "STRICT", "address": "NONE", "account": "STRICT" },
    "company": { "name": "FUZZY", "address": "NONE", "account": "STRICT" }
  }
}

​

Ambang batas per yurisdiksi

​

Model data IVMS 101

• Aksara Latin. IVMS 101 mensyaratkan nilai dalam aksara Latin; transliterasi nama yang secara asli ditulis dengan aksara lain. Pencocokan nama Didit membandingkan kumpulan token yang sudah dinormalisasi, sehingga perbedaan urutan dan huruf besar-kecil tidak menggagalkan pertukaran - tetapi aksara yang berbeda di kedua sisi akan menggagalkannya.
• Kirimkan data yang sudah Anda verifikasi. Ketika subjek di balik vendor_data adalah pengguna dengan verifikasi KYC Didit yang disetujui, Didit mengirimkan identitas terverifikasi, bukan nilai yang Anda ketik: lihat Data terverifikasi dan asal data. Untuk subjek lain, Didit mengirimkan persis originator_data yang Anda kirim, jadi bangunlah dari identitas yang Anda verifikasi saat onboarding, bukan dari kolom formulir yang belum diverifikasi. Itulah yang dituntut oleh frasa FATF “required and accurate originator information” (informasi pengirim yang wajib dan akurat). Pada jalur INTERNAL, aplikasi penerima juga menerima subject yang Anda kirim (nama, vendor_data, tanggal lahir, negara, dan alamat) sebagai pihak lawan dari transaksi masuknya.

​

Data terverifikasi dan asal data

• pengirim transfer keluar yang Anda buat dengan POST /v3/transactions/;
• penerima transfer masuk yang Anda laporkan dengan POST /v3/transactions/, atau dengan POST /v3/travel-rule/inbound/ ketika holder_vendor_data pada dompet yang cocok menyebut pengguna tersebut.

{
  "metadata": {
    "originator_provenance": { "name": "verified", "date_of_birth": "verified", "customer_identification": "caller" },
    "originator_verified_differences": {
      "name": { "caller": "Jane Doe", "verified": "Jane Elizabeth Doe" }
    }
  }
}

​

Mengirim IVMS 101 secara langsung

• blok originator dan beneficiary, dengan originatorPersons atau beneficiaryPersons yang berisi naturalPerson atau legalPerson, serta accountNumber;
• blok yang sama di dalam objek ivms101 (atau IVMS101);
• satu orang IVMS 101, atau satu blok utuh, sebagai originator_data atau beneficiary_data.

{
  "travel_rule_details": {
    "status": "AWAITING_COUNTERPARTY",
    "beneficiary": {
      "beneficiaryPersons": [
        {
          "naturalPerson": {
            "name": { "nameIdentifier": [{ "primaryIdentifier": "Ruiz", "secondaryIdentifier": "Carlos", "nameIdentifierType": "LEGL" }] }
          }
        }
      ],
      "accountNumber": ["0xBeneficiaryWallet01"]
    }
  }
}

​

Data yang wajib diisi per rezim

​

Travel Address

ta2ih1MicegQ3JqiKz9xT89KsSuwaDJYw8DgzmeSEp1h9tduJcNDZ5SgKLEHeyGMcS1s2HgbM6undFrMQknhM5aTXw3G9KBzi16hx

​

Pengujian tanpa kredensial jaringan

• Sandbox keluar: kirim transaksi travelRule dari aplikasi sandbox. Setelah pemeriksaan ambang batas dan pemeriksaan dompet swakelola, Didit Test VASP akan meresponsnya di dalam Didit dengan skenario yang Anda pilih berdasarkan dompet atau nama penerima: diterima, ditolak, nama tidak cocok, tidak dapat dijangkau, timeout, atau swakelola. Tidak ada jaringan, email, atau pelanggan Didit lain yang menerima apa pun.
• Sandbox masuk: minta VASP pengujian mengirim transfer kepada Anda dengan Trigger Test VASP Inbound Transfer, atau daftarkan sendiri dengan Register Inbound Travel Rule Transfer. Uji dompet yang tidak dikenal, dompet yang belum diverifikasi, ketidakcocokan nama penerima, dan dompet yang terverifikasi dan cocok. Skenario ini menguji keputusan inbound nyata tanpa menghubungi jaringan.
• Dua aplikasi produksi yang terkendali: gunakan rail INTERNAL di antara dua aplikasi produksi milik Anda (aplikasi penerima dapat ditemukan dan membuktikan kendali atas dompet tujuan dengan pesan bertanda tangan atau setoran uji), atau pihak lawan TRP yang terkendali, untuk menguji pertukaran dua pihak tanpa kredensial jaringan komersial. Aplikasi produksi dapat menimbulkan biaya dan notifikasi normal; gunakan identitas dan pihak lawan uji yang Anda kendalikan.

​

Mengirim transfer

1. Jika jumlahnya di bawah threshold_amount yang Anda konfigurasikan, transfer langsung diselesaikan dengan status NOT_APPLICABLE dan tidak ada negosiasi yang dilakukan.
2. Jika metode pembayaran pihak lawan menyatakan tujuan sebagai dompet swakelola (payment_method.method_type: "unhosted_wallet"), tidak ada jalur yang dicoba. Transfer langsung masuk ke UNCONFIRMED_OWNERSHIP dan widget kepemilikan dompet dibuat otomatis (lihat Dompet swakelola yang dinyatakan).
3. Jika tidak, jalur dijalankan sesuai urutan prioritas, dan jalur pertama yang dapat menjangkau pihak lawan akan membawa pertukaran data:
   • INTERNAL: tepat satu pelanggan Didit lain memegang bukti pesan bertanda tangan atau bukti setoran uji untuk beneficiary_data.wallet_address, yang dibuat setelah dompet terakhir kali berganti pemegang. Aplikasi Anda sendiri tidak pernah dihitung, dan jika pengguna akhir Anda memilih anggota jaringan Didit di widget kepemilikan dompet, hanya bukti anggota tersebut yang dihitung. Aplikasi pelanggan tersebut harus berstatus produksi (bukan sandbox), Travel Rule aktif, dan is_discoverable diatur, serta merupakan VASP yang Anda sebutkan ketika mengirim counterparty_vasp_lei atau counterparty_vasp_name. Dompet yang hanya dinyatakan sendiri, dibuktikan dengan tangkapan layar, belum diverifikasi, atau hanya tercantum di buku alamat tidak akan pernah menerima apa pun melalui INTERNAL.
   • TRP: aset transfer memiliki pemetaan Digital Token Identifier untuk jaringan transfer (lihat Pengidentifikasi aset TRP), dan payload membawa beneficiary_data.travel_address, atau entri buku alamat tujuan menyimpannya, atau pihak lawan ditemukan di direktori (melalui counterparty_vasp_lei atau counterparty_vasp_name) dengan endpoint TRP.
   • GTR, TRUST, VERIFYVASP, SYGNA: Anda telah menghubungkan keanggotaan Anda sendiri untuk jaringan tersebut di Marketplace, dan pihak lawan dapat diselesaikan menjadi ID jaringan (melalui kolom eksplisit atau entri direktori, lihat Kolom penyelesaian pihak lawan). Saat ini Didit belum memiliki keanggotaan platform di jaringan-jaringan ini (Didit sedang dalam proses onboarding sebagai penyedia), sehingga disabled_networks belum mengubah langkah ini.
   • EMAIL: beneficiary_data.counterparty_vasp_email telah diisi, atau counterparty_vasp_name diselesaikan menjadi entri direktori dengan email kepatuhan.
4. Jika tidak ada jalur yang dapat menyelesaikan pihak lawan, Didit menjalankan rangkaian penemuan pihak lawan. Jika vasp_attribution_enabled aktif, rangkaian ini mencakup atribusi analitik blockchain: dompet tujuan diselesaikan menjadi VASP pemiliknya, nama hasil atribusi ditulis ke beneficiary_data.counterparty_vasp_name (jika kosong) dan ke direktori, lalu jalur dijalankan ulang sekali. Dengan demikian, dompet yang diatribusikan ke VASP yang entri direktorinya memiliki endpoint TRP, ID jaringan, atau email kepatuhan akan dirutekan pada putaran kedua ini.
5. Jika pihak lawan masih belum terselesaikan, transfer berpindah ke COUNTERPARTY_VASP_NOT_FOUND. Untuk transfer keluar, Didit membuat otomatis widget kepemilikan dompet (jika auto_wallet_verification aktif) agar transfer tetap dapat diselesaikan sebagai transfer dompet swakelola, dan Anda dapat menjalankan ulang perutean nanti dengan action: "resend" setelah memiliki data pihak lawan yang lebih baik.

​

Pengidentifikasi aset TRP

​

Penemuan pihak lawan

​

Kolom penentuan pihak lawan

​

Bentuk chain

​

Transfer UTXO

• Pengirim: originator_data.wallet_address jika Anda mengirimkannya, jika tidak, alamat input yang memberikan kontribusi terbesar (source: largest_input).
• Penerima: dompet yang dideklarasikan, jika tidak, satu-satunya output yang tidak dikirim kembali ke alamat input sebagai kembalian (only_non_change_output), jika tidak, satu output yang membayar jumlah transfer (amount_match).

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "btc-withdrawal-0042",
    "transaction_category": "travelRule",
    "transaction_details": {
      "direction": "outbound",
      "amount": "0.25",
      "currency": "BTC",
      "currency_kind": "crypto"
    },
    "subject": { "vendor_data": "user-042", "full_name": "Ana Diaz" },
    "counterparty": { "full_name": "Luis Perez" },
    "travel_rule_details": {
      "status": "AWAITING_COUNTERPARTY",
      "beneficiary_data": { "name": "Luis Perez", "counterparty_vasp_name": "Destination Exchange" },
      "utxo": {
        "inputs": [
          { "address": "bc1qsenderhotwallet01", "amount": "0.30" },
          { "address": "bc1qsendercoldwallet02", "amount": "0.05" }
        ],
        "outputs": [
          { "address": "bc1qbeneficiarydeposit01", "amount": "0.25" },
          { "address": "bc1qsenderhotwallet01", "amount": "0.0999" }
        ]
      }
    }
  }'

{
  "chain_details": {
    "chain": "BTC",
    "shape": "utxo",
    "originator": { "address": "bc1qsenderhotwallet01", "memo": "", "source": "largest_input" },
    "beneficiary": { "address": "bc1qbeneficiarydeposit01", "memo": "", "source": "only_non_change_output" },
    "utxo": {
      "inputs": [
        { "address": "bc1qsenderhotwallet01", "amount": "0.300000000000000000" },
        { "address": "bc1qsendercoldwallet02", "amount": "0.050000000000000000" }
      ],
      "outputs": [
        { "address": "bc1qbeneficiarydeposit01", "amount": "0.250000000000000000" },
        { "address": "bc1qsenderhotwallet01", "amount": "0.099900000000000000" }
      ],
      "change_output_indexes": [1],
      "beneficiary_output_index": 0
    }
  }
}

​

Jaringan memo dan tag

• Entri buku alamat dengan memo hanya cocok dengan transfer yang menyebutkan memo tersebut. Entri tanpa memo cocok dengan seluruh alamat. Transfer yang tidak menyebutkan memo tidak pernah mencapai entri yang memilikinya: pada alamat bersama, deposit tanpa tag-nya tidak menjadi milik siapa pun.
• Alamat X XRP memuat tag di dalamnya: Didit memisahkannya menjadi alamat klasik dan tag (source: x_address), sehingga dompet yang didaftarkan dalam salah satu bentuk akan cocok dengan transfer dalam bentuk lainnya.
• Setiap memo pada alamat bersama merupakan metode pembayaran tersendiri pada transaksi.
• Yang diterima oleh setiap jaringan: tag tujuan XRP adalah bilangan bulat dari 0 hingga 4294967295 (angka JSON diterima); memo Stellar berupa teks hingga 28 byte, id 64-bit, atau hash 32-byte dalam format heksadesimal; EOS menerima hingga 256 byte, Cosmos hingga 256 karakter, Hedera hingga 100 byte. Memo pada rantai yang tidak memilikinya (Bitcoin, rantai EVM, Solana, Tron, Litecoin, Bitcoin Cash, Dogecoin, Lightning) mengembalikan 400.

​

Lightning

​

Memperbarui dompet pengirim

curl -X PATCH "https://verification.didit.me/v3/transactions/$TRANSACTION_ID/travel-rule/" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "action": "update_originator_wallet", "wallet_address": "bc1qsendercoldwallet02" }'

• Hanya transfer keluar, dan tidak pernah transfer yang berstatus CANCELLED atau EXPIRED (409).
• Jika input UTXO transfer diketahui, dompet harus salah satu dari input tersebut (jika tidak, 400). Kirim juga memo pada jaringan memo.
• Hanya catatan yang diubah: tidak ada yang dikirim ulang ke pihak lawan dan statusnya tetap. chain_details.originator menjadi dompet baru dengan source: updated, timeline mencatat dompet sebelumnya dan dompet baru, dan pihak lawan INTERNAL dari transfer tersebut diperbarui dengan cara yang sama.

​

Atribusi analitik blockchain

1. Mencatat atribusi pada transfer: beneficiary_data.counterparty_vasp_name diisi (jika Anda tidak memasukkannya), dan metadata transfer memuat blok vasp_attribution dengan nama entitas, jenis entitas, negara, dan source: "blockchain_analytics".
2. Menambahkan entitas ke direktori VASP (atau mencocokkan entri yang sudah ada), sehingga atribusi tetap konsisten di seluruh transfer.
3. Menjalankan ulang jalur sekali dengan nama hasil atribusi - entri direktori yang sudah memuat endpoint TRP membuat transfer dirutekan segera, alih-alih berakhir di COUNTERPARTY_VASP_NOT_FOUND.

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "trv-2026-07-05-001",
    "transaction_category": "travelRule",
    "transaction_details": {
      "direction": "outbound",
      "action_type": "transfer",
      "amount": "0.25",
      "currency": "ETH",
      "currency_kind": "crypto"
    },
    "subject": {
      "entity_type": "individual",
      "vendor_data": "user-042",
      "full_name": "Jane Doe"
    },
    "travel_rule_details": {
      "status": "AWAITING_COUNTERPARTY",
      "originator_data": {
        "first_name": "Jane",
        "last_name": "Doe",
        "date_of_birth": "1990-04-12",
        "residence_country": "ES",
        "customer_identification": "user-042",
        "wallet_address": "0x135908330861442a814796ae99feac507925782a"
      },
      "beneficiary_data": {
        "wallet_address": "0xede2d7e4f5b097e6391ab6bbcf2f47a53f4778cb",
        "name": "Ana Diaz",
        "counterparty_vasp_email": "compliance@bene-casp.example"
      }
    }
  }'

{
  "uuid": "22222222-3333-4444-5555-666666666666",
  "txn_id": "trv-2026-07-05-001",
  "transaction_type": "travelRule",
  "direction": "OUTBOUND",
  "status": "APPROVED",
  "amount": "0.25",
  "currency": "ETH",
  "currency_type": "crypto",
  "travel_rule": {
    "uuid": "33333333-4444-5555-6666-777777777777",
    "status": "AWAITING_COUNTERPARTY",
    "protocol": null,
    "required": true,
    "obligations_count": 0,
    "originator_data": {
      "first_name": "Jane",
      "last_name": "Doe",
      "date_of_birth": "1990-04-12",
      "residence_country": "ES",
      "customer_identification": "user-042",
      "wallet_address": "0x135908330861442a814796ae99feac507925782a"
    },
    "beneficiary_data": {
      "wallet_address": "0xede2d7e4f5b097e6391ab6bbcf2f47a53f4778cb",
      "name": "Ana Diaz",
      "counterparty_vasp_email": "compliance@bene-casp.example",
      "chain": "ETH"
    },
    "metadata": {
      "compliance_email_source": "caller_supplied"
    }
  },
  "action_required": null
}

• originator_data adalah data yang Anda kirim, karena subjek contoh tidak memiliki verifikasi KYC yang disetujui; untuk pengguna yang terverifikasi, Didit membangunnya dari data terverifikasi (lihat Data terverifikasi dan asal-usul data). Jalur EMAIL hanya menampilkan kepada penerima kolom pengirim yang Anda bagikan di data_sharing_fields.
• beneficiary_data.chain bernilai ETH karena permintaan tidak menyebutkan jaringan, sehingga Didit mengambilnya dari mata uang.
• status bernilai APPROVED karena tidak ada aturan yang memproses transaksi; aturan Anda sendiri dapat menetapkan status lain.
• Kontak kepatuhan menerima tautan pengambilan, dan transfer selesai, gagal pada kecocokan nama, atau ditolak saat mereka merespons, atau kedaluwarsa jika mereka tidak merespons (lihat Pengambilan melalui email).

curl -X PATCH https://verification.didit.me/v3/transactions/22222222-3333-4444-5555-666666666666/travel-rule/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"payment_txn_id": "0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060"}'

curl -X PATCH https://verification.didit.me/v3/transactions/22222222-3333-4444-5555-666666666666/travel-rule/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action": "resend"}'

​

Mengapa transfer macet

• reason adalah penyebab yang dapat dibaca mesin, "" untuk status lainnya.
• next_actions berisi tindakan yang memajukan transfer, [] untuk status lainnya.
• delivery adalah pesan terbaru yang harus dikirimkan transfer kepada pihak lawan: kind, status (QUEUED, SENDING, RETRYING, DELIVERED, atau FAILED), rail, attempts, last_error, next_attempt_at, dan delivered_at, atau null jika tidak ada pesan yang harus dikirim.
• discovery adalah tempat Didit mencari pihak lawan, dengan satu entri untuk setiap langkah yang dijalankan: step, outcome (match, miss, atau skipped), reason, vasp, rail, dan at.

{
  "uuid": "33333333-4444-5555-6666-777777777777",
  "status": "COUNTERPARTY_VASP_NOT_REACHABLE",
  "protocol": "EMAIL",
  "direction": "OUTBOUND",
  "rail": "EMAIL",
  "counterparty_vasp": null,
  "delivery": {
    "kind": "SEND",
    "status": "FAILED",
    "rail": "EMAIL",
    "attempts": 1,
    "last_error": "email undeliverable",
    "next_attempt_at": null,
    "delivered_at": null
  },
  "reason": "email_undeliverable",
  "next_actions": [
    { "action": "update_compliance_email" },
    { "action": "resend" }
  ]
}

curl -X PATCH https://verification.didit.me/v3/transactions/22222222-3333-4444-5555-666666666666/travel-rule/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action": "update_compliance_email", "compliance_email": "desk@bene-casp.example"}'

curl -X PATCH https://verification.didit.me/v3/transactions/22222222-3333-4444-5555-666666666666/travel-rule/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action": "resend"}'

​

Dompet swakelola yang dideklarasikan

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "trv-2026-07-07-002",
    "transaction_category": "travelRule",
    "transaction_details": {
      "direction": "outbound",
      "action_type": "transfer",
      "amount": "0.25",
      "currency": "ETH",
      "currency_kind": "crypto"
    },
    "subject": {
      "entity_type": "individual",
      "vendor_data": "user-042",
      "full_name": "Jane Doe"
    },
    "counterparty": {
      "entity_type": "external",
      "full_name": "Jane Doe",
      "payment_method": {
        "method_type": "unhosted_wallet",
        "account_id": "0xd3b62acb76fb27a7f8961ec40fa11746b113aca9"
      }
    },
    "travel_rule_details": {
      "status": "AWAITING_COUNTERPARTY",
      "beneficiary_data": {
        "wallet_address": "0xd3b62acb76fb27a7f8961ec40fa11746b113aca9",
        "name": "Jane Doe"
      }
    }
  }'

• Tidak ada rail yang dicoba - tidak ada VASP pihak lawan untuk bertukar data - dan transfer langsung dibuat dalam UNCONFIRMED_OWNERSHIP.
• Ketika auto_wallet_verification aktif (nilai default), Didit secara otomatis membuat sesi widget kepemilikan dompet yang terikat pada transaksi dan mengembalikannya dalam blok action_required transaksi; SDK akan membukanya secara otomatis pada pengiriman sisi klien.
• Setelah pelanggan membuktikan kendali atas dompet, transfer menjalankan pencocokan nama penerima dan maju ke COMPLETED (atau COUNTERPARTY_MISMATCHED_DATA jika pencocokan gagal).

​

Penerimaan

​

Mengonfirmasi kepemilikan dompet

• Transfer masuk mengarah ke entri buku alamat yang kepemilikannya belum terverifikasi.
• Dompet pihak lawan dinyatakan sebagai dompet swakelola (counterparty.payment_method.method_type: "unhosted_wallet"), baik pada penarikan keluar maupun setoran masuk. Lihat Dompet swakelola yang dinyatakan.

curl -X POST https://verification.didit.me/v3/transactions/{transaction_uuid}/travel-rule/ownership/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"confirmed": true}'

• UNCONFIRMED_OWNERSHIP, di kedua arah.
• ON_HOLD pada transfer masuk.
• UNCONFIRMED_OWNERSHIP, ON_HOLD atau COUNTERPARTY_MISMATCHED_DATA pada transfer masuk TRP, sehingga petugas kepatuhan dapat menyelesaikan pertanyaan pihak lawan secara manual.

• confirmed: true menandai entri buku alamat dompet yang cocok sebagai kepemilikannya terverifikasi, lalu menjalankan pencocokan nama terhadap holder_name entri tersebut. Hasilnya COMPLETED jika lolos, dan COUNTERPARTY_MISMATCHED_DATA jika tidak. Pasangan rel INTERNAL, jika ada, mendapat hasil yang sama. Untuk dompet swakelola yang dinyatakan, confirmed: true mencatat bahwa pelanggan Anda telah memverifikasi siapa yang mengendalikan dompet pihak lawan, dan menyelesaikan transfer (COMPLETED), baik keluar maupun masuk. Transfer masuk yang depositnya sudah diselesaikan kemudian langsung berlanjut ke FINISHED.
• confirmed: false memindahkan kedua sisi transfer ke COUNTERPARTY_VASP_GENERAL_DECLINE.
• Entri yang cocok dicari di buku alamat Anda hanya berdasarkan alamat dompet, tanpa jaringan blockchain. Menyelesaikan ON_HOLD masuk tanpa entri yang cocok akan membuat entri dari beneficiary_data.wallet_address transfer dan menandainya sebagai terverifikasi. Dompet swakelola yang dinyatakan adalah pengecualian: dompet didaftarkan di buku alamat Anda sebagai kepemilikannya terverifikasi, seperti dijelaskan di bawah. Dalam kasus lain, entri yang tidak ada mengembalikan 409 dengan {"detail": "wallet address entry no longer available"}, yang juga dikembalikan untuk entri yang sudah dihapus.

• confirmed: true memerlukan alamat pembayaran untuk dikembalikan, yang diambil dari wallet_address pada permintaan, lalu dari entri yang cocok, lalu dari beneficiary_data.wallet_address. Jika ketiganya tidak ada, permintaan mengembalikan 400 dengan {"wallet_address": ["wallet_address is required to approve."]}. Didit membuat atau memverifikasi entri, mengirim callback penyelesaian pertanyaan ke pihak lawan, menetapkan ownership_confirmed, dan memindahkan transfer ke COMPLETED.
• confirmed: false mengirim respons penolakan dan memindahkan transfer ke COUNTERPARTY_VASP_GENERAL_DECLINE.
• Jika endpoint callback pihak lawan tidak dapat dijangkau, permintaan mengembalikan 502 dan transfer tetap berada di status saat ini. Pada persetujuan, entri buku alamat dompet tetap dibuat atau ditandai sebagai terverifikasi.

{"confirmed": true, "wallet_address": "0xCounterpartyWallet01"}

• Transfer jaringan yang sudah dijawab melalui jaringannya (transfer VerifyVASP, atau transfer GTR atau Sygna Bridge yang sudah diputuskan) mengembalikan 409 (lihat Transfer dari jaringan).

​

Transfer dari jaringan

• Perutean. Pesan sampai ke aplikasi Anda ketika pesan itu menyebut kode peserta dari keanggotaan terhubung Anda sendiri di jaringan tersebut. Pesan yang dialamatkan ke keanggotaan Didit sendiri hanya sampai kepada Anda jika Anda adalah satu-satunya pelanggan Didit aktif yang telah membuktikan kendali atas dompet penerima. Selain itu, pesan ditolak, sehingga tidak ada pelanggan yang pernah menerima transfer pelanggan lain.
• Keputusan. Didit membuat transfer masuk di aplikasi Anda dan memutusnya seperti permintaan TRP: pencocokan dompet, kepemilikan, pencocokan nama, dan inbound_auto_accept.
• Sekali saja. Jaringan mengirim ulang pesan hingga pesan itu dijawab. Pesan yang dikirim ulang menerima jawaban yang sama dengan yang diterima salinan pertama, dan tidak ada yang dibuat atau diputuskan dua kali.
• Peninjauan Anda, melalui GTR dan SYGNA. Transfer yang menunggu Anda (UNCONFIRMED_OWNERSHIP, ON_HOLD atau COUNTERPARTY_MISMATCHED_DATA) diputuskan dengan POST .../travel-rule/ownership/: confirmed: true menyetujuinya (sertakan wallet_address jika transfer tidak menyebutkannya) dan confirmed: false menolaknya. Didit menjawab jaringan setelah respons, dengan mekanisme coba lagi yang sama. Transfer yang sudah dijawab sebelumnya mengembalikan 409.
• Tidak ada jawaban lanjutan melalui VERIFYVASP. VerifyVASP mengambil jawabannya saat ia bertanya, sehingga transfer yang memerlukan peninjauan Anda langsung ditolak dan tidak dapat diputuskan kemudian (409).

​

Data pihak lawan yang disamarkan

{
  "data_masked": false,
  "data_unmasked": { "at": "2026-10-17T10:00:00Z", "reason": "wallet_proof", "actor": "" }
}

​

Umpan balik ketidakcocokan

{
  "status": "COUNTERPARTY_MISMATCHED_DATA",
  "mismatched_fields": ["date_of_birth"],
  "data_match": {
    "matched": false,
    "mismatched_fields": ["date_of_birth"],
    "fields": {
      "name": { "result": "matched", "strictness": "DEFAULT" },
      "date_of_birth": { "result": "mismatched", "strictness": "STRICT" },
      "address": { "result": "not_compared", "strictness": "NONE" },
      "account": { "result": "matched", "strictness": "STRICT" }
    }
  }
}

​

Skor kecocokan nama

{
  "name_match": {
    "score": 90,
    "matched": false,
    "method": "sequence_ratio",
    "strictness": "FUZZY",
    "compared_with": "wallet_holder",
    "transfer_name": "Ana Diaz",
    "compared_name": "Ana Diaz Garcia",
    "matched_names": ["Ana", "Diaz"],
    "mismatched_names": ["Garcia"]
  }
}

• score adalah kemiripan antara dua nama lengkap, dari 0 sampai 100, dan 0 jika salah satu nama kosong. matched adalah hasil pada strictness, sehingga keduanya bisa berbeda: FUZZY memutuskan berdasarkan rasio kemiripannya sendiri 0.85.
• matched_names adalah kata-kata dari nama transfer yang ditemukan dalam nama lainnya; mismatched_names adalah kata-kata yang dimiliki salah satu sisi tetapi tidak dimiliki sisi lainnya.
• method bernilai none, exact_token, token_subset, token_containment atau sequence_ratio, untuk NONE, STRICT, DEFAULT, CONTAINS dan FUZZY.
• compared_with bernilai wallet_holder (pemegang yang tercatat untuk dompet) atau counterparty_vasp (nama yang diberikan pihak lawan di halaman respons email, atau jawaban Didit Test VASP).
• Hasil transfer mengikuti data_match, yang membandingkan setiap kolom, sehingga sebuah transfer dapat berstatus COUNTERPARTY_MISMATCHED_DATA sementara name_match.matched bernilai true.
• name_match ada pada objek transfer yang dikembalikan oleh endpoint Travel Rule dan pada travel_rule yang tertanam di transaksi, dan bernilai null sampai nama dibandingkan. Daftar transfer dan webhook tidak memuatnya.
• Nama disembunyikan selama pihak-pihak disamarkan, dan pada salinan pertukaran INTERNAL milik pelanggan lain.

​

Pesan dan permintaan dokumen

curl -X POST https://verification.didit.me/v3/transactions/{transaction_uuid}/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"]}'

• kind bernilai MESSAGE (default) atau DOCUMENT_REQUEST. Permintaan dokumen membutuhkan minimal satu entri di requested_documents (hingga 10); pesan membutuhkan body (hingga 5000 karakter) atau sebuah file.
• reply_to menunjuk pesan sebelumnya pada transfer yang sama. Balasan dari pihak seberang yang memuat dokumen memenuhi permintaan dokumen yang dijawabnya, dan fulfilled_at diisi pada pesan tersebut. Balasan Anda sendiri tidak pernah memenuhi permintaan Anda sendiri.
• Kirim multipart dengan files untuk melampirkan hingga 5 file berukuran masing-masing 10 MB, berupa PDF, PNG, JPEG atau WebP. Didit memeriksa isi setiap file, bukan hanya tipe yang dideklarasikan, dan file lain menyebabkan permintaan mengembalikan 400 pada files (“Attach PDF, PNG, JPEG or WebP files only.”).
• Sebuah transfer menampung hingga 100 pesan, dengan hingga 20 di antaranya dapat memuat lampiran (masing-masing hingga 5 file), dihitung dari kedua sisi; jika melebihi salah satu batas, permintaan dijawab 400. Lampiran pesan tidak dihitung sebagai dokumen transaksi itu sendiri.
• Pesan berjalan melalui jalur INTERNAL dan EMAIL. Pada INTERNAL, pelanggan Didit lain melihat pesan di sisinya dalam pasangan tersebut. Pada EMAIL, pihak lawan menerima email dan menjawab di portal pengambilan. Jika email pemberitahuan tidak dapat dikirim, pesan tetap disimpan dan permintaan dijawab 201.
• Permintaan dijawab 409 dengan alasan di detail untuk transfer melalui TRP, GTR, TRUST, VerifyVASP, atau Sygna (protokol tersebut tidak membawa pesan), transfer yang belum memiliki pihak lawan, transfer INTERNAL yang datanya tidak cocok dengan pemegang dompet (tidak ada yang sampai ke penerima), transfer INTERNAL yang penerimanya belum membuktikan kendali atas dompet (di kedua sisi, sampai hal itu terjadi), transfer EMAIL yang pihak lawannya tidak lagi memiliki alamat email kepatuhan, dan transfer EMAIL yang tautan pengambilannya sudah kedaluwarsa atau transfernya sudah ditutup.
• Tidak ada webhook yang terpicu saat pihak lawan membalas. Baca endpoint pesan.
• Email yang memberi tahu pihak lawan tentang pesan baru dikirim dalam bahasa Inggris.

​

Buku alamat dompet

curl -X POST https://verification.didit.me/v3/travel-rule/wallet-addresses/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0xede2d7e4f5b097e6391ab6bbcf2f47a53f4778cb",
    "chain": "ETH",
    "holder_name": "Ana Diaz",
    "holder_vendor_data": "user-042",
    "self_declared": true
  }'

​

Mengimpor dompet secara massal

curl -X POST https://verification.didit.me/v3/travel-rule/wallet-addresses/import/ \
  -H "x-api-key: YOUR_API_KEY" \
  -F "file=@wallets.csv;type=text/csv"

address,address_hash,chain,memo,holder_name,holder_vendor_data
0xBeneficiaryWallet01,,ethereum,,Ana Diaz,user-042
,4f7d2e1c9b8a7f6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f2e,bitcoin,,,user-043
rExchangeSharedAddress01,,XRP,104729,Ana Diaz,user-042

​

Pengambilan email untuk pihak lawan yang tidak dapat dijangkau

• Ke alamat yang tepat. counterparty_vasp_email yang Anda kirim adalah satu-satunya penerima. Jika tidak, Didit menulis ke hingga tiga alamat: kontak pihak lawan yang belum memantul (kontak Anda sendiri lebih dulu, lalu kontak platform, yang pernah merespons lebih dulu), kemudian email kepatuhan entri direktori jika masih ada slot tersisa. Setiap alamat menerima emailnya sendiri.
• Atas nama Anda. Email berasal dari alamat Didit dengan nama “nama hukum Anda via Didit”, dalam bahasa yurisdiksi pihak lawan (bahasa Inggris jika tidak diketahui), dan tautan membuka halaman respons dalam bahasa tersebut. Anda tidak menerima salinan: pantau linimasa transfer.
• Dengan pengingat. Hingga pihak lawan merespons, Didit mengingatkannya 72, 24, dan 6 jam sebelum batas waktu, setidaknya 12 jam setelah permintaan atau pengingat terakhir, dan tidak pernah setelah batas waktu.
• Dengan pantulan yang ditangani. Pantulan atau keluhan spam menandai kontak yang dijangkau sebagai tidak valid beserta alasannya, dan linimasa transfer mencatatnya. Kontak platform kemudian tidak valid untuk setiap pelanggan Didit. Kontak aplikasi Anda sendiri hanya tidak valid untuk aplikasi Anda. Ketika pengiriman email Didit berhenti mengirim ke suatu alamat sama sekali (setelah pantulan permanen, keluhan spam, atau berhenti berlangganan), setiap kontak di alamat itu ditandai tidak valid (suppressed), dan kontak tersebut kembali valid ketika pengiriman ke alamat itu dilanjutkan. Ketika tidak ada alamat yang tersisa untuk dikirimi, transfer menjadi COUNTERPARTY_VASP_NOT_REACHABLE dengan alasan dari server email penerima di linimasanya. Pantulan permanen atau keluhan spam pada counterparty_vasp_email yang Anda kirim langsung menyebabkan hal ini, karena alamat itu satu-satunya penerima. Pantulan sementara (soft_bounce) pada alamat itu, atau pada email kepatuhan entri direktori, membiarkan permintaan tetap terbuka untuk pengingat.

curl https://verification.didit.me/v3/travel-rule/pickup/{token}/

{
  "reference": "33333333-4444-5555-6666-777777777777",
  "requested_at": "2026-07-05T10:00:00Z",
  "originator_vasp_name": "Origin CASP SL",
  "originator_vasp_lei": "529900EXAMPLEORIG001",
  "recipient_vasp_name": "Example Counterparty VASP",
  "language": "es",
  "amount": "0.250000000000000000",
  "currency": "ETH",
  "fiat_amount": "",
  "fiat_currency": "",
  "chain": "ETH",
  "beneficiary_wallet": "0xede2d7e4f5b097e6391ab6bbcf2f47a53f4778cb",
  "status": "AWAITING_COUNTERPARTY",
  "ivms_version": "ivms101.2023",
  "deadline_at": "2026-07-07T10:00:00Z",
  "reminders_sent": 0,
  "contact": "",
  "decline_reasons": ["data_mismatch", "not_our_customer", "wallet_not_hosted", "sanctions", "risk_appetite", "jurisdiction", "insufficient_data", "other"],
  "join_invitation": { "eligible": false, "url": "" },
  "originator_data": { "name": "Jane Doe", "wallet_address": "0x77ccff0cc624a53cd8b8d8703ced826710211ec7" },
  "beneficiary_data": { "name": "Ana Diaz", "wallet_address": "0xede2d7e4f5b097e6391ab6bbcf2f47a53f4778cb" },
  "ivms_request": {
    "originator": {
      "originatorPersons": [{ "naturalPerson": { "name": { "nameIdentifier": [{ "primaryIdentifier": "Doe", "secondaryIdentifier": "Jane", "nameIdentifierType": "LEGL" }] } } }],
      "accountNumber": ["0x77ccff0cc624a53cd8b8d8703ced826710211ec7"]
    },
    "beneficiary": {
      "beneficiaryPersons": [{ "naturalPerson": { "name": { "nameIdentifier": [{ "primaryIdentifier": "Diaz", "secondaryIdentifier": "Ana", "nameIdentifierType": "LEGL" }] } } }],
      "accountNumber": ["0xede2d7e4f5b097e6391ab6bbcf2f47a53f4778cb"]
    }
  },
  "data_masked": false
}

curl -X POST https://verification.didit.me/v3/travel-rule/pickup/{token}/respond/ \
  -H "Content-Type: application/json" \
  -d '{"decision": "accept", "beneficiary_name": "Ana Diaz"}'

​

Deposit yang belum dipasangkan

curl "https://verification.didit.me/v3/travel-rule/unmatched/" \
  -H "x-api-key: YOUR_API_KEY"

curl -X POST "https://verification.didit.me/v3/travel-rule/unmatched/{transaction_uuid}/match/" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"transaction_id": "<uuid of the received message transaction>"}'

​

Pendaftaran sunrise setelah deposit

curl -X POST https://verification.didit.me/v3/travel-rule/inbound/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chain": "eth",
    "txid": "0xf103cfc37f6d390b61827987b9dc631b5e1d2bfeb008a780c1e38047ae5d557b",
    "wallet_address": "0xede2d7e4f5b097e6391ab6bbcf2f47a53f4778cb",
    "amount": "500.00",
    "currency": "USDC",
    "originator_data": { "name": "Carlos Ruiz", "wallet_address": "0x77ccff0cc624a53cd8b8d8703ced826710211ec7" },
    "beneficiary_data": { "name": "Ana Diaz" },
    "originating_vasp": {
      "name": "Northwind Digital Assets Ltd",
      "lei": "5493001KJTIIGC8Y1R12",
      "travel_address": "tareGfwAzkySLkFzcqr7AKno3K4VsT3jayMwPvj3ovbFZHzpayHLmgCrAMoLqjfCYRPpvLqr9dSr2VVTFAncwChcMjL4AheNuHCJM8NRcUg"
    }
  }'

• Tidak ada entri yang cocok -> ON_HOLD. Selesaikan dengan POST .../travel-rule/ownership/: confirmed: true menambahkan dompet ke buku alamat Anda sebagai terverifikasi dan menjalankan pencocokan nama; jika cocok, transfer berpindah ke COMPLETED, lalu FINISHED.
• Entri ada tetapi kepemilikan belum terbukti -> UNCONFIRMED_OWNERSHIP.
• Nama penerima tidak cocok dengan holder_name pada entri -> COUNTERPARTY_MISMATCHED_DATA.
• Entri terverifikasi dan nama cocok -> COMPLETED, lalu langsung FINISHED (deposit sudah diselesaikan).

{
  "transaction_id": "44444444-5555-6666-7777-888888888888",
  "txn_id": "tr-in-0xf103cfc37f6d390b61827987b9dc631b5e1d2bfeb008a780c1e38047ae5d557b-6151d81b366e",
  "created": true,
  "travel_rule": {
    "uuid": "55555555-6666-7777-8888-999999999999",
    "status": "FINISHED",
    "direction": "INBOUND",
    "rail": null,
    "protocol": null,
    "ivms_version": "ivms101.2023",
    "required": true,
    "ownership_confirmed": true,
    "deadline_at": null,
    "timeline": [
      { "status": "COMPLETED", "at": "2026-07-06T10:15:02.114208+00:00", "detail": "matched verified wallet address book entry" },
      { "status": "FINISHED", "at": "2026-07-06T10:15:02.131544+00:00", "detail": "on-chain deposit already settled" }
    ],
    "counterparty_vasp": null,
    "originator_data": { "name": "Carlos Ruiz", "wallet_address": "0x77ccff0cc624a53cd8b8d8703ced826710211ec7" },
    "beneficiary_data": { "name": "Ana Diaz", "wallet_address": "0xede2d7e4f5b097e6391ab6bbcf2f47a53f4778cb", "chain": "eth" },
    "created_at": "2026-07-06T10:15:02.087412Z"
  }
}

​

Widget verifikasi kepemilikan dompet

​

Direktori

curl "https://verification.didit.me/v3/travel-rule/vasps/?search=counterparty" \
  -H "x-api-key: YOUR_API_KEY"

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "0d6f3c2a-6a1e-4c55-9a39-1f2b0c7d8e91",
      "kind": "directory",
      "name": "Example Counterparty VASP",
      "lei": "529900EXAMPLECPTY001",
      "jurisdiction": "DE",
      "domains": ["counterparty.example"],
      "reachable": true,
      "aliases": [{ "name": "Example Counterparty", "kind": "trading_name" }],
      "networks": [
        {
          "network": "GTR",
          "code": "EXAMPLE01",
          "listed_name": "Example Counterparty VASP",
          "country": "DE",
          "verified_at": "2026-10-12T09:30:00Z",
          "last_seen_at": "2026-10-12T09:30:00Z",
          "source": "staff"
        }
      ],
      "routes": [
        { "rail": "GTR", "status": "unavailable", "reason": "no_membership", "via": "" },
        { "rail": "EMAIL", "status": "available", "reason": "", "via": "contact" }
      ],
      "umbrella": null,
      "entities": [],
      "contacts": [
        {
          "id": "6c1f9b8e-2d4a-4f7e-8b3c-5a9d0e1f2a3b",
          "email": "travelrule@counterparty.example",
          "name": "Travel Rule desk",
          "source": "staff",
          "scope": "platform",
          "verified_at": null
        }
      ],
      "dd_status": "NOT_STARTED",
      "dd_score": 62,
      "dd_score_breakdown": {
        "jurisdiction": { "points": 25.0, "max": 25, "reason": "jurisdiction_not_high_risk", "detail": "DEU is not on the high-risk jurisdiction list" },
        "verification": { "points": 3.8, "max": 15, "reason": "dd_status_not_started", "detail": "due diligence status NOT_STARTED" },
        "protocol": { "points": 6.0, "max": 15, "reason": "email_only", "detail": "reachable over the email fallback only" },
        "lei": { "points": 10.0, "max": 10, "reason": "lei_valid", "detail": "valid LEI on record" },
        "history": { "points": 5.0, "max": 10, "reason": "no_history", "detail": "no exchange history" },
        "essentials": { "points": 7.5, "max": 15, "reason": "no_essential_checks", "detail": "no decided essential check yet" },
        "responsiveness": { "points": 5.0, "max": 10, "reason": "responsiveness_unknown", "detail": "0 decided recent requests, too few to judge" }
      },
      "dd_assessed_at": "2026-10-12T09:30:00Z",
      "dd_score_semantic": "higher_is_safer",
      "risk_level": "MEDIUM",
      "responsiveness": { "status": "UNKNOWN", "answered": 0, "total": 0, "computed_at": "2026-10-12T09:30:00Z" },
      "essential_checks": {},
      "reachable_rails": ["GTR", "EMAIL"],
      "is_didit_customer": false,
      "decision": {
        "decision": "APPROVED",
        "reason": "Licensed in DE",
        "decided_by": "",
        "updated_at": "2026-10-14T10:05:00Z",
        "inherited_from": null
      },
      "entity_screening": {
        "id": "7a1d2c3b-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
        "status": "Approved",
        "total_hits": 0,
        "score": null,
        "screened_at": "2026-10-14T09:58:00Z",
        "fresh": true,
        "flagged": false
      },
      "questionnaires": []
    }
  ]
}

​

Rute

• TRP ketika entri memiliki endpoint TRP yang diverifikasi oleh direktori.
• GTR, TRUST, VERIFYVASP, SYGNA ketika sebuah jaringan mencantumkan VASP di bawah suatu kode. Rute hanya available jika aplikasi Anda dapat mengirim melalui jaringan tersebut saat ini (via: own_membership untuk keanggotaan terhubung milik Anda sendiri, via: didit_membership untuk keanggotaan Didit). Jika tidak, rute berstatus unavailable dengan reason: no_membership atau reason: network_switched_off, dan tidak pernah ditampilkan sebagai cara untuk menjangkau VASP. Keanggotaan jaringan Didit belum aktif, sehingga saat ini rute jaringan hanya tersedia melalui keanggotaan yang Anda hubungkan di Marketplace.
• EMAIL ketika ada kontak kepatuhan untuk entri tersebut.
• INTERNAL untuk anggota jaringan Didit.

​

Merek dan entitasnya

​

Kontak

curl -X POST https://verification.didit.me/v3/travel-rule/counterparty-contacts/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"counterparty": "0d6f3c2a-6a1e-4c55-9a39-1f2b0c7d8e91", "email": "compliance@counterparty.example", "name": "Compliance desk"}'

• GET /v3/travel-rule/counterparty-contacts/ mencantumkan setiap kontak yang dapat dikirimi email oleh aplikasi Anda, termasuk kontak platform dan kontak yang gagal dikirimi email, dari yang terbaru, dipaginasi dengan limit dan offset. Filter dengan ?counterparty= dan id entri direktori; nilai yang bukan UUID merespons 400.
• POST menambahkan kontak pribadi (counterparty, email, dan name opsional) dan merespons 201. Menambahkan alamat yang sudah tercatat untuk entri tersebut di antara kontak Anda akan mengembalikan kontak itu. Entri yang tidak dikenal merespons 400 ("No directory entry with this id.").
• DELETE /v3/travel-rule/counterparty-contacts/{contact_uuid}/ menghapus salah satu kontak milik Anda (204). Kontak platform tidak dapat dihapus dan merespons 404.

​

Cara entri masuk ke direktori

• Registri interim MiCA dari ESMA untuk penyedia layanan aset kripto, dibaca setiap minggu: nama, LEI, dan negara anggota asal setiap penyedia.
• Direktori publik TRISA, dibaca setiap minggu: identitas setiap anggota, negaranya, dan daftarnya di TRISA. Daftar yang tidak lagi ditampilkan oleh direktori selama tiga minggu akan dihapus.
• Registri LEI global mengisi LEI, nama hukum lain, dan negara sebuah entri, serta menemukan LEI sebuah entri berdasarkan nama hukum persisnya di negaranya.
• Atribusi analitik blockchain menambahkan atau mencocokkan VASP yang memiliki dompet tujuan, dan menyimpan nama yang diatribusikan sebagai alias.
• Staf Didit mengkurasi entri: pengenal perutean dan daftar jaringan yang telah mereka verifikasi, kontak kepatuhan, alias, merek beserta entitasnya, duplikat yang digabungkan, dan entri yang disembunyikan.

​

Jaringan Didit

• aplikasi Anda berada di lingkungan produksi (bukan sandbox) dan Travel Rule aktif;
• is_discoverable bernilai true dan legal_name sudah diisi;
• compliance_email sudah diisi dan dikonfirmasi: kirim konfirmasi dengan POST /v3/travel-rule/settings/compliance-email/confirmation/ dan buka tautan yang dikirim lewat email. Mengubah alamat memerlukan konfirmasi baru;
• Didit belum menandai aplikasi sebagai aplikasi uji coba, demo, atau internal.

​

Pengenal perutean

​

Uji tuntas pihak lawan

• Penilaian bersama. Setiap entri direktori memiliki skor uji tuntas, tingkat risiko, status responsivitas, dan laporan pemeriksaan esensial. Didit menghitungnya dari data platform itu sendiri, sehingga setiap pelanggan melihat nilai yang sama.
• Catatan Anda sendiri. Keputusan Anda terhadap VASP, skrining sanksi dan media negatif terhadapnya, serta kuesioner uji tuntas yang Anda pertukarkan dengannya hanya menjadi milik aplikasi Anda. Pelanggan lain tidak pernah melihatnya, dan catatan tersebut tidak pernah mengubah entri bersama.

​

Skor dan tingkat risiko

​

Pemeriksaan esensial

​

Responsivitas

{ "status": "UNRESPONSIVE", "answered": 0, "total": 6, "computed_at": "2026-10-12T09:30:00Z" }

• Dihitung: permintaan yang dikirim melalui jalur jaringan atau protokol, dan permintaan yang dikirim melalui email ke alamat bersama, yaitu alamat kepatuhan entri atau kontak platform.
• Tidak pernah dihitung: permintaan yang dikirim melalui email ke alamat yang dimasukkan oleh seorang pelanggan, atau ke kontak pribadi pelanggan. Pertukaran tersebut tetap berada dalam riwayat transfer pelanggan itu dan tidak pernah memberi label pada VASP untuk pengguna lain.
• Dijawab: COMPLETED, FINISHED, COUNTERPARTY_VASP_GENERAL_DECLINE, atau COUNTERPARTY_MISMATCHED_DATA. Penolakan atau ketidaksesuaian data adalah jawaban: VASP tersebut telah merespons.
• Tidak dijawab: EXPIRED.
• Bukan keduanya: setiap status lain. Permintaan CANCELLED adalah tindakan pengirim sendiri, COUNTERPARTY_VASP_NOT_REACHABLE dapat menjadi kegagalan di sisi pengirim, dan permintaan yang masih berjalan belum diputuskan.

​

Keputusan Anda terhadap pihak lawan

curl -X PUT https://verification.didit.me/v3/travel-rule/vasps/0d6f3c2a-6a1e-4c55-9a39-1f2b0c7d8e91/decision/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"decision": "BLOCKED", "reason": "Unlicensed in its home jurisdiction"}'

{
  "decision": {
    "decision": "BLOCKED",
    "reason": "Unlicensed in its home jurisdiction",
    "decided_by": "",
    "updated_at": "2026-10-14T10:05:00Z",
    "inherited_from": null
  }
}

• Keputusan bersifat privat bagi aplikasi Anda: pelanggan lain tidak pernah melihatnya, dan keputusan itu tidak pernah mengubah entri bersama.
• Keputusan tidak mengubah apa pun dengan sendirinya dan tidak pernah mengubah cara transfer dirutekan. Keputusan itu sampai ke transaksi Anda melalui kolom aturan counterparty_dd_status: pasang preset, atau tulis aturan Anda sendiri yang memakai kolom tersebut.
• Keputusan terhadap sebuah merek berlaku untuk setiap entitas miliknya yang belum punya keputusan sendiri, dan entitas tersebut menampilkan merek itu di inherited_from. Keputusan terhadap entitas menggantikan keputusan merek untuk entitas tersebut.
• GET mengembalikan keputusan yang berlaku, atau {"decision": null}. DELETE menghapus keputusan Anda sendiri dan mengembalikan keputusan yang berlaku setelahnya: keputusan merek untuk sebuah entitas, jika tidak ada maka null. Endpoint ini menjawab 404 ketika aplikasi Anda tidak memiliki keputusan sendiri terhadap pihak lawan tersebut.
• reason bersifat opsional, maksimal 255 karakter, dan setiap PUT menggantinya. decided_by adalah pengguna konsol yang membuat atau terakhir mengubah keputusan, dan kosong jika keputusan dibuat oleh kunci API.

​

Skrining pihak lawan

curl -X POST https://verification.didit.me/v3/travel-rule/vasps/0d6f3c2a-6a1e-4c55-9a39-1f2b0c7d8e91/screening/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"refresh": false}'

{
  "outcome": "screened",
  "screening": {
    "id": "7a1d2c3b-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
    "status": "In Review",
    "total_hits": 2,
    "score": 85.0,
    "screened_at": "2026-10-14T09:58:00Z",
    "fresh": true,
    "flagged": true
  }
}

• Penagihan. Setiap skrining baru dikenakan harga Skrining AML Perusahaan milik organisasi Anda. GET /v3/travel-rule/vasps/{vasp_id}/screening/ mengembalikan price, fresh_days, dan apakah skrining enabled, tanpa biaya. Skrining yang usianya kurang dari 30 hari dianggap masih baru: POST mengembalikannya lagi dengan 200 dan outcome: reused serta tidak menagih apa pun, kecuali Anda mengirim refresh: true. Skrining baru menjawab 201 dengan outcome: screened. Aplikasi sandbox tidak pernah diskrining atau ditagih.
• Skrining otomatis. Ketika skrining aktif, Didit juga menskrining pihak lawan yang dituju oleh pertukaran keluar saat pertukaran itu dimulai, sebelum aturan Anda dievaluasi terhadap transaksi, dengan penggunaan ulang dan penagihan yang sama. Penolakan atau kegagalan di tahap ini tidak pernah menggagalkan transfer.
• Hasil. status bernilai Approved ketika tidak ada kecocokan yang mungkin perlu ditinjau, dan In Review atau Declined untuk kecocokan yang mungkin terkait sanksi atau media negatif. flagged bernilai true selama skrining baru berstatus In Review atau Declined.
• Dampak. Selama skrining terakhir Anda terhadap pihak lawan ditandai dan skrining tetap aktif, counterparty_risk_level bernilai HIGH di aturan Anda, sehingga preset travel-rule-counterparty-high-risk, setelah dipasang, menahan transfernya. risk_level bersama di direktori tidak berubah.
• Privasi. Skrining bersifat privat bagi aplikasi Anda: pelanggan lain tidak pernah melihatnya, dan skrining itu tidak pernah mengubah entri bersama. Direktori menampilkan skrining terakhir Anda sebagai entity_screening.
• Penolakan. 409 ketika skrining nonaktif, untuk aplikasi sandbox, atau ketika skrining pihak lawan yang sama sedang berjalan. 403 dengan code: insufficient_credits ketika saldo Anda tidak cukup untuk menutup harga. 502 ketika skrining tidak dapat diselesaikan. Tidak satu pun dari penolakan ini menagih apa pun.

​

Kuesioner uji tuntas

curl -X POST https://verification.didit.me/v3/travel-rule/vasps/0d6f3c2a-6a1e-4c55-9a39-1f2b0c7d8e91/questionnaires/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sent_to": "travelrule@counterparty.example"}'

{
  "id": "3f9e8d7c-6b5a-4c3d-9e2f-1a0b9c8d7e6f",
  "status": "SENT",
  "form_version": "1",
  "sent_to": "travelrule@counterparty.example",
  "sent_at": "2026-10-14T10:00:00Z",
  "expires_at": "2026-11-13T10:00:00Z",
  "answered_at": null,
  "valid_until": null,
  "current": false,
  "answers": {}
}

• Tujuan pengiriman. sent_to harus berupa alamat kepatuhan yang tercatat: untuk entri direktori, alamat kepatuhannya atau kontak yang dapat dilihat aplikasi Anda di contacts; untuk anggota jaringan Didit, email kepatuhan yang sudah dikonfirmasi. Jika dihilangkan, alamat yang digunakan adalah alamat tempat email Travel Rule ke pihak lawan dikirim: kontak Anda terlebih dahulu, lalu kontak platform, lalu alamat kepatuhan entri tersebut. Didit tidak pernah mengirim kuesioner ke tempat lain, dan mengembalikan 400 ketika pihak lawan tidak memiliki alamat kepatuhan yang tercatat.
• Menjawab. Tautan membuka /v3/travel-rule/questionnaires/{token}/, sebuah halaman untuk seseorang di pihak lawan yang tidak memerlukan akun maupun kunci API. Mereka menjawab setiap pertanyaan, hingga 2.000 karakter per pertanyaan (N/A jika tidak berlaku), dan mengirimkannya satu kali. Pihak lawan juga dapat mengirim {"answers": {"<question id>": "<answer>"}} ke tautan yang sama. Tautan yang sudah digunakan, diganti, atau melewati tenggatnya akan menampilkan halaman kedaluwarsa. Email dan halaman diterjemahkan; pertanyaannya sendiri selalu dalam bahasa Inggris, sehingga maknanya tidak berubah antarbahasa.
• Tenggat waktu. Pihak lawan memiliki 30 hari untuk menjawab (expires_at). Jawaban tetap berlaku selama 365 hari (valid_until), dan current bernilai true sampai saat itu. Kuesioner yang belum dijawab dan melewati tenggatnya, serta jawaban yang melewati masa berlakunya, menjadi EXPIRED.
• Satu kuesioner terbuka per pihak lawan. Pengiriman baru menggantikan kuesioner Anda sebelumnya yang belum dijawab kepada pihak lawan yang sama: kuesioner itu menjadi EXPIRED dan tautannya berhenti berfungsi. Satu email per menit dapat dikirim ke sebuah alamat; pengiriman yang lebih cepat mengembalikan 429.
• Membaca jawaban. GET /v3/travel-rule/vasps/{vasp_id}/questionnaires/ mencantumkan kuesioner Anda kepada pihak lawan, dari yang terbaru, dengan answers yang memiliki kunci berupa ID pertanyaan setelah dijawab. Direktori menampilkannya sebagai questionnaires. Data ini bersifat privat bagi aplikasi Anda.

​

Transfer dengan satu pihak lawan

​

Kebijakan sunrise dan tidak responsif

curl -X PUT https://verification.didit.me/v3/travel-rule/settings/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sunrise_policy": "PROCEED", "non_responsive_policy": "HOLD"}'

1. sunrise_policy, jika diatur dan yurisdiksi pihak lawan ada di sunrise_jurisdictions.
2. non_responsive_policy, jika diatur dan pihak lawan berstatus UNRESPONSIVE.
3. timeout_outcome dalam kasus lainnya, termasuk transfer ke anggota jaringan Didit atau ke pihak lawan yang tidak memiliki entri direktori.

​

Kolom aturan dan preset

​

Webhook

{
  "event_id": "9c0c8b8a-1111-4222-9333-666666666666",
  "webhook_type": "travel_rule.status.updated",
  "timestamp": 1774970000,
  "created_at": 1774970000,
  "application_id": "11111111-2222-3333-4444-555555555555",
  "environment": "live",
  "transaction_id": "22222222-3333-4444-5555-666666666666",
  "txn_id": "trv-2026-07-05-001",
  "travel_rule_status": "COMPLETED",
  "rail": "INTERNAL",
  "direction": "OUTBOUND"
}

​

Harga

• Berlaku untuk transaksi travelRule keluar pada aplikasi dengan Travel Rule aktif, yang jumlahnya sama dengan atau lebih besar dari threshold_amount Anda, sehingga Didit memulai pertukaran terkelola untuknya. Transfer ke dompet swakelola, atau ke dompet terverifikasi milik pengguna Anda, juga termasuk, karena bukti kepemilikan adalah pertukarannya.
• Setiap transaksi keluar lain yang membawa data Travel Rule ditagih sebagai Skrining Transaksi standar, yang disertakan dalam paket Anda hingga batas transaksi bulanan dan dihargai $0.001 di atas batas tersebut: transfer di bawah ambang batas Anda, pembayaran Lightning yang tidak berlaku bagi Travel Rule, dan transfer yang dicatat secara pasif ketika Travel Rule nonaktif. Sebuah transaksi hanya ditagih pada salah satu dari dua baris, tidak pernah keduanya.
• Transaksi travelRule masuk tidak membawa biaya Travel Rule maupun biaya pemantauan: leg masuk yang Didit buat pada aplikasi penerima melalui INTERNAL rail, permintaan TRP masuk, dan registrasi setelah deposit.
• Aplikasi yang bergabung dengan Travel Rule secara gratis tidak membayar kedua biaya untuk transaksi travelRule keluar sampai Anda mengaktifkan penagihan keluar dengan POST /v3/travel-rule/workspace/billing/; menerima transfer tetap gratis.
• Aplikasi sandbox tidak pernah dikenakan biaya.
• Biaya Travel Rule tercantum sebesar $0.02 dan Skrining Transaksi sebesar $0.001 di atas batas Anda. Setiap transaksi dikenakan harga dari baris yang ditagihnya.
• Jika skrining AML/Skrining Dompet juga berjalan pada transaksi yang sama (misalnya deposit masuk dengan currency_kind: "crypto" dan pemantauan aktif), biaya tersebut ditagih terpisah dengan tarif standar Wallet Verification & Screening, dan tidak termasuk dalam biaya Travel Rule.
• Skrining pihak lawan bersifat opsional dan ditagih terpisah, dengan harga Company AML Screening per skrining; skrining yang berusia kurang dari 30 hari digunakan kembali tanpa biaya. Keputusan, kuesioner, dan penilaian uji tuntas di direktori tidak dikenakan biaya.

​

Harga atribusi

• Pemantauan kripto sudah memindai dompet pada transaksi ini - hasil yang tersimpan digunakan kembali. Satu panggilan analitik, satu biaya Wallet Verification & Screening (biaya yang sudah dikenakan oleh pemantauan kripto). Atribusi tidak menambah apa pun.
• Pemantauan kripto tidak berjalan - Didit melakukan panggilan analitik yang diperlukan sekali dan meneruskan nilai penuhnya: transaksi dikenakan tarif standar Wallet Verification & Screening ($0.15 dengan analitik yang dikelola Didit) dan menerima keluaran skrining kripto lengkap sebagai imbalannya, yaitu skor risiko, kategori risiko dompet, dan snapshot jaringan, bukan hanya nama VASP. Item penggunaan ditandai dengan pemicu travel_rule_attribution agar biaya tersebut dapat dijelaskan.
• Kunci analitik milik Anda sendiri - biaya platform yang sama yang berlaku untuk pemantauan kripto dengan kunci Anda sendiri juga berlaku di sini ($0.02 per panggilan). Penyedia Anda menagih pencarian yang mendasarinya langsung kepada Anda.
• Pencarian yang gagal tidak pernah dikenakan biaya, pengiriman ulang menggunakan kembali atribusi yang tercatat tanpa panggilan atau biaya baru, dan aplikasi sandbox tidak pernah dikenakan biaya.

​

Paket aturan EU TFR

​

Mengapa ini lebih baik di satu platform

• Data terverifikasi yang sudah tersedia. Subjek setiap transfer ditautkan melalui vendor_data ke profil KYC yang diverifikasi Didit saat onboarding (OCR dokumen, liveness, pencocokan wajah), sehingga Anda dapat membangun originator_data dari kolom yang sudah terverifikasi di platform yang sama. Untuk pengguna dengan verifikasi KYC yang disetujui, Didit mengirimkan identitas yang sudah terverifikasi, bukan nilai yang Anda ketik (lihat Data terverifikasi dan asal-usul data).
• Biometrik tambahan untuk transfer berisiko. Aturan dapat menahan transfer bernilai tinggi apa pun sampai pengguna lolos pemeriksaan ulang biometrik terhadap wajah yang diambil saat onboarding. Ini adalah jawaban terkuat terhadap pengambilalihan akun pada saat penarikan dana. Lihat contoh kasus.
• Satu graf perangkat. Transfer yang dikirim melalui SDK membawa informasi perangkat yang sama seperti sesi KYC, sehingga “perangkat baru + jumlah besar + penerima baru” cukup menjadi satu aturan, tanpa perlu join data warehouse.
• Skrining, aturan, kasus, dan pertukaran di satu tempat. Skrining dompet yang mengidentifikasi VASP pihak lawan adalah skrining yang sama dengan yang dilihat aturan dan analis Anda, jadi cukup satu biaya, satu konsol, dan satu jejak audit.
• Harga yang dipublikasikan. $0.02 per pertukaran keluar, tanpa tingkatan berdasarkan volume, tanpa panggilan penjualan.

​

FAQ

​

Cara kerja pertukaran

​

Harga dan lisensi

​

Operasional dan data

​

Langkah berikutnya