> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# API Bukti Alamat: Verifikasi Tagihan Utilitas

> Verifikasi alamat tempat tinggal dengan ekstraksi AI Didit dari tagihan utilitas, rekening koran, & dokumen resmi. Bayar per panggilan $0.20.

Verifikasi Bukti Alamat (PoA) memungkinkan Anda memverifikasi alamat tempat tinggal pengguna melalui dokumen resmi. Fitur ini menyederhanakan proses verifikasi alamat, sehingga pengguna dapat mengambil foto atau mengunggah dokumen yang mengonfirmasi alamat mereka.

Prompt Integrasi Bukti Alamat
        Salin prompt ke papan klip



      
      

\<pre>

\````# Goal
Integrate Didit Proof of Address (utility bill, bank statement, government letter OCR + cross-checks) into your app. Pick ONE mode.

\# Mode A — Session-based
Use this when the user uploads the document in a hosted Didit flow.

1\. Add the PROOF_OF_ADDRESS feature to the workflow (Business Console or POST /v3/workflows/). Configure: poa_languages_allowed, poa_document_age_months, and the per-risk actions (poa_issuer_not_identified_action, poa_name_mismatch_action, poa_address_mismatch_action, poa_document_expired_action, poa_language_not_allowed_action).
2\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
3\. Open session.url for the user (or mount the Web/Mobile SDK).
4\. Fetch the decision — GET /v3/session/{sessionId}/decision/ or subscribe to session.status.updated.

Decision surface: `poa_verifications[]` array on the decision payload.

\# Mode B — Standalone API (server-to-server)
Use when you already have the document and want a one-shot check decoupled from a hosted flow.

POST https://verification.didit.me/v3/poa/
multipart/form-data — x-api-key: YOUR_API_KEY

Latency: OCR typically takes 5–15s (up to ~30s for multi-page PDFs). Use a client timeout of **at least 45s**. Max upload 15 MB (PDF, JPG, PNG, TIFF, WebP). Encrypted PDFs require `document_password` or you get HTTP 400 with `code: "encrypted_pdf"`.

