35 - Liveness detection
Service for determining the reality of the photo.
The report contains the following components:
Http Method | POST |
---|---|
Request URL | https://secure.ubki.ua/b2_api_xml/ubki/xml |
Request JSON |
Response JSON{ "ubkidata": { "tech": { "trace": { "step": { "name": "Step name", "stm": "Step start stamp date", "ftm": "Step finish stamp date" } }, "error": { "errtype": "Error code (code from ref.0)", "errtext": "Error text (value from ref.0)" }, "reqinfo": { "reqid": "Outbound request ID generated by UBKI" }, "billing": { "balance": { "value": "Balance amount", "date": "Date", "time": "Time" }, "billdetails": { "freemon": "Sign of free of charge according to the request type "Monitoring the client of the organization" (reqreason=1), code (0 - No, 1 - Yes)", "freemonref": "Sign of free of charge according to the request type "Monitoring the client of the organization" (reqreason=1), value (0 - No, 1 - Yes)" } } }, }, "comp": { "liveness": { "inn": "TIN from the request", "lname": "Last name from request", "fname": "Name from request", "mname": "Middle name from request", "bdate": "Date of birth from request", "probabilityspoof": "Probability of photo fraud" }, "id": "47", "descr": "Liveness detection" }, { "person": { "bdate": "Date of birth", "lngref": "Search/transfer language (ref. 23)", "lng": "Part presentation language, value (ref. 23)", "mname": "Middle name", "fname": "First name", "lname": "Last name", "inn ": "TIN of the credit history subject", }, "id": "72", "descr": "Search by full name + inn if more than 1 person is found (The presence of the component is determined by searching for more than 1 person in the case of searching by full name + inn)" } ] } } |
Request XML |
Response XML<?xml version = "1.0" encoding = "utf-8"?> <ubkidata> <!-- System information block --> <tech> <trace> <step name="Step name" stm="Step start stamp date" ftm="Step finish stamp date"> <!-- The trace block contains timing metrics for the steps of forming components --> </step> </trace> <error errtype="Error code (Code from ref.0)" errtext="Error text (Value from ref.0)"> </error> <reqinfo reqid="Outbound request ID generated by UBKI"> </reqinfo> <!-- Block of information on the current state of the prepaid account --> <billing> <balance value="Balance amount" date="Date" time="Time" /> <billdetails freemon="Sign of free of charge according to the request type "Monitoring the client of the organization" (reqreason=1), code (0 - No, 1 - Yes)" freemonref="Sign of free of charge according to the request type "Monitoring the client of the organization" (reqreason=1), value (0 - No, 1 - Yes)"/> </billing> </tech> <!-- Block for determining the reality of a photo --> <comp id="47" descr="Liveness detection"> <liveness inn="TIN from the request" lname="Last name from request" fname="Name from request" mname="Middle name from request" bdate="Date of birth from request" probabilityspoof="Probability of photo fraud" /> </comp> <!-- Search by full name + inn if more than 1 person is found (The presence of the component is determined by searching for more than 1 person in the case of searching by full name + inn)--> <comp id="72" descr="Search by full name + inn if more than 1 person is found"> <person bdate="Date of birth" lngref="Search/transfer language (ref. 23)" lng="Part presentation language, value (ref. 23)" mname="Middle name" fname="First name" lname="Last name" inn="TIN of the credit history subject" /> </comp> </ubkidata> |
Example |
---|
Request JSON | {
"doc": {
"ubki": {
"req_envelope": {
"req_xml": {
"request": {
"i": {
"ident": {
"bdate": "1957-10-19",
"mname": "ІГОРЕВНА",
"fname": "АННА",
"lname": "РИБАЧКА",
"okpo": "2111118724"
},
"liveness": {
"imgdata0": "Photo base64",
"imgdata1": "Photo base64",
"imgdata2": "Photo base64",
"imgdata3": "Photo base64",
"imgdata4": "Photo base64"
},
"reqlng": "4"
},
"version": "1.0",
"reqtype": "35",
"reqreason": "2"
}
}
},
"sessid": "EDF4309796114D6D9B8365370DA2DEE9"
}
}
} |
Response JSON | {
"ubkidata": {
"tech": {
"trace": {
"step": {
"name": "build report",
"stm": "2022-08-29 10:50:22.526",
"ftm": "2022-08-29 10:50:22.806"
}
},
"reqinfo": {
"reqid": "req2#000002461398"
}
},
"comp": {
"liveness": {
"inn": "2111118724",
"lname": "РИБАЧКА",
"fname": "АННА",
"mname": "ІГОРЕВНА",
"bdate": "1957-10-19",
"probabilityspoof": "0.3"
},
"id": "47",
"descr": "Liveness detection"
}
}
} |
Request XML | <?xml version="1.0" encoding="UTF-8"?>
<doc>
<ubki sessid="EDF4309796114D6D9B8365370DA2DEE9">
<req_envelope>
<req_xml>
<request version="1.0" reqtype="35" reqreason="2">
<i reqlng="4">
<ident bdate="1957-10-19" mname="ІГОРЕВНА" fname="АННА" lname="РИБАЧКА" okpo="2111118724" />
<liveness imgdata0="Photo base64" imgdata1="Photo base64" imgdata2="Photo base64" imgdata3="Photo base64" imgdata4="Photo base64" />
</i>
</request>
</req_xml>
</req_envelope>
</ubki>
</doc> |
Response XML |
XSD Schema request | |
---|---|
XSD Schema response | https://secure.ubki.ua/b2/js/xsd/response35.xsd |
Test URL | |
---|---|
Test data |
<comp id="72" descr="Search by full name + inn if more than 1 person is found">
|