06 - Identification by phone number and photo

06 - Identification by phone number and photo


Phone and photo identification service.


Requirements to the photo

Http Method

POST

Request JSON

Response JSON

Request XML

Response XML

Example

Example

Request JSON

{ "doc": { "ubki": { "req_envelope": { "req_xml": { "request": { "i": { "fotoident": { "foto": "base64(Foto)", "fotoext": "jpeg", "phone": "+380662134234", "facelogic": "6" }, "reqlng": "4" }, "version": "1.0", "reqtype": "06", "reqreason": "6" } } }, "sessid": "771F947292D94D3BBB04661611C5B26A" } } }

Response JSON

{ "ubkidata": { "tech": { "trace": { "step": { "name": "build report", "stm": "2022-08-24 14:30:59.227", "ftm": "2022-08-24 14:30:59.593" } }, "reqinfo": { "reqid": "req2#000002459044" } }, "comp": [ { "cki": { "ident": [ { "cchild": "", "sstateref": "", "sstate": "", "spdref": "natural person", "spd": "1", "cgragref": "Ukraine", "cgrag": "804", "ceducref": "", "ceduc": "", "familyref": "", "family": "", "csexref": "woman", "csex": "2", "bdate": "1985-10-05", "mname": "ВАСИЛІВНА", "fname": "ІРІНА", "lname": "ГАРНА", "inn": "3278508288", "lngref": "Украинский", "lng": "1", "vdate": "2015-02-25", "donor": "BNK" }, { "cchild": "", "sstateref": "", "sstate": "", "spdref": "natural person", "spd": "1", "cgragref": "", "cgrag": "804", "ceducref": "", "ceduc": "", "familyref": "", "family": "", "csexref": "woman", "csex": "2", "bdate": "1985-10-05", "mname": "ВАСИЛІВНА", "fname": "ІРИНА", "lname": "ГАРНА", "inn": "3278508288", "lngref": "Ukrainian", "lng": "1", "vdate": "2006-04-04", "donor": "BNK" } ], "work": { "wdohod": "", "wstag": "", "wname": "", "wokpo": "", "cdolgnref": "", "cdolgn": "", "lngref": "", "lng": "", "vdate": "" }, "doc": { "dwdt": "2002-08-01", "dwho": "ІВАНГОРОДСЬКИМ", "dterm": "", "dnom": "578072", "dser": "АМ", "dtyperef": "Ukrainian citizen passport", "dtype": "1", "lngref": "Ukrainian", "lng": "1", "vdate": "2019-09-10", "eddr_number": "19891005-00022", "ddonor": "BNK" }, "addr": { "adflat": "", "adcorp": "", "adhome": "7", "adstreet": "ТИХА", "adcitytyperef": "", "adcitytype": "", "adcity": "JВDКВJ", "adarea": "ІВАНГОРОДСКИЙ", "adstate": "ДНЕПРОПЕТРОВСКАЯ", "adindex": "23201", "adcountry": "UA", "adtyperef": "Address of registration", "adtype": "2", "lngref": "Ukrainian", "lng": "1", "vdate": "2018-01-25", "addonor": "BNK" }, "bdate": "1989-10-05", "reqlngref": "Ukrainian", "reqlng": "1", "mname": "ВАСИЛІВНА", "fname": "ІРІНА", "lname": "ГАРНА", "inn": "3278508288" }, "identdocmvds": { "identdocmvd": { "foundsource": [ { "name": "MVS", "found": "1", "foundref": "Found", "sourcedate": "2022-08-24" }, { "name": "DMS", "found": "0", "foundref": "Not found", "sourcedate": "2022-08-24" }, { "name": "UBKI", "found": "0", "foundref": "Not found", "sourcedate": "2022-08-24" } ], "found": "1", "foundref": "Found", "foundtitle": "Passport АМ-578072 is found in the list of invalid passports", "pser": "АМ", "pnom": "578072", "dtype": "1", "dtyperef": "Ukrainian citizen passport" } }, "id": "1", "descr": "Identification of the Credit History Subject (CHS)" }, { "fotoident": { "match": "1", "matchref": "Yes", "verifclient": "2", "fotovc": " /9j/4A//2Q==", "fotoextvc": "jpg", "commentvc": "face found", "confidencevc": "0.95986" }, "id": "12", "descr": "Identification by photo and phone" }, { "pret": { "inn": "3278508288", "nonewdeal": "0", "nonewdealref": "No", "nonewdealcomment": "", "freezedate":"" }, "fcert": { "inn": "3278508288", "cert": "0", "certref": "No", "certid": "", "certurl": "" }, "maybegone": { "inn": "3278508288", "vdate": "2022-12-01", "dldonor": "BNK" }, "id": "18", "descr": "Alert" }, { "contact": [ { "cval": "+380662134234", "ctype": "3", "ctyperef": "mobile phone", "cstate": "1", "cstateref": "Actualization", "vdatestart": "2020-09-03", "vdate": "2020-09-08" }, { "cval": "+380111111111", "ctype": "3", "ctyperef": "mobile phone", "cstate": "2", "cstateref": "Deactualization", "vdatestart": "2020-06-12", "vdate": "2020-08-30" } ], "id": "46", "descr": "Сontacts confirmation of the subject of the credit history" } ] } }

