> ## 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 إثبات العنوان: التحقق من فواتير الخدمات

> تحقق Didit من العناوين السكنية باستخراج ذكي بالذكاء الاصطناعي من فواتير الخدمات وكشوف الحسابات البنكية والمستندات الحكومية، بسعر $0.20 لكل استدعاء.

يتيح التحقق من إثبات العنوان (PoA) التحقق من عنوان السكن للمستخدم عبر مستندات رسمية. تُبسّط هذه الميزة عملية التحقق من العنوان، إذ تتيح للمستخدمين التقاط المستندات التي تؤكد عنوانهم أو رفعها.

موجّه تكامل إثبات العنوان
        نسخ الموجّه إلى الحافظة



      
      

\<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>



      
      

الصق في

يصل درس الأكاديمية حول قراءة نتيجة التحقق إلى فحص إثبات العنوان عند الدقيقة 7:20.[إثبات العنوان — أكاديمية Didit](https://www.youtube.com/embed/7htTWCWsl60?start=440\&rel=0\&playsinline=1)## كيف يعمليوفر التحقق من إثبات العنوان من Didit حلاً قوياً للتحقق من عنوان إقامة المستخدم عبر المستندات الرسمية. يجمع حلنا بين الذكاء الاصطناعي المتقدم والرؤية الحاسوبية وفحوصات الأمان الشاملة لتقديم تحقق سريع وموثوق من العناوين على نطاق واسع.**1. الالتقاط الذكي للمستندات**يمكن للمستخدمين التحقق من عنوانهم عبر:| الطريقة | الوصف |
| - | - |
| **الالتقاط التلقائي** | يكتشف الذكاء الاصطناعي لدينا تلقائياً الوضع الأمثل للمستند ويلتقطه تلقائياً في اللحظة المثالية |
| **خيار الرفع** | يمكن للمستخدمين رفع المستندات الحالية بصيغ متعددة (PDF وJPG وPNG) |
| **دعم الصفحات المتعددة** | يتعامل بسلاسة مع المستندات متعددة الصفحات مثل كشوف الحسابات البنكية |**2. استخراج البيانات والتحقق المتقدم**قدرات معالجة قوية:- تقنية OCR عالية الدقة لاستخراج معلومات العنوان
- تصنيف ذكي للمستندات لتحديد أنواع المستندات
- مطابقة الاسم مع مستندات الهوية للتحقق المتبادل
- استخراج تاريخ الإصدار والتحقق من صحته وفقاً للمتطلبات المضبوطة
- مطابقة التنسيق والأنماط لجميع حقول العنوان**3. التحقق الشامل**يجري نظامنا المدعوم بالذكاء الاصطناعي فحوصات شاملة:| الفحص | الوصف |
| - | - |
| **أصالة المستند** | التحقق من مشروعية المستند |
| **كشف التلاعب** | تحليل سلامة الصورة لاكتشاف أي تعديل |
| **توحيد تنسيق العنوان** | تنسيق حقول العنوان وتوحيدها |
| **الترميز الجغرافي** | توفير إحداثيات الموقع بناءً على العنوان المستخرج |
| **اكتشاف اللغة** | تحديد لغة المستند والتحقق منها |**4. تسليم النتائج بسلاسة**الوصول إلى نتائج التحقق عبر قنوات متعددة:- تحديثات في الوقت الفعلي على لوحة التحكم
- إشعارات فورية عبر webhook
- تكامل عبر RESTful API
- تقارير شاملة تتضمن معلومات مفصلة عن جلسة التحقق## متطلبات المستنداتلضمان نجاح التحقق من العنوان، يجب أن تستوفي المستندات هذه المعايير:#### أنواع المستندات المقبولةيسرد الجدول التالي أنواع المستندات المقبولة وأنواعها الفرعية الخاصة بها. يجب إصدار جميع المستندات خلال الأشهر الثلاثة الأخيرة ما لم يُنص على خلاف ذلك.| نوع المستند | الأنواع الفرعية |
| - | - |
| **فاتورة المرافق** | فاتورة كهرباء، فاتورة مياه، فاتورة غاز، فاتورة إنترنت، فاتورة هاتف، فاتورة تلفزيون الكابل، فاتورة تلفزيون فضائي، فاتورة جمع القمامة، فاتورة الصرف الصحي، فاتورة تدفئة، فاتورة مرافق مجمعة، فاتورة خدمات بلدية |
| **كشف حساب بنكي** | كشف حساب، كشف حساب بطاقة ائتمان، خطاب بنكي لتأكيد العنوان، كشف حساب رهن عقاري، كشف حساب قرض، كشف حساب توفير، كشف حساب جاري، كشف حساب استثماري، كشف حساب تجاري، كشف حساب اتحاد ائتماني، كشف حساب بطاقة خصم مباشر، كشف حساب حد ائتماني |
| **مستند صادر عن جهة حكومية** | تقدير ضريبي، بطاقة تسجيل الناخبين، مستند إثبات هوية، شهادة إقامة، خطاب/إشعار حكومي، خطاب تعداد سكاني، شهادة قيد فردي، فاتورة ضريبة عقارية، تسجيل مركبة، كشف حساب الضمان الاجتماعي، خطاب إعانات بطالة، خطاب إعانات عجز، كشف حساب معاش تقاعدي، استدعاء محكمة، إشعار بواجب الخدمة في هيئة المحلفين، تصريح بلدي، مستند هجرة |
| **إثبات عنوان آخر** | عقد إيجار، اتفاقية إيجار، خطاب من صاحب العمل لتأكيد العنوان، وثيقة تأمين، خطاب قيد مدرسي، إقرار خطي موثق للعنوان، خطاب محامٍ لتأكيد العنوان، كشف حساب قرض طلابي، مستند محكمة يؤكد العنوان، بوليصة تأمين مالكي المنازل، بوليصة تأمين المستأجرين، بوليصة تأمين سيارات، كشف حساب تأمين صحي، فاتورة طبية، فاتورة مستشفى، فاتورة خدمة اشتراك، كشف حساب عضوية صالة رياضية، خطاب إدارة عقارات، كشف حساب جمعية مالكي العقارات، سجل أكاديمي جامعي، تحقق من القيد الجامعي، قسيمة راتب، خطاب إثبات عمل، كشف حساب تقاعدي، كشف حساب وساطة مالية |#### التوفر حسب الدوليدعم إثبات العنوان افتراضياً نفس الدول والأقاليم التي يدعمها التحقق من الهوية، بما في ذلك جزر توركس وكايكوس (`TCA`) وتوفالو (`TUV`). تتيح كل دولة مدعومة فئات المستندات الأربع المذكورة أعلاه. يمكنك تقييد هذه التغطية الافتراضية في إعدادات إثبات العنوان الخاصة بسير العمل لديك.> [!NOTE]
>
> إذا لم يظهر سير عمل حالي دولة مدعومة حديثاً، فافتح إعدادات إثبات العنوان الخاصة به واحفظها مرة أخرى لتحديث تكوين الدول المسموح بها في سير العمل.![أنواع مستندات إثبات العنوان المقبولة في Didit — فواتير المرافق، والكشوفات البنكية والحكومية](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)#### المتطلبات العامة- مستند صالح خلال 90 يوماً من تاريخ الإصدار
- سليم مادياً (خالٍ من التلف أو الخدوش أو البقع)
- معلومات العنوان الكامل واضحة ومرئية بالكامل
- اسم الجهة المصدرة للمستند وشعارها مرئيان
- يجب أن يتطابق الاسم الموجود على المستند مع الهوية المتحقق منها للمستخدم
- مختلف عن مستند الهوية (لا يمكن استخدام نفس المستند المستخدم للتحقق من الهوية)#### متطلبات الصور- مستند أصلي ملتقط في الوقت الفعلي أو مسح ضوئي عالي الجودة
- التنسيقات المدعومة: JPG، وJPEG، وPNG، وTIFF، وPDF
- الحد الأقصى لحجم الملف: 15MB
- صورة بالألوان الكاملة مع ظهور جميع الزوايا
- عدم وجود تعديل أو تلاعب رقمي
- تضمين جميع الصفحات للمستندات متعددة الصفحات


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