...
Info |
---|
The report contains the following components: |
Http Method | POST |
---|---|
Request URL | https://secure.ubki.ua/b2_api_xml/ubki/xml |
Request JSON |
Expand | ||
---|---|---|
| ||
{ "doc": { "ubki": { "req_envelope": { "req_xml": { "request": { "i": { "ident": { "okpo": "Tax/Taxpayer Identification Number (INN-RNUKPN, for individuals)", "lname": "**Last name", "fname": "**First name", "mname": "**Middle name", "bdate": "**Date of birth" }, "mvd": { "dtype": "Sought-for document type (code 1, 3, 17 from дов.7)", "pser": "Series of the required passport", "pnom": "Number of required passport or ID-card number", "plname": "Surname of the required passport", "pfname": "Name of the required passport", "pmname": "Patronymic of the required passport", "pbdate": "Date of birth of the required passport" }, "reqlng": "Search criteria language (code from ref.23)" }, "version": "1.0", "reqtype": "Template code (code from ref.49): 'Verification ' – 21", "reqreason": "Request objective (code from ref.24)" }, "descr": "Request object" }, "descr": "Request envelope" }, "sessid": "Session key (obtained from the authorization API)" } } } |
Response JSON
|
}
}
|
{
"mvd"
|
|
"name": "Data source for verification (Code from ref. 63)",
"found": "0/1 - digital indication of the presence of an invalid passport (Code from ref.27
|
|
"sourcedate": "The date of updating the information in the database or receiving a response from the API of the original source"
},
"found": "Is it found? (The code from ref.27
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
]
}
}
Request XML
( **parameters are passed optionally)
Expand | ||
---|---|---|
| ||
<?xml version="1.0" encoding="utf-8"?> <doc> <ubki sessid="Session key (obtained from the authorization API)"> <req_envelope descr="Request envelope"> <req_xml descr="Request object"> <!-- Request parameters --> <request version="1.0" reqtype="Template code (code from ref.49): 'Verification ' – 21" reqreason="Request objective (code from ref.24)"> <!-- Parameters describing search criteria--> <i reqlng="Search criteria language (code from ref.23)"> <!-- Subject identification parameters--> <ident okpo="Tax/Taxpayer Identification Number (INN-RNUKPN, for individuals)" lname="**Last name" fname="**First name" mname="**Middle name" bdate="**Date of birth"> </ident> <!-- For the requests to search for canceled documents --> <mvd dtype= "Sought-for document type (code 1, 3, 17 from дов.7)" pser="Series of the required passport" pnom="Number of required passport or ID-card number" plname="Surname of the required passport" pfname="Name of the required passport" pmname="Patronymic of the required passport" pbdate="Date of birth of the required passport"> </mvd> </i> </request> </req_xml> </req_envelope> </ubki> </doc> |
Response XML
|
Request XML |
Expand | ||
---|---|---|
| ||
<?xml version="1.0" encoding="utf-8"?> |
<ubkidata>
<tech>
<!-- System information part -->
<trace>
<step name="Step name" stm="Step start stamp date" ftm="Step finish
|
</step>
</trace>
<error errtype="Error
|
|
|
|
<billing>
<!-- Information about the current status of the prepaid account part-->
<balance value="Total assets" date="Date" time="Time" />
</billing>
</tech>
<!-- Search for canceled documents -->
<comp id="5" descr="Components name">
<mvd found="Is it found? (The code from ref.27)"
foundref="Is it found? (Meaning from ref.27)"
foundtitle="Description of the search result"
|
|
|
|
status="Reason for cancellation (Only for data from DATA.GOV.UA)"
stdate="Cancellation Date (Only for data from DATA.GOV.UA)">
<foundsource name="Data source for verification (Code from ref. 63)"
found="0/1 - digital indication of the presence of an invalid passport (Code from ref.27)"
foundref="Text indication of the presence of an invalid passport (Value from ref.27)"
sourcedate="The date of updating the information in the database or receiving a response from the API of the original source" />
<!--This part must contain 1..* units and at least one document-->
</mvd>
</comp>
<!-- Client alert -->
<comp id="18" descr="Components name">
<pret nonewdeal="Sign of reluctance to draw up new loan products, connection status of the FREEZE option: 0 - not enabled, 1 - enabled"
nonewdealref="The value of the sign of unwillingness to draw up new credit products, the connection status of the FREEZE option is 0-no (the option is not connected), 1-yes (the option is connected)"
inn="INN (for natural persons)/OKPO (for legal entities)">
<pretension inn="INN (for natural persons)/OKPO (for legal entities)"
crdeal="Transaction identifier (reference)"
source="Disputing type (Code from ref.48)"
sourceref="Disputing type (Value from ref.48)"
vdate="Date of the request creation" />
<commentcki comment="Commentary of the subject of credit history"
vdate="Date of a comment creation" />
<plost pser="Passport series claimed by the client as lost (theft)"
pnom="Passport number declared by the client as lost (theft)"
crdate="ДDate of creation of an application for the loss/theft of a client's passport in UBCH"
ldate="The date of loss / theft of the client's passport indicated in the application 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>
|
Response XML
|
|
|
|
|
|
|
coincideref="Yes/No"
lname="Last name"
fname="First name"
mname="Middle name"
bdate="Date of birth"
ser="Sought-for passport series"
nom="Number of the sought-for passport or ID card" />
</comp>
</ubkidata>
Example
Request JSON
Code Block |
---|
{
"doc": {
"ubki": {
"req_envelope": {
"req_xml": {
"request": {
"i": {
"ident": {
"bdate": "1989-10-05",
"mname": "ВАСИЛІВНА",
"fname": "ІРІНА",
"lname": "ГАРНА",
"okpo": "3278508288"
},
"mvd": {
"dtype": "1",
"pser": "АМ",
"pnom": "578072",
"plname": "ГАРНА",
"pfname": "ІРІНА",
"pmname": "ВАСИЛІВНА",
"pbdate": "1989-10-05"
},
"reqlng": "4"
},
"version": "1.0",
"reqtype": "21",
"reqreason": "2"
}
}
},
"sessid": "F936E3872D7740D7910BB32C933318B3"
}
}
} |
Response JSON
|
Example |
---|
Request JSON |
|
Response JSON |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Request XML
|
Request XML |
|
Response XML |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Response XML
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
An example of a successful verification response in the presence of client identification data:<comp id="22" descr="Result of verification of Full Name-Passport-DOB"> <passportverif coincide="1" coincideref="Yes" existident = "1" existidentref = "Yes" lname="ГАРНА" fname="ІРІНА" mname="ВАСИЛІВНА" bdate="1989-10-05" ser="АМ" nom="578072" ></passportverif> </comp> An example of a failed verification response in the presence of client identification data:<comp id="22" descr="Result of verification of Full Name-Passport-DOB"> <passportverif coincide="0" coincideref="No" existident = "1" existidentref = "Yes" lname="ГАРНА" fname="ІРІНА" mname="ВАСИЛІВНА" bdate="1989-10-05" ser="АМ" nom="578072" ></passportverif> </comp> An example of a response in the absence of client identification data:<comp id="22" descr="Result of verification of Full Name-Passport-DOB"> <passportverif coincide="0" coincideref="No" existident = "0" existidentref = "No" lname="ГАРНА" fname="ІРІНА" mname="ВАСИЛІВНА" bdate="1989-10-05" |
---|
ser="АМ" |
---|
nom="578072" |
---|
></passportverif> </comp> |
---|
XSD Schema request | https://secure.ubki.ua/b2/js/xsd/request21.xsd |
---|---|
XSD Schema response | https://secure.ubki.ua/b2/js/xsd/response21.xsd |
Test URL | https://test.ubki.ua/b2_api_xml/ubki/xml |
---|---|
Test data |
Found in the list of invalid passports
Passport check dtype = 3
|
descr=" |
Alert"> tag <changedeal>
<comp id="72" descr="Search by full name + inn if more than 1 person is found">
|