# Проверка адреса проживания пользователя (PoA)

IDnGO предоставляет дополнительную услугу, позволяющую документально подтвердить проживание по указанному адресу и определить подтип подтверждающего документа.

Свяжитесь с нами, если хотите подключить проверку документов, подтверждающих адрес проживания (PoA).

# Документы PoA

Документы, которые подходят для проверки адреса проживания пользователя (тип UTILITY_BILL):

• Налоговый счет;
• Выписка по ипотеке;
• Свидетельство о регистрации избирателя;
• Переписка с государственным органом по поводу получения льгот, таких как пенсия, пособие по безработице, жилищное пособие и т.д.
• Счет за кабельное Интернет/ТВ. Не подходят счета от компаний, предоставляющих услуги спутникового телевидения или другие беспроводные телекоммуникационные услуги;
• Счет за стационарный телефон;
• Банковская выписка;
• Счет за коммунальные услуги: за газ, электричество, воду, Интернет и т.д. – связанные с недвижимостью;
• Действующий договор аренды с подписями арендодателя и арендатора;
• Счета за аренду, выставленные агентством по аренде недвижимости;
• Выписка с кредитной карты, выданная банком;
• Письмо от признанного государственного органа или государственного служащего (любая правительственная корреспонденция);
• Справка от работодателя для PoA;
• Документ о покупке жилой недвижимости;
• Документ удостоверяющий личность, содержащий адрес и не использовавшаяся ранее в качестве подтверждения личности пользователя.

Документ должен содержать полное имя, домашний адрес и срок действия документа или быть не старше 3-х месяцев. Принимаются как бумажные, так и электронные версии документов (в формате .PDF).

# Получение результатов

# GET Получение основных данных PoA

Чтобы получить данные, распознанные из предоставленных документов, воспользуйтесь одним из этих эндпоинтов:

GET /resources/applicants/{applicantId}/one

или, если вы не знаете applicantId, используйте:

GET /resources/applicants/-;externalUserId={externalUserId}/one

Параметры запроса

Ответ

Массив объектов info.idDocs[] содержит информацию, извлеченную из документов, предоставленных пользователем. Описание ниже будет содержать данные только для документов, подтверждающих адрес проживания (idDocType: "UTILITY_BILL"). Основные поля других предоставленных документов вы можете найти здесь.

Поля массива PoA idDocs

Поля элемента address

Пример

curl -X GET \
  'https://api.cyberity.ru/resources/applicants/6b594ade0a975a36c9349e66/one'

{
      "id" : "6b594ade0a975a36c9349e66",
      "createdAt" : "2021-10-27 13:30:14",
      "key" : "ZJTQSEZCZYRMCW",
      "clientId" : "coolclientid",
      "inspectionId" : "6b594ade0a975a36c9349e67",
      "externalUserId" : "29115001",
      "info" : {
        "country" : "GBR",
        "addresses" : [ {
          "subStreet" : "536",
          "subStreetEn" : "536",
          "street" : "Main Street",
          "streetEn" : "Main Stree",
          "state" : "London",
          "town" : "London",
          "townEn" : "London",
          "postCode" : "UK925 63",
          "country" : "GBR"
        } ],
        "idDocs" : [ {
          "idDocType" : "UTILITY_BILL",
          "country" : "SVK",
          "firstName" : "BRADLEY PEAK",
          "firstNameEn" : "BRADLEY PEAK",
          "issuedDate" : "2021-10-10",
          "address" : {
            "subStreet" : "536",
            "subStreetEn" : "536",
            "street" : "Main Street",
            "streetEn" : "Main Stree",
            "state" : "London",
            "town" : "London",
            "townEn" : "London",
            "postCode" : "UK925 63",
            "country" : "GBR"
          }
        } ]
      },
      "ipCountry" : "GBR",
      "requiredIdDocs" : {
        "docSets" : [ {
          "idDocSetType" : "PROOF_OF_RESIDENCE",
          "types" : [ "UTILITY_BILL" ]
        } ]
      },
      "review" : {
        "levelName" : "poaCheck",
        "createDate" : "2021-10-27 14:40:39+0000",
        "reviewDate" : "2021-10-27 15:19:56+0000",
        "startDate" : "2021-10-27 15:17:05+0000",
        "reviewResult" : {
          "reviewAnswer" : "GREEN"
        },
        "reviewStatus" : "completed"
      },
      "lang" : "en",
      "type" : "individual"
    }

# GET Получение дополнительных данных PoA

GET /resources/checks/latest?type=POA&applicantId={applicantId}

Параметры запроса

Ответ

Содержит список проверок PoA.

Доступные значения элементов companyContact.type и subType

Пример

curl -X GET \
  'https://api.cyberity.ru/resources/checks/latest?type=POA&applicantId=6b594ade0a975a36c9349e67'

{
  "checks" : [
    {
      "answer" : "GREEN",
      "checkType" : "POA",
      "createdAt" : "2022-01-11 16:36:23",
      "inputDoc" : {
        "idDocType" : "UTILITY_BILL",
        "country" : "GBR"
      },
      "poaCheckInfo" : {
        "answer" : "GREEN",
        "unexpired" : "GREEN",
        "acceptableType" : "GREEN",
        "validAddress" : "GREEN",
        "companyContact" : {
          "type" : "bank"
        },
        "poiAsPoa" : false,
        "subType" : "bankLetter"
      }
    }
  ]
}