> ## 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: AI-распознавание счетов за ЖКУ, банковских выписок и госдокументов. $0.20 за запрос.

Верификация подтверждения адреса (Proof of Address, 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>



      
      

Вставьте в

Урок Academy о том, как читать результат верификации, переходит к проверке подтверждения адреса на 7:20.[Подтверждение адреса - Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=440\&rel=0\&playsinline=1)## Как это работаетПодтверждение адреса от Didit представляет собой надёжное решение для проверки адреса проживания пользователя по официальным документам. Наше решение сочетает передовой ИИ, компьютерное зрение и комплексные проверки безопасности, обеспечивая быструю и надёжную проверку адресов в любых масштабах.**1. Интеллектуальный захват документа**Пользователи могут подтвердить свой адрес с помощью:| Метод | Описание |
| - | - |
| **Автозахват** | Наш ИИ автоматически определяет оптимальное положение документа и делает снимок в идеальный момент |
| **Загрузка файла** | Пользователи могут загружать существующие документы в различных форматах (PDF, JPG, PNG) |
| **Поддержка многостраничных документов** | Удобная обработка многостраничных документов, таких как банковские выписки |**2. Продвинутое извлечение и проверка данных**Мощные возможности обработки:- Высокоточный OCR для извлечения информации об адресе
- Интеллектуальная классификация документов для определения их типа
- Сверка имени с документами, удостоверяющими личность, для перекрёстной проверки
- Извлечение даты выдачи и проверка на соответствие настроенным требованиям
- Проверка форматов и шаблонов для всех полей адреса**3. Комплексная валидация**Наша система на базе ИИ выполняет детальные проверки:| Проверка | Описание |
| - | - |
| **Подлинность документа** | Проверка подлинности документа |
| **Обнаружение изменений** | Анализ целостности изображения для выявления манипуляций |
| **Стандартизация адреса** | Форматирование и нормализация полей адреса |
| **Геокодирование** | Определение географических координат по извлечённому адресу |
| **Определение языка** | Определение и валидация языка документа |**4. Удобное получение результатов**Получайте результаты верификации по нескольким каналам:- Обновления в панели управления в реальном времени
- Мгновенные webhook-уведомления
- Интеграция через REST API
- Подробные отчёты с детальной информацией о сессии верификации## Требования к документамЧтобы подтверждение адреса прошло успешно, документы должны соответствовать следующим критериям:#### Принимаемые типы документовВ следующей таблице перечислены принимаемые типы документов и соответствующие подтипы. Все документы должны быть выданы в течение последних 3 месяцев, если не указано иное.| Тип документа | Подтипы |
| - | - |
| **Счет за коммунальные услуги** | Счет за электроэнергию, счет за воду, счет за газ, счет за интернет, счет за телефон, счет за кабельное телевидение, счет за спутниковое телевидение, счет за вывоз мусора, счет за канализацию, счет за отопление, единый счет за коммунальные услуги, счет за муниципальные услуги |
| **Выписка из банка** | Выписка по счету, выписка по кредитной карте, письмо из банка с подтверждением адреса, выписка по ипотеке, выписка по кредиту, выписка по сберегательному счету, выписка по текущему счету, выписка по инвестиционному счету, выписка по счету компании, выписка кредитного союза, выписка по дебетовой карте, выписка по кредитной линии |
| **Государственный документ** | Налоговое уведомление, карта регистрации избирателя, документ, удостоверяющий личность, свидетельство о регистрации по месту жительства, официальное письмо/уведомление от государственного органа, письмо о переписи населения, свидетельство о регистрации физического лица, счет налога на имущество, свидетельство о регистрации транспортного средства, выписка социального страхования, письмо о пособии по безработице, письмо о пособии по инвалидности, пенсионная выписка, повестка в суд, уведомление о вызове для исполнения обязанностей присяжного, муниципальное разрешение, иммиграционный документ |
| **Другое подтверждение адреса** | Договор аренды, договор найма жилья, справка от работодателя с подтверждением адреса, страховой полис, справка о зачислении в школу, нотариальное подтверждение адреса, письмо адвоката с подтверждением адреса, выписка по студенческому кредиту, судебный документ с подтверждением адреса, полис страхования жилья, полис страхования арендатора, полис автострахования, выписка по медицинскому страхованию, медицинский счет, счет за лечение в стационаре, счет за услуги по подписке, выписка об абонементе в спортзал, письмо от управляющей компании, выписка ассоциации домовладельцев (ТСЖ), академическая справка университета, подтверждение зачисления в колледж, расчетный листок, справка с места работы, выписка по пенсионному счету, выписка по брокерскому счету |#### Доступность по странамПо умолчанию Подтверждение адреса поддерживает те же страны и территории, что и Верификация личности, включая острова Теркс и Кайкос (`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.