34 - Identification by phone number and date of birth
- Оксана Нечепоренко
- Zlata
A service of identification of a credit history subject, by phone number and date of birth for self-service terminals.
The report contains the following components:
Http Method | POST |
|---|---|
Request URL | https://secure.ubki.ua/b2_api_xml/ubki/xml |
Request JSON/Checking if the combination of the phone and date of birth is correct |
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": "Outgoing request ID generated by UBKI" }, "billing": { "balance": { "value": "Total assets", "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": { "phoneverif": { "phone": "Mobile phone", "bdate": "Date of birth", "mathch": "Phones verification result (code from ref.56)", "matchref": "Phones verification result in text format (ref.56)" }, "id": "45", "descr": "" } } } |
Request XML/Checking if the combination of the phone and date of birth is correct |
Response XML<?xml version="1.0" encoding="utf-8"?> <ubkidata> <!-- System information part --> <tech> <trace> <step name="Step name" stm="Step start stamp date" ftm="Step finish stamp date"> <!-- The trace part contains timing metrics of components generation steps --> </step> </trace> <error errtype="Error code (code from ref.0)" errtext="Error text (value from ref.0)"> </error> <reqinfo reqid="Outgoing request ID generated by UBKI"> </reqinfo> <!-- Information about the current status of the prepaid account part--> <billing> <balance value="Total assets" 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> <!-- Phone and Date of Birth Verification part --> <comp id="45" descr=""> <phoneverif phone="Mobile phone" bdate="Date of birth" mathch="Phones verification result (code from ref.56)" matchref="Phones verification result in text format (ref.56)" /> </comp> </ubkidata> |
Request JSON/Obtaining client details upon OTP verification |
Response JSON |
Request XML/Obtaining client details upon OTP verification |
Response XML |
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 |
Example (Receiving client data after OTP verification) |
|---|
Request JSON |
Response JSON |
Request XML |
Response XML |
XSD Schema request | |
|---|---|
XSD Schema response | https://secure.ubki.ua/b2/js/xsd/response34.xsd |
Test URL | |
|---|---|
Test data |
|