34 - Identification by phone number and date of birth

34 - Identification by phone number and date of birth


A service of identification of a credit history subject, by phone number and date of birth for self-service terminals.


Http Method

POST

Request JSON/Checking if the combination of the phone and date of birth is correct
( ** parameters are passed optionally)

Response JSON

Request XML/Checking if the combination of the phone and date of birth is correct
( ** parameters are passed optionally)

Response XML

Request JSON/Obtaining client details upon OTP verification
( ** parameters are passed optionally)

Response JSON

Request XML/Obtaining client details upon OTP verification
( ** parameters are passed optionally)

Response XML

Example (Checking the correct pairing of phone and date of birth)

Example (Checking the correct pairing of phone and date of birth)

Request JSON

{ "doc": { "ubki": { "req_envelope": { "req_xml": { "request": { "i": { "phoneverif": { "phone": "+380662134234", "bdate": "1957-10-19", "channelotp": "sms" }, "reqlng": "4" }, "version": "1.0", "reqtype": "34", "reqreason": "2" } } }, "sessid": "EDF4309796114D6D9B8365370DA2DEE9" } } }

Response JSON

{ "ubkidata": { "tech": { "trace": { "step": { "name": "build report", "stm": "2022-11-29 10:41:21.379", "ftm": "2022-08-29 10:41:21.689" } }, "reqinfo": { "reqid": "req2#000002461390" } }, "comp": { "phoneverif": { "phone": "+380662134234", "bdate": "1957-10-19", "mathch": "1", "matchref": "Yes" }, "id": "45", "descr": "Phone and date verification block" } } }

Request XML

<?xml version="1.0" encoding="UTF-8"?> <doc> <ubki sessid="EDF4309796114D6D9B8365370DA2DEE9"> <req_envelope> <req_xml> <request version="1.0" reqtype="34" reqreason="2"> <i reqlng="4"> <phoneverif phone="+380662134234" bdate="1957-10-19" channelotp="sms" /> </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-11-29 10:41:21.379" ftm="2022-08-29 10:41:21.689"/> </trace> <reqinfo reqid="req2#000002461390"/> </tech> <comp id="45" descr="Phone and date verification block"> <phoneverif phone="+380662134234" bdate="1957-10-19" mathch="1" matchref="Yes"/> </comp> </ubkidata>

Example (Receiving client data after OTP verification)

Example (Receiving client data after OTP verification)

Request JSON

{ "doc": { "ubki": { "req_envelope": { "req_xml": { "request": { "i": { "phoneverif": { "phone": "+380662134234", "bdate": "1957-10-19", "reqid": "req2#000002461390", "otp": "1234" }, "reqlng": "4" }, "version": "1.0", "reqtype": "34", "reqreason": "2" } } }, "sessid": "EDF4309796114D6D9B8365370DA2DEE9" } } }

Response JSON