Request XML

<?xml version="1.0" encoding="UTF-8"?> <doc> <ubki sessid="771F947292D94D3BBB04661611C5B26A"> <req_envelope> <req_xml> <request version="1.0" reqtype="06" reqreason="6"> <i reqlng="4"> <fotoident foto="base64(Foto)" fotoext="jpeg" phone="+380662134234" facelogic="6" /> </i> </request> </req_xml> </req_envelope> </ubki> </doc>

Response XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <ubkidata> <tech> <trace> <step name="build report" stm="2022-08-24 14:30:59.227" ftm="2022-08-24 14:30:59.593" /> </trace> <reqinfo reqid="req2#000002459044" /> </tech> <comp id="1" descr="Identification of the Credit History Subject (CHS)"> <cki bdate="1989-10-05" reqlngref="Ukrainian" reqlng="1" mname="ВАСИЛІВНА" fname="ІРІНА" lname="ГАРНА" inn="3278508288"> <ident cchild="" sstateref="" sstate="" spdref="natural person" spd="1" cgragref="Ukraine" cgrag="804" ceducref="" ceduc="" familyref="" family="" csexref="woman" csex="2" bdate="1985-10-05" mname="ВАСИЛІВНА" fname="ІРІНА" lname="ГАРНА" inn="3278508288" lngref="Украинский" lng="1" vdate="2015-02-25" donor="BNK" /> <ident cchild="" sstateref="" sstate="" spdref="natural person" spd="1" cgragref="" cgrag="804" ceducref="" ceduc="" familyref="" family="" csexref="woman" csex="2" bdate="1985-10-05" mname="ВАСИЛІВНА" fname="ІРИНА" lname="ГАРНА" inn="3278508288" lngref="Ukrainian" lng="1" vdate="2006-04-04" donor="BNK" /> <work wdohod="" wstag="" wname="" wokpo="" cdolgnref="" cdolgn="" lngref="" lng="" vdate="" /> <doc dwdt="2002-08-01" dwho="ІВАНГОРОДСЬКИМ" dterm="" dnom="578072" dser="АМ" dtyperef="Ukrainian citizen passport" dtype="1" lngref="Ukrainian" lng="1" vdate="2019-09-10" eddr_number="19891005-00022" ddonor="BNK" /> <addr adflat="" adcorp="" adhome="7" adstreet="ТИХА" adcitytyperef="" adcitytype="" adcity="JВDКВJ" adarea="ІВАНГОРОДСКИЙ" adstate="ДНЕПРОПЕТРОВСКАЯ" adindex="23201" adcountry="UA" adtyperef="Address of registration" adtype="2" lngref="Ukrainian" lng="1" vdate="2018-01-25" addonor="BNK" /> </cki> <identdocmvds> <identdocmvd found="1" foundref="Found" foundtitle="Passport АМ-578072 is found in the list of invalid passports" pser="АМ" pnom="578072" dtype="1" dtyperef="Ukrainian citizen passport"> <foundsource name="MVS" found="1" foundref="Found" sourcedate="2022-08-24"/> <foundsource name="DMS" found="0" foundref="Not found" sourcedate="2022-08-24"/> <foundsource name="UBKI" found="0" foundref="Not found" sourcedate="2022-08-24"/> </identdocmvd> </identdocmvds> </comp> <comp id="12" descr="Identification by photo and phone"> <fotoident match="1" matchref="Yes" verifclient="2" fotovc=" /9j/4A//2Q==" fotoextvc="jpg" commentvc="face found" confidencevc="0.95986" /> </comp> <comp id="18" descr="Alert"> <pret inn="3278508288" nonewdeal="0" nonewdealref="No" nonewdealcomment="" freezedate="" /> <fcert inn="3278508288" cert="0" certref="No" certid="" certurl="" /> <maybegone inn="3278508288" vdate="2022-12-01" dldonor="BNK" /> </comp> <comp id="46" descr="Сontacts confirmation of the subject of the credit history"> <contact cval="+380662134234" ctype="3" ctyperef="mobile phone" cstate="1" cstateref="Actualization" vdatestart="2020-09-03" vdate="2020-09-08" /> <contact cval="+380111111111" ctype="3" ctyperef="mobile phone" cstate="2" cstateref="Deactualization" vdatestart="2020-06-12" vdate="2020-08-30" /> </comp> </ubkidata>

Test URL

Test data

fotoident: foto="any that passes validation rules", fotoext="jpeg", phone="any from examples below", facelogic="6"

  • +380962134234 request successful, identification passed

  • +380971321122 - request successful, identification passed

  • +380935171868 - request successful, identification passed

  • +380981224895 - request successful, identification passed

  • +380677996111 - request successful, identification passed

  • +380685691111 - request successful, identification passed

  • +380992863111 - request successful, identification passed

  • +380732144444 - the photo does not meet the stated parameters

  • +380662134234 - degree of similarity of persons in the photo less than 50%

  • +380506630641 - there is no reference photo for comparison in the UBKI database

  • +380935171868 - more than six clients were found by phone number

  • +380981220000 - request successful, identification passed