...

Note

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

Verification of identity based on a photo.

...

Request XML
( **parameters are passed optionally)

Expand
title body:

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

<doc>

<ubki sessid="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="Tax/Taxpayer Identification Number (INN-RNUKPN (for the natural persons)/EGRPOU (for the legal entities, for individuals)"

lname="**SurnameLast name"

fname="**NameFirst name"

mname="**Father’s Middle name"

bdate="**Date of Birth" orgname="**Company Namebirth">

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

...

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

<!-- 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 – 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="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>

<!-- Client alert -->

<comp id="18" descr="Names of componentsComponents name">

<pret nonewdeal="Indication Sign of reluctance to apply for draw up new credit loan products, connection status of the FREEZE option activation: 0 - not activatedenabled, 1 – activated- enabled"

nonewdealref=" Value The value of the indication sign of reluctance unwillingness to apply for draw up new credit products, the connection status of the FREEZE option activation: is 0 -no (the option is not activatedconnected), 1 -yes (the option activatedis connected)"

inn="TIN INN (for individualsnatural persons)/EDRPOU OKPO (for legal entities)">

<pretension inn="TIN INN (for individualsnatural persons)/EDRPOU OKPO (for legal entities)"

crdeal="Transaction ID identifier (reference)"

source="Type of dispute (code Disputing type (Code from ref.48)"

sourceref="Type of dispute (value Disputing type (Value from ref.48)"

vdate="Application Date of the request creation date" />

<commentcki comment="Comment Commentary of the subject of the credit history"

vdate="Comment Date of a comment creation date" />

<plost pser="Series of passport declared Passport series claimed by the client as lost (stolentheft) by the credit history subject"

pnom="Passport number declared by the client as lost (stolentheft) by credit history subject"

crdate="Date of submitting the ДDate of creation of an application for the loss/theft of the credit history subject’s a client's passport in UBCH"

ldate="Date The date of loss / theft of the credit history subject’s passport specified client's passport indicated in the application to in 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>

...

Test URL

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

Test data

fotoverif: freqtype = "2", inn = "один із прикладів нижчеone from the bottom", facerlogic = "3", foto = "будь-яке, що проходить правила валідаціїbe it, go through the rules of validation", fotoext = "jpg/jpeg", phone = "+380662134234"

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

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

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

  • 2972566397 - Підозра по фото не підтверджується  - Suspicion on the photo is not confirmed + ext. information by tag Gray

  • 3278508288 - The suspicion of the photo is confirmed

  • 2972566397 - Suspicion on the photo is not confirmed

  • 3332643095, 2929952290 - Підозра по фото не підтверджується + доп. інформація по тегу resultsearch з безвісти зниклого і особи, що переховується від суду2972566111 - Вхідне фото збіглося з еталонним і з фото шахраяSuspicion in the photo is not confirmed + ext. information on the tag resultsearch from the missing and the person hiding from the court

  • 2972566111 - The input photo coincided with the reference and the photo of the swindler

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

  • 3332643095