{ "ubkidata": { "tech": { "trace": { "step": { "name": "build report", "stm": "2022-11-29 10:42:49.713", "ftm": "2022-08-29 10:42:49.998" } }, "reqinfo": { "reqid": "req2#000002461391" } }, "comp": [ { "cki": { "ident": { "cchild": "", "sstateref": "", "sstate": "", "spdref": "natural person", "spd": "1", "cgragref": "", "cgrag": "804", "ceducref": "", "ceduc": "", "familyref": "", "family": "", "csexref": "woman", "csex": "2", "bdate": "1957-10-19", "mname": "ІГОРЕВНА", "fname": "АННА", "lname": "РИБАЧКА", "inn": "2111118724", "lngref": "Russian", "lng": "2", "vdate": "2022-02-06", "donor": "BNK" }, "work": { "wdohod": "", "wstag": "", "wname": "ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ 'УКРАЇНСЬКА КОМПАНІЯ 'О'", "wokpo": "34745377", "cdolgnref": "Worker/specialist/performer", "cdolgn": "3", "lngref": "Ukrainian", "lng": "1", "vdate": "2021-11-07", "wdonor": "BNK" }, "doc": { "dwdt": "2004-03-10", "dwho": "ХЕРСОНСКИМ ГО УМВД", "dterm": "", "dnom": "142228", "dser": "ВВ", "dtyperef": "Ukrainian citizen passport", "dtype": "1", "lngref": "Ukrainian", "lng": "1", "vdate": "2021-08-01", "eddr_number": "19571019-00027", "ddonor": "BNK" }, "addr": { "adflat": "81", "adcorp": "", "adhome": "11", "adstreet": "ВУЛ.ЕЖЕЛЕ", "adcitytyperef": "", "adcitytype": "", "adcity": "М.ХЕРСОН", "adarea": "", "adstate": "ХЕРСОНСЬКА", "adindex": "10000", "adcountry": "UA", "adtyperef": "Address of registration", "adtype": "2", "lngref": "Ukrainian", "lng": "1", "vdate": "1900-01-01", "addonor": "BNK" }, "bdate": "1957-10-19", "reqlngref": "Russian", "reqlng": "2", "mname": "ІГОРЕВНА", "fname": "АННА", "lname": "РИБАЧКА", "inn": "2111118724" }, "identdocmvds": { "identdocmvd": { "foundsource": [ { "name": "DMS", "found": "0", "foundref": "Not found", "sourcedate": "2022-10-26" }, { "name": "MVS", "found": "0", "foundref": "Not found", "sourcedate": "2022-10-26" }, { "name": "UBKI", "found": "0", "foundref": "Not found", "sourcedate": "2022-10-26" } ], "found": "0", "foundref": "Not found", "foundtitle": "Passport ВВ-142228 is not found in the list of invalid passports", "pser": "ВВ", "pnom": "142228", "dtype": "1", "dtyperef": "Ukrainian citizen passport" } }, "id": "1", "descr": "Identification of the Credit History Subject (CHS)" }, { "pret": { "inn": "2111118724", "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" } ] } }

Request XML

<?xml version="1.0" encoding="UTF-8"?> <doc> <ubki sessid="EDF4309796114D6D9B8365370DA2DEE9"> <req_envelope> <req_xml> <request version="1.0" reqtype="34" reqreason="2"> <i reqlng="4"> <phoneverif phone="+380662134234" bdate="1957-10-19" reqid="req2#000002461390" otp="1234" /> </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-11-29 10:42:49.713" ftm="2022-08-29 10:42:49.998"/> </trace> <reqinfo reqid="req2#000002461391"/> </tech> <comp id="1" descr="Identification of the Credit History Subject (CHS)"> <cki bdate="1957-10-19" reqlngref="Russian" reqlng="2" mname="ІГОРЕВНА" fname="АННА" lname="РИБАЧКА" inn="2111118724"> <ident cchild="" sstateref="" sstate="" spdref="natural person" spd="1" cgragref="" cgrag="804" ceducref="" ceduc="" familyref="" family="" csexref="woman" csex="2" bdate="1957-10-19" mname="ІГОРЕВНА" fname="АННА" lname="РИБАЧКА" inn="2111118724" lngref="Russian" lng="2" vdate="2022-02-06" donor="BNK"/> <work wdohod="" wstag="" wname="ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ 'УКРАЇНСЬКА КОМПАНІЯ 'О'" wokpo="34745377" cdolgnref="Worker/specialist/performer" cdolgn="3" lngref="Ukrainian" lng="1" vdate="2021-11-07" wdonor="BNK"/> <doc dwdt="2004-03-10" dwho="ХЕРСОНСКИМ ГО УМВД" dterm="" dnom="142228" dser="ВВ" dtyperef="Ukrainian citizen passport" dtype="1" lngref="Ukrainian" lng="1" vdate="2021-08-01" eddr_number="19571019-00027" ddonor="BNK"/> <addr adflat="81" adcorp="" adhome="11" adstreet="ВУЛ.ЕЖЕЛЕ" adcitytyperef="" adcitytype="" adcity="М.ХЕРСОН" adarea="" adstate="ХЕРСОНСЬКА" adindex="10000" adcountry="UA" adtyperef="Address of registration" adtype="2" lngref="Ukrainian" lng="1" vdate="1900-01-01" addonor="BNK"/> </cki> <identdocmvds> <identdocmvd found="0" foundref="Not found" foundtitle="Passport ВВ-142228 is not found in the list of invalid passports" pser="ВВ" pnom="142228" dtype="1" dtyperef="Ukrainian citizen passport"> <foundsource name="DMS" found="0" foundref="Not found" sourcedate="2022-10-26"/> <foundsource name="MVS" found="0" foundref="Not found" sourcedate="2022-10-26"/> <foundsource name="UBKI" found="0" foundref="Not found" sourcedate="2022-10-26"/> </identdocmvd> </identdocmvds> </comp> <comp id="18" descr="Alert"> <pret inn="2111118724" 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> </ubkidata>

Test URL

Test data

  • phone="+380962134234" bdate="1989-10-05" otp = "1234"

  • phone="+380662134234" bdate="1957-10-19" otp = "1234"

  • phone="+380981224895" bdate="1985-03-20" otp = "1234"

  • phone="+380732144444" bdate="1991-04-06" otp = "1234"

  • phone="+380971321122" bdate="1988-07-10" otp = "1234"

  • phone="+380506630641" bdate="1981-05-20" otp = "1234"

  • phone="+380935171868" bdate="1974-08-20" otp = "1234"

  • phone="+380981220000" bdate="1991-03-30" otp = "1234"