Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Note

Звіт буде виведено з експлуатації, слід використовувати звіт "Фотоверифікація LIGHT"

Сервіс перевірки автентичності особи на фото.

Сервіс дозволяє аналізувати фотографії клієнтів в кредитних заявках:

  • верифікація клієнта (підтвердження особи),

  • запобігання шахрайству,

  • виявлення фактів крадіжки особистості - злочин, при якому персональні дані людини використовуються для незаконного отримання матеріальної вигоди (окремі випадки: фальсифікація і підробка документів, в найпростішому випадку - заміна фото в паспорті).

В основі сервісу фотоверифікаціі УБКІ - Microsoft Face API

Схема роботи сервісу фотоверифікаціі

...

Технологічна схема сервісу

...

Info

Звіт містить такі компоненти:

Вимоги до фотографії

...

titleДетальніше

1. Максимальний розмір запиту із закодованою фотографією - 2 МБ.

...

The report will be unavailable in the near future and should be used report "Photo verification LIGHT"

Verification of identity based on a photo.

...

The service allows you to analyze the customer’s photos in the credit requests:

  • Customer verification (identity authentication),

  • Fraud prevention,

  • Identification of the facts of identity theft - a crime, in which a person's personal data are used to obtain illegally the material benefits (special cases: forgery and forgery of documents, in the simplest case – photo reglueing in the passport).

At the heart of the photo verification of the Ukrainian Bureau of Credit History is Microsoft Face API.

...

Info

The report contains the following components:

Requirements to the photo

Expand
titleMore details

1. File size (recommended) - 2Mb

2. File extension - jpeg/jpg

3. XML запит request - фото photo base64

4. Більш висока якість зображення особи означає кращу точність розпізнавання: фронтальний, прозорий і розмір особи - 200x200 пікселів (100 пікселів між очима) або більше.

5. Площа особи на фотографії повинна становити максимальну можливу частку від усього зображення;

6. Фотографія повинна бути чітка, не розмита;

7. Колір і яскравість фону повинні забезпечувати надійне визначення контуру голови.

8. Розташування та освітлення:

- Розташування голови - без поворотів, прямо, погляд спрямований строго на камеру. Нахили або повороти голови в будь-якому напрямку або зміни фокуса особи приведуть до спотворення результатів порівняння;

- На фоні не повинно бути тіней від голови, не повинно бути тіней на обличчі або будь-яких предметів;

- На зображеннях особи не рекомендується закритих очей; волосся, що закривають очі і обличчя;

- На зображеннях осіб не рекомендується світлових відблисків і тіней;

- Не рекомендуються фото з фоном: вулиця, машина, паркани, дерева та ін.

9. Окуляри і головні убори:

- На зображеннях не рекомендуються елементи одягу, що закривають (частково або повністю) особу, тобто капелюхів, хусток і т.д .; товстих оправ окулярів, які деформують риси обличчя;

- На зображеннях не рекомендується відображення спалахів або підсвічуваних відображень в склах лінз або окулярів.

10. Вираз і кадр:

- За зображенням обличчя не рекомендується наявність осіб інших людей;

- Погляд на камеру повинен бути з нейтральним виразом обличчя і закритим ротомThe higher quality of a face image means the better recognition accuracy: frontal, transparent and face size - 200x200 pixels (100 pixels between the eyes) or more.

5. The face area in the photo has to compose a maximum possible share of the entire image;

6. The photo must be clear, not fuzzy;

7. The color and brightness of the background have to provide a reliable definition of a head contour.

8. Location and lighting:

- The head location - without turning, straight, and the sight has to be directed strictly at the camera. The head bends or turnings in any direction or face focus changing will lead to deformation of the comparison results;

- There has to be no shadows from the head against the background, there has to be no shadows on the face or any objects;

- It isn’t recommended the close eyes on images of face; hair that covers the eyes and face;

- It isn’t recommended any light reflections and shadows at the images of faces;

- It isn’t recommended a photo with background: street, car, fences, trees, etc.

9. Glasses and headwears:

- It isn’t recommended on the images the availability of clothing elements, that cover (partially or completely) a face, i.e. hats, shawls, etc.; the thick frames of glasses, which deform the facial features;

- It is not recommended the reflections of flashes or highlightings reflected in the glasses of lenses or glasses.

10. Expression and frame:

- It is not recommended the availability of other person behind the face image;

- The look at the camera should be with a neutral facial expression and with closed mouth.

Request XML
( **

параметри передаються опціонально

parameters are passed optionally)

Expand
title body:

<?xml version="1.0" encoding="utf-8"?>

<doc>

<ubki sessid="Сесійний ключ (отримуємо із API авторизаціїSession key (we receive it from the API authorization)">

<req_envelope descr="Конверт запитуRequest envelope">

<req_xml descr="Об'єкт запитуRequest object">

<!-- Параметри запиту Request Parameters -->

<request version="1.0" reqtype="Код шаблону (Код із дов.Template code (Code from guide 49): Звіт Report 'ФотоверифікаціяPhoto Verification' - 17" reqreason="Мета подання запиту (Код із дов.Purpose of the request (Code from guide 24)">

<!-- Параметри, що описують критерії пошукуParameters, describing the search criteria-->

<i reqlng="Мова критеріїв пошуку (Код із дов.Search criteria language (Code from guide 23)">

<!-- Параметри ідентифікації суб'єктаParameters of the subject identification -->

<ident okpo="РНОКПП (ІПН) (для фіз.осіб)/ЄДРПОУ (для юр.осіб)" INN-RNUKPN (for the natural persons)/EGRPOU (for the legal entities)" lname="**ПрізвищеSurname" fname="**Ім'яName" mname="**По батьковіFather’s name" bdate="**Дата народження*Date of Birth" orgname="**Company Name">

</ident>

<!-- Параметри для фотоверифікації Parameters for photo verification -->

<fotoverif freqtype="Тип запитуRequest Type" inn="РНОКПП (ІПН)" INN- RNUKPN" facelogic="Тип алгоритму пошуку особи" Type of algorithm for a person search" foto="base64(ФотоPhoto)" fotoext="Розширення до фото вхідної заявки Extension to the photo of the incoming request (jpeg)" phone="Телефон для порівнянняPhone for comparison" />

</i>

</request>

</req_xml>

</req_envelope>

</ubki>

</doc>

Тип запиту Request type "freqtype" -

  • 1 - у своїй базі фото (перевірка вхідної фотографії з фотографією, яку ви раніше передавали до бюро)

  • 2 - в базі фото інших банків (перевірка вхідної фотографії з фотографіями, які передавались в бюро іншими організаціями, крім власної)

  • 3 - порівняння двох осіб на фото (перевірка 2ох вхідних фотографій від вашої організації, у запиті потрібно відправляти додаткові параметри для другої фотографії fotodocext="розширення до фото", fotodoc ="фото в бейс64"))

  • 4 - зарезервовано

  • 5 - в базі фото скомпрометованих осіб (перевірка фото у базі скомпрометованих осіб - шахраї, зниклі безвісти, особи, які переховуються від органів влади)

  • 6 - порівняння з фото з документа (вхідна фотографія документа клієнта звіряється з фотографіями осіб в базі бюро)

  • 7 - порівняння двох облич на одному фото, наприклад, особа з паспорта і обличчя людини, що тримає паспортat its own base photo (the conversion of the input photo from the photo, which was previously transferred to the bureau)

  • 2 - in the base of the photos of the other banks (reconversion of the input photograph with the photographs, which were transferred to the bureau by other organizations, the Crimean authorities)

  • 3 - adjusting two particulars in the photo (revision of 2 input photos from your organization, you need to adjust additional parameters for another photo if you supply them fotodocext = "extended to a photo", fotodoc "=" photo in

  • 4 - reserved

  • 5 - in the base of the photo of the compromised individuals (re-copying of the photo at the base of the compromised individuals - shakhrai, anger, individuals that move from the authorities)

  • 6 - check the photo of the document (the photo of the client's document is entered to check the photographs of the individual in the base of the bureau)

  • 7 - two faces in one photo, for example, a person from a passport and revealing a people, who trim a passport.

Response XML

Expand
titlebody:

<?xml version="1.0" encoding="utf-8"?>

<ubkidata>

<!-- Блок системної інформації System information block -->

<tech>

<trace>

<step name="Найменування крокуStep name" stm="Дата штамп старту крокуDate - stamp of the starting step" ftm="Дата штамп фінішу крокуDate - stamp of the ending step">

<!-- Блок trace містить метрики таймінгу кроків формування компонентів The trace block contains metrics for timing of the steps for components formation -->

</step>

</trace>

<error errtype="Код помилки (Код із дов.Error code (Code from guide 0)" errtext="Текст помилки (Значення із дов.Error text (Value from guide 0)">

</error>

<reqinfo reqid="Вихідний ІД запиту, згенерований УБКІOutstanding ID request, generated by the Ukrainian Bureau of Credit History">

</reqinfo>

<!-- Блок інформації щодо поточного стану рахунку припейдThe block of information on the current state of the prepaid account-->

<billing>

<balance value="Сума балансуBalance amount" date="ДатаDate" time="ЧасTime" />

</billing>

</tech>

<!-- Блок "фотоверифікації" Block “Photo verification” -->

<comp id="16" descr="Назва компонентиComponents name">

<fotoverif freqtype="Тип запиту Request type (1 - у своїй базі фото, 2 - в базі фото інших банків, 3 - порівняння двох осіб на фото, 4 - зарезервовано, 5 - в базі фото скомпрометованих осіб, 6 - порівняння з фото з документа, 7 - порівняння двох облич на одному фото, наприклад, особа з паспорта і обличчя людини, що тримає паспорт)"

bdfd="Ознака перевірки по БД фото скомпрометованих осіб (Код із дов.47)"

fotofd="base64 (Фото) фотографія скомпрометованої особи" fotoextfd="Розширення до фото скомпрометованої особи"

commentfd="Коментар за результатами порівняння"

verifclient="Ознака збігу фото (Код із дов.47)"

fotovc="base64 (Фото) еталонної фотографії"

fotoextvc="Розширення до фото еталонної фотографії"

commentvc="Коментар за результатами порівняння з еталонною фотографією"

confidencefd="Міра схожості осіб при порівнянні з фото скомпрометованої особи"

confidencevc="Міра схожості осіб на фотографіях клієнтів"

datefotovc="Дата еталонної фотографії"

phonematch="Результат звірки телефонів"

phonematchref="Результат звірки телефонів в текстовому вигляді">

<!-- Блок "Пошук в Реєстрі заявочних фото" -->

<grey inn="РНОКПП (ІПН), за яким спрацював реєстр запитів"

foto="base64 (Фото) фотографія особи з реєстру запитів"

fotoext="Розширення до фото особи з реєстру запитів"

datefoto="Дата фотографії з реєстру запитів"

confidence="Міра схожості осіб при порівнянні з фото з реєстру запитів"

algsearch="Тип пошуку (1 - по заданому РНОКПП (ІПН), 2 - по заданій фотографії)"

algsearchdescr="Тип пошуку в текстовому вигляді– in the in-house photo-database, 2 – in photo-databases of other banks, 3 – comparison of two persons on the photo (for example, face in the passport and face of the person holding it), 4 – reserved, 5 – in the photo-database of compromised persons, 6 – comparison with the photo from the document)" bdfd="A checking sign by compromised persons’ photo database (Code from guide 47)" fotofd="base64(Photo) photo of a compromised person" fotoextfd="Expansion to the photo of a compromised person" commentfd="Commentary on the results of comparison" verifclient="The sign of the photo match (Code from guide 47)" fotovc="base64(Photo) sample photo" fotoextvc="Extension to the photo of the sample photo" commentvc="Comment on the results of comparison with the sample photo" confidencefd="A measure of similarity of persons when compared with a photo of a compromised person" confidencevc="A measure of the similarity of individuals in the customers’ photos" datefotovc="Date of a sample photo" phonematch="Result of phones checking" phonematchref="Result of phones checking in text form" />

<!-- Block "Search in the Register of application photos" -->

<gray inn="TIN, according to which the query register worked" foto="base64 (Photo) photographing faces from the registry of requests" fotoext="Extension to the photo of a person from the registry of requests" datefoto="Date photos from the registry of requests" confidence="A measure of the similarity of individuals when compared with a photo from the registry of requests" algsearch="Search type (1 - for a given TIN, 2 - for a given photo)" algsearchdescr="Type of search in text form" />

<!-- Блок "Пошук в базі зниклих безвісти і осіб, та тих, які переховуються від органів владиBlock "Search in the database of missing people" -->

<resultsearch state="Статус фіз.особи (missed- зниклий безвісти, wanted - особа, які переховуються від органів влади (в розшуку))"

category="Класифікація статусу фіз.особи в текстовому вигляді"

lnameua="Прізвище українською"

fnameua="Ім'я українською"

mnameua="По батькові українською"

lnameru="Прізвище російською"

fnameru="Ім'я російською"

mnameru="По батькові російською"

bdate="Дата народження"

lostdate="Дата зникнення"

lostplace="Місце зникнення"

restraint="Запобіжний захід"

contact="Контакти для інформування"

confidence="Міра схожості осіб при порівнянні з фото з бази зниклих безвісти"

foto="base64 (Фото) фотографія особи з бази зниклих безвісти"

fotoext="Розширення до фото особи з бази зниклих безвісти" />

</fotoverif>Status of the natural person" category="Classification of the status of the physical person in text form" lnameua="Last Name in Ukrainian" fnameua="Name in Ukrainian" mnameua="Patronymic in Ukrainian" lnameru="Last Name in Russian" fnameru="Name in Russian" mnameru="Patronymic in Russian" bdate="Date of birth" lostdate="date of disappearance" lostplace="Place of Extinction" restraint="preventive measure" contact="Contacts to inform" confidence="A measure of the similarity of individuals when compared with a photo from the base of the missing person" foto="base64 (Photo) photographing faces from the base of missing persons" fotoext="Extension to a photo of a person from the base of missing persons" />

</comp>

<!-- Попередження від СКІ Warnings from a credit history subject -->

<comp id="18" descr="Назва компонентиNames of components">

<pret nonewdeal="Ознака небажання оформлювати нові кредитні продукти, статус підключення опції FREEZE: 0 - не включена, 1 - включена"

nonewdealref="Значення ознаки небажання оформлювати нові кредитні продукти, статус підключення опції FREEZE - 0-ні (не підключена опція), 1-так (підключена опція)"

inn="РНОКПП (ІПН) (для фіз.осіб)/ЄДРПОУ (для юр.осібIndication of reluctance to apply for new credit products, status of the FREEZE option activation: 0 – not activated, 1 – activated" nonewdealref=" Value of the indication of reluctance to apply for new credit products, status of the FREEZE option activation: 0 – no (option not activated), 1 – yes (option activated)" inn="TIN (for individuals)/EDRPOU (for legal entities)">

<pretension inn="РНОКПП (ІПН) (для фіз.осібTIN (for individuals)/ЄДРПОУ (для юр.осібEDRPOU (for legal entities)" crdeal="Ідентифікатор угоди Transaction ID (референсreference)" source="Вид оскарження (Код із довType of dispute (code from ref.48)" sourceref="Вид оскарження (Значення із довType of dispute (value from ref.48)" vdate="Дата створення заявкиApplication creation date" />

<commentcki comment="Коментар суб'єкта кредитної історії" Comment of the subject of the credit history" vdate="Дата створення коментаряComment creation date" />

<plost pser="Серія паспорта, заявлено СКІ як загублений (крадіжка)"

pnom="Номер паспорта, заявлено СКІ як загублений (крадіжка)"

crdate="Дата створення заявки на втрату/крадіжку паспорта СКІ в УБКІ"

ldate="Зазначена в заявці дата втрати/крадіжки паспорта СКІ в УБКІSeries of passport declared lost (stolen) by the credit history subject" pnom="Passport number declared lost (stolen) by credit history subject" crdate="Date of submitting the application for loss/theft of the credit history subject’s passport in UBCH " ldate="Date of loss/theft of the credit history subject’s passport specified in the application to UBCH" />

<changedeal crdeal="Ідентифікатор угоди Transaction identifier (референсreference)" changecode="Код причини коригування/видалення даних (Код із довCode for the reason of correction/deletion of data (Code from ref.62)" changeref="Текст причини коригування/видалення даних (Значення із довText of the reason for correcting/deleting data (Value from ref.62)" vdate="Дата коригування/видалення данихDate of data correction/deletion " />

</pret>

</comp>

</ubkidata>

Приклад

Example

Request

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<doc>
  <ubki sessid="7BD7E136E3BF470EAA2CFE2E000000ED6D7D781B1E884A6AB384481804A35EA8">
    <req_envelope descr="Конверт запиту">envelope>
      <req_xml descr="Об'єкт запиту">
 xml>
        <request version="1.0" reqtype="17" reqreason="2">
          <i reqlng="14">
            <ident okpo="3278508288" mname="ВАСИЛІВНАVASYLIVNA" fname="ІРІНАIRINA" lname="ГАРНАHARNA" bdate="1989-10-05" />
            <fotoverif freqtype="2" inn="3278508288" facelogic="3" fotoext="jpg" phone="+380962134234" foto="/9j/4AAQSkZJRgABAQEASABIAA" />
          </i>
        </request>
      </req_xml>
    </req_envelope>
  </ubki>
</doc>

Response

Code Block
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ubkidata>
  <tech>
    <trace>
      <step name="build report" stm="2022-0108-0925 2115:5236:2910.631798" ftm="2022-0108-0925 2115:5236:2910.699936" />
    </trace>
    <reqinfo reqid="req2#000002008590req2#000002459882" />
  </tech>
  <comp id="16" descr="ФотоверифікаціяPhoto Verification">
    <fotoverif reqtype="1" bdfd="1" fotofd="/9j/4AAQSkZJRgP4AAQuLr5N2zke9/XJv5Gs5bpHTTl7p/9k2Q=" fotoextfd="jpeg" commentfd="Подозрение по фото подтверждается" confidencefd="0.73668" verifclient="2" fotovc="/9j/4AAQSlIZAUIwQaWfUhsL+TyP8Aa/8ArVT/ALZ3Lgwf+P8A/wBanYrQ/9k=" fotoextvc="jpeg" datefotovc="2018-11-21" commentvc="Подозрение по фото не подтверждаетсяThe suspicion is not confirmed by the photo" confidencevc="0.90923" phonematch="2" phonematchref="есть совпадение телефонаthere is a phone match" />
  </comp>
  <comp id="18" descr="ПопередженняClient від СКІalert">
    <pret inn="3278508288" nonewdeal="0" nonewdealref="НіNo" nonewdealcomment="" />
  </comp>
</ubkidata>

Test URL

https://test.ubki.ua/b2_api_xml/ubki/xml

Test data

fotoverif: freqtype = "2", inn = "один із прикладів нижче", facerlogic = "3", foto = "будь-яке, що проходить правила валідації", fotoext = "jpg / jpeg", phone = "+380662134234"

  • 2111118724, 3233312116, 3112579111 - Фото непридатне для роботи сервісу (face not found)

  • 3112579786, 3333312110, 2726020593 - Підозра по фото не підтверджується + доп. інформація по тегу Grey

  • 3278508288 - Підозра по фото підтверджується

  • 2972566397 - Підозра по фото не підтверджується

  • 3332643095, 2929952290 - Підозра по фото не підтверджується + доп. інформація по тегу resultsearch з безвісти зниклого і особи, що переховується від суду

  • 2972566111 - Вхідне фото збіглося з еталонним і з фото шахрая

<comp id="18" descr="Попередження від СКІ"> тег <changedeal>

  • 3332643095

...