curl example:
\```bash
curl -X POST 'https://verification.didit.me/v3/poa/' \
-H "x-api-key: $DIDIT_API_KEY" \
-F "document=@./utility-bill.pdf" \
-F "expected_address=Av. Monseñor Tavella 3396, Salta" \
-F "expected_country=ARG" \
-F "expected_first_name=Sophia" \
-F "expected_last_name=Martinez" \
-F "poa_languages_allowed=en,es" \
-F "vendor_data=user-1234"
\```
Returns: { request_id, poa: { status, parsed_address, document_type, issuer, issue_date, language, document_metadata: { overlay_manipulation }, warnings: [...] } }.

\# Status enum (per poa_verifications[].status / poa.status)
"Not Started" | "In Progress" | "Approved" | "In Review" | "Declined" | "Abandoned" | "Kyc Expired"

\# Warnings (LogWarningChoices.PROOF_OF_ADDRESS)
warnings[] risk codes include:
ISSUER_NOT_IDENTIFIED, LANGUAGE_NOT_ALLOWED, DOCUMENT_EXPIRED, DOCUMENT_TOO_OLD, NAME_MISMATCH, ADDRESS_MISMATCH, COUNTRY_MISMATCH, OVERLAY_MANIPULATION_DETECTED, UNREADABLE_DOCUMENT.
Full catalogue: /core-technology/proof-of-address/warnings-proof-of-address.

\# Failure modes to handle
\- HTTP 400 with `code: "encrypted_pdf"` — the PDF is password-protected (or the password is wrong); supply the right `document_password` or a decrypted copy.
\- HTTP 400 with `code: "document_unreadable"` — the file is corrupt or cannot be opened; ask the user for a different file. Branch on `code`, not on the message text.
\- HTTP 503 with `code: "document_processing_busy"`: too many documents are being processed, so the upload was not processed. Send the same file again after the `Retry-After` seconds.
\- HTTP 403 — out of credits.
\- Client timeout — bump to 45s+ before retrying.
\- status="Declined" with NAME_MISMATCH / ADDRESS_MISMATCH — the extracted fields don't match expected_*; do not approve.
\- OVERLAY_MANIPULATION_DETECTED — PDF forensics caught edits; reject.

\# See also
\- Canonical schema: /reference/data-models#proof-of-address
\- Per-feature report: /core-technology/proof-of-address/report-proof-of-address
\- Risk catalogue: /core-technology/proof-of-address/warnings-proof-of-address
\- Full integration playbook: /integration/integration-prompt````

\</pre>



      
      

Tempel ke

Pelajaran Academy tentang membaca hasil verifikasi membahas pemeriksaan bukti alamat pada menit 7:20.[Bukti Alamat — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=440\&rel=0\&playsinline=1)## Cara kerjaVerifikasi Bukti Alamat Didit menghadirkan solusi andal untuk memverifikasi alamat tempat tinggal pengguna melalui dokumentasi resmi. Solusi kami memadukan AI canggih, visi komputer, dan pemeriksaan keamanan menyeluruh untuk menyediakan verifikasi alamat yang cepat dan andal dalam skala besar.**1. Pengambilan Dokumen Cerdas**Pengguna dapat memverifikasi alamat mereka melalui:| Metode | Deskripsi |
| - | - |
| **Pengambilan Otomatis** | AI kami secara otomatis mendeteksi posisi dokumen yang optimal dan mengambil gambar secara otomatis pada saat yang tepat |
| **Opsi Unggah** | Pengguna dapat mengunggah dokumen yang ada dalam berbagai format (PDF, JPG, PNG) |
| **Dukungan Multihalaman** | Menangani dokumen dengan beberapa halaman, seperti rekening koran, dengan lancar |**2. Ekstraksi & Verifikasi Data Tingkat Lanjut**Kemampuan pemrosesan yang canggih:- OCR berpresisi tinggi untuk mengekstrak informasi alamat
- Klasifikasi dokumen cerdas untuk mengidentifikasi jenis dokumen
- Pencocokan nama dengan dokumen identitas untuk verifikasi silang
- Ekstraksi tanggal penerbitan dan validasi terhadap persyaratan yang dikonfigurasi
- Pencocokan format dan pola untuk semua kolom alamat**3. Validasi Komprehensif**Sistem bertenaga AI kami melakukan pemeriksaan menyeluruh:| Pemeriksaan | Deskripsi |
| - | - |
| **Keaslian Dokumen** | Verifikasi legitimasi dokumen |
| **Deteksi Manipulasi** | Analisis integritas gambar untuk mendeteksi manipulasi |
| **Standardisasi Alamat** | Memformat dan menormalisasi kolom alamat |
| **Geocoding** | Menyediakan koordinat lokasi dari alamat yang diekstrak |
| **Deteksi Bahasa** | Mengidentifikasi dan memvalidasi bahasa dokumen |**4. Pengiriman Hasil Tanpa Hambatan**Akses hasil verifikasi melalui berbagai saluran:- Pembaruan dasbor real-time
- Notifikasi webhook instan
- Integrasi RESTful API
- Laporan komprehensif dengan informasi sesi verifikasi yang terperinci## Persyaratan DokumenUntuk memastikan verifikasi alamat berhasil, dokumen harus memenuhi kriteria berikut:#### Jenis Dokumen yang DiterimaTabel berikut mencantumkan jenis dokumen yang diterima dan masing-masing subtipenya. Semua dokumen harus diterbitkan dalam 3 bulan terakhir kecuali ditentukan lain.| Jenis Dokumen | Subtipe |
| - | - |
| **Tagihan Utilitas** | Tagihan Listrik, Tagihan Air, Tagihan Gas, Tagihan Internet, Tagihan Telepon, Tagihan TV Kabel, Tagihan TV Satelit, Tagihan Pengangkutan Sampah, Tagihan Saluran Pembuangan, Tagihan Pemanas, Tagihan Utilitas Gabungan, Tagihan Layanan Kota |
| **Laporan Bank** | Rekening Koran, Tagihan Kartu Kredit, Surat Bank yang Mengonfirmasi Alamat, Laporan Hipotek, Laporan Pinjaman, Laporan Rekening Tabungan, Laporan Rekening Giro, Laporan Rekening Investasi, Laporan Rekening Bisnis, Laporan Koperasi Kredit, Laporan Kartu Debit, Laporan Fasilitas Kredit |
| **Dokumen Terbitan Pemerintah** | Penetapan Pajak, Kartu Pendaftaran Pemilih, Dokumen identitas, Surat Keterangan Domisili, Surat/Pemberitahuan Pemerintah, Surat Sensus, Surat Keterangan Pendaftaran Individu, Tagihan Pajak Properti, Pendaftaran Kendaraan, Laporan Jaminan Sosial, Surat Tunjangan Pengangguran, Surat Tunjangan Disabilitas, Laporan Pensiun, Panggilan Pengadilan, Pemberitahuan Tugas Juri, Izin Kota, Dokumen Imigrasi |
| **Bukti Alamat Lainnya** | Perjanjian Sewa, Perjanjian Penyewaan, Surat dari Pemberi Kerja yang Mengonfirmasi Alamat, Dokumen Polis Asuransi, Surat Pendaftaran Sekolah, Afidavit Alamat yang Dinotariskan, Surat dari Pengacara yang Mengonfirmasi Alamat, Laporan Pinjaman Pendidikan, Dokumen Pengadilan yang Mengonfirmasi Alamat, Polis Asuransi Pemilik Rumah, Polis Asuransi Penyewa, Polis Asuransi Mobil, Laporan Asuransi Kesehatan, Tagihan Medis, Tagihan Rumah Sakit, Tagihan Layanan Berlangganan, Laporan Keanggotaan Pusat Kebugaran, Surat Manajemen Properti, Laporan Asosiasi Pemilik Rumah, Transkrip Universitas, Verifikasi Pendaftaran Perguruan Tinggi, Slip Gaji, Surat Verifikasi Pekerjaan, Laporan Rekening Pensiun, Laporan Rekening Pialang |#### Ketersediaan negaraSecara default, Bukti Alamat mendukung negara dan wilayah yang sama dengan Verifikasi Identitas, termasuk Kepulauan Turks dan Caicos (`TCA`) serta Tuvalu (`TUV`). Setiap negara yang didukung menawarkan empat kategori dokumen yang tercantum di atas. Anda dapat membatasi cakupan default ini di pengaturan Bukti Alamat pada alur kerja Anda.> [!NOTE]
>
> Jika alur kerja yang sudah ada tidak menampilkan negara yang baru didukung, buka pengaturan Bukti Alamat pada alur kerja tersebut lalu simpan kembali untuk menyegarkan konfigurasi negara yang diizinkan pada alur kerja.![Jenis dokumen bukti alamat Didit yang diterima — tagihan utilitas, laporan bank dan dokumen pemerintah](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/proof-of-address-id-table.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=b065b2bb6f64408442b49d89ab16cb46)#### Persyaratan Umum- Dokumen valid dalam waktu 90 hari sejak tanggal penerbitan
- Utuh secara fisik (bebas dari kerusakan, goresan, atau noda)
- Informasi alamat lengkap terlihat jelas
- Nama dan logo penerbit dokumen terlihat jelas
- Nama pada dokumen harus sesuai dengan identitas pengguna yang terverifikasi
- Berbeda dari dokumen identitas (tidak boleh berupa dokumen yang sama yang digunakan untuk verifikasi identitas)#### Persyaratan Gambar- Dokumen asli diambil secara waktu nyata atau hasil pemindaian berkualitas tinggi
- Format yang didukung: JPG, JPEG, PNG, TIFF, PDF
- Ukuran file maksimum: 15MB
- Gambar berwarna dengan semua sudut terlihat
- Tidak ada pengeditan atau manipulasi digital
- Semua halaman disertakan untuk dokumen multi-halaman


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.