API Verifikasi Cédula Kolombia (ID)

Meng-onboarding pengguna di Kolombia berarti mengonfirmasi bahwa mereka adalah orang yang mereka klaim. Memverifikasi data Cédula de Ciudadanía Kolombia melalui penyedia verifikasi identitas Kolombia Didit. Dokumen atau detail yang diketik hanya membuktikan bahwa data ada — bukan bahwa data itu asli atau milik orang di hadapan Anda. Verifikasi Cédula Kolombia menutup celah itu dengan memeriksa data terhadap registri identitas resmi pemerintah negara tersebut. Panduan ini menjelaskan apa yang dilakukan pemeriksaan, detail teknis yang tepat, dan cara mengintegrasikannya dalam hitungan menit.

Poin-poin penting:

• Apa yang diperiksa — Verifikasi Cédula Kolombia memvalidasi ID nasional terhadap registri identitas resmi pemerintah negara tersebut.
• Apa yang Anda dapatkan kembali — match_type yang dinormalisasi ditambah hasil tingkat bidang yang dapat Anda arahkan langsung ke logika persetujuan / peninjauan / penolakan.
• Mengapa itu penting — Dokumen dapat dipalsukan; catatan registri tidak bisa. Memvalidasi ID terhadap sumber pemerintah yang berwenang mengonfirmasi bahwa pemegang adalah nyata dan diidentifikasi dengan benar.
• Cara menggunakannya — satu POST ke endpoint validasi database Didit, atau modul alur kerja tanpa kode. $0,20 per kueri konklusif, hasil dalam hitungan detik.

Apa yang divalidasi oleh Verifikasi Cédula Kolombia

Memverifikasi data Cédula de Ciudadanía Kolombia melalui penyedia verifikasi identitas Kolombia Didit. Didit mengeksposnya melalui satu endpoint sehingga Anda dapat memverifikasi data yang dikirimkan terhadap registri identitas resmi pemerintah negara tersebut dan menerima hasil yang terstruktur, dinormalisasi — bukan dump registri mentah yang harus Anda uraikan sendiri.

Respons konklusif mengembalikan source_data yang cocok dan blok validation per bidang, sehingga mesin risiko Anda mendapatkan keputusan yang jelas dan dapat dibaca mesin.

Mengapa itu penting

Dokumen dapat dipalsukan; catatan registri tidak bisa. Memvalidasi ID terhadap sumber pemerintah yang berwenang mengonfirmasi bahwa pemegang adalah nyata dan diidentifikasi dengan benar.

Untuk bisnis yang diatur di Kolombia — fintech, platform kripto, pemberi pinjaman, pasar, dan operator game — memeriksa terhadap sumber yang berwenang menghasilkan catatan yang dapat dipertahankan dan diaudit bahwa identitas dikonfirmasi di sumbernya, tidak hanya diambil dari formulir atau foto.

Detail teknis

Didit mengekspos layanan ini melalui endpoint validasi database terpadu. Ini adalah satu POST — tidak diperlukan SDK.

Endpoint

POST /v3/database-validation/

Parameter permintaan

Parameter	Tipe	Wajib	Deskripsi
issuing_state	string	Ya	Kode negara ISO 3166-1 alpha-3. Gunakan COL.
services	string	Ya	Pengidentifikasi layanan. Gunakan col_cedula.
personal_number	string	Ya	Nomor pribadi.
first_name	string	Tidak	Nama depan (pemeriksaan silang opsional).
last_name	string	Tidak	Nama belakang (pemeriksaan silang opsional).

Contoh permintaan

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=COL" \
  -F "services=col_cedula" \
  -F "personal_number=1111111"

Contoh respons (kecocokan konklusif)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "COL",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "col_cedula",
      "service_name": "Kolombia - Verifikasi Cédula",
      "source_data": {
        "document_type": "sample_value",
        "first_name": "John",
        "full_name": "John Doe",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Kinerja dan penagihan

• Latensi: biasanya beberapa detik.
• Biaya: $0,20 per kueri konklusif. Anda hanya ditagih berdasarkan hasil yang konklusif — tidak ada biaya untuk waktu henti sumber, bidang yang hilang, atau penolakan pra-sumber.
• Keandalan: berjalan pada infrastruktur Didit dengan target waktu aktif triwulanan 99,9%.

Kasus penggunaan

• Fintech & neobank — konfirmasi pemegang akun yang nyata dan dapat diverifikasi sebelum membuka dompet atau memberikan kredit di Kolombia.
• Kripto & Web3 — memenuhi persyaratan onboarding VASP dengan bukti identitas sumber yang berwenang.
• Pemberian pinjaman — mengurangi penipuan identitas sintetis dan pihak pertama dengan data yang diverifikasi sumber.
• Pasar & platform gig — verifikasi pengguna terhadap data yang berwenang, bukan hanya formulir yang dilaporkan sendiri.
• iGaming — memenuhi pemeriksaan identitas dan kelayakan untuk pemain Kolombia dengan jejak audit.

Cara berintegrasi dengan Didit

Anda dapat menjalankan Verifikasi Cédula Kolombia dengan dua cara:

1. Alur kerja tanpa kode. Di Didit Business Console, buka Pembangun Alur Kerja, tambahkan modul Validasi Database, pilih Kolombia → Verifikasi Cédula Kolombia, dan aktifkan. Pengguna yang cocok akan diarahkan secara otomatis — tidak diperlukan rekayasa.
2. API Langsung. Panggil endpoint /v3/database-validation/ yang ditunjukkan di atas dengan services=col_cedula. Baca match_type dan blok validation per bidang untuk mendorong logika persetujuan / peninjauan / penolakan Anda.

Setiap akun Didit menyertakan 500 verifikasi gratis per bulan, sehingga Anda dapat menguji alur penuh secara end-to-end sebelum Anda membayar untuk satu kueri.

Pertanyaan yang sering diajukan

Apa yang dikonfirmasi oleh pemeriksaan Verifikasi Cédula Kolombia?

Ini memvalidasi data yang dikirimkan terhadap registri identitas resmi pemerintah negara tersebut dan mengembalikan hasil kecocokan yang dinormalisasi, sehingga Anda mengetahui apakah ID nasional ada di sumber yang berwenang dan bidang mana yang cocok.

Apa yang terjadi jika sumber tidak tersedia untuk sementara waktu?

Anda tidak dikenakan biaya. Penagihan hanya berlaku untuk hasil yang konklusif — waktu henti sumber, bidang yang hilang, dan penolakan pra-sumber gratis.

Seberapa cepat pemeriksaannya?

Validasi database biasanya kembali dalam beberapa detik, sehingga cocok dengan alur onboarding real-time.

Apakah saya memerlukan SDK?

Tidak. Pemeriksaan adalah satu POST HTTPS ke satu endpoint. Anda juga dapat menghubungkannya ke alur kerja tanpa kode di Business Console.

Siap untuk memulai?

Validasi ID nasional Kolombia pertama Anda hari ini.

• Baca referensi API: Verifikasi Cédula Kolombia
• Lihat semua validasi database: Harga & cakupan Validasi Database
• Mulai membangun: Buat akun Didit gratis — 500 verifikasi sebulan, gratis.