Interface Description "Checking WMID verification status and user's personal data"
URL to forward a request: https://passport.wmtransfer.com/asp/XMLGetWMPassport.asp
method: POST
Request format:
Request parameters:
| Title | Description | Notes |
| wmid | WM ID, verifying the request. WM Keeper Classic only |
12 digits |
| passportwmid | WM ID Passport (Mandatory field) |
12 digits |
| sign | WMSigner | WMSigner parameters: wmid + passportwmid |
| params | Request parameters | |
| params/dict | Showing the "Glossary" | In the response structure, some values are replaced by specific code(e.g. code of the personal passport is 130, etc.). The Glossary interprets all codes and allows to use it when working with the given interface. If dict="1" - glossary will be visible If dict="0"(by default)- Glossay is invisible. |
| params/info | Showing personal data (passport data + contact details) of the passport holder | If info="1"(by default) - personal data are open (publicly available) . If info="0" - personal data is closed |
| params/mode | checking trusted WMID mode | Every passport holder can add any WMID to the list of his trusted WMID's. The trusted WMID is able to view all data, listed in thePassport, even it was closed for public view. If mode="1" - the system checks the trust status. If mode="0"(by default)- no check takes place |
If no trust relations are established between the WMID, signing the request and WMId, that is subject to check , the request can contain only 1 parameter passportwmid. Request structure ( availablity of tags, descibed above) should in any case be invariable. Interface call paramaters for both cases are available below.
complete response format:
Response parameters:
| Title | Description | Notes |
| response/@retval | Request status codes | retval=0 - request executed without errors retval=1 - request not executed(incorrect request format) retval=2 - request not executed (invalid passportwmid parameter) retval=4 - request not executed(error when checking a signature) retval=11 - request not executed(one of the parameters is missing) |
| fullaccess | full data access indicator | If fullaccess=1, the WMID holder, subject to check has addedd a WMID into the trust list and provided access to his personal data . If fullaccess=0, no access is granted |
| response/certinfo | Passport details | |
| response/certinfo/@wmid | Passport WMID | |
| response/certinfo/directory | Glossary | ctype - legal position of the holder ( private person or legal entity) jstatus - more details for legal entities (director,agent etc.) tid - Passport type |
| response/certinfo/attestat/row | Information about all issued passports . There can be several tags <row/> (basing on the number of passports). In this case information on current passport type comes first. For example. If the given WMID was receiving initial and personal passport in a different period of time, thefirst tag will be <row tid="130" .../> | |
| response/certinfo/attestat/row/@cid | Unique user identifier in the verifcation system | |
| response/certinfo/attestat/row/@regcid | Unique passport issuer identifier in the system | |
| response/certinfo/attestat/row/@tid | Passport type | See Glossary When analyzing the given paramter, please pay attention to response/certinfo/attestat/row/@recalled or response/certinfo/userinfo/value/row/@locked If their value =1, the given passport has been revoked or its satus equals the alias passport. Either of the attributes can be checked. |
| response/certinfo/attestat/row/@locked | Right to issue the Passports | If locked=0 for holders of personal passports, it means that he/she has a right to issue initial passports, if locked=0 for holders of registrars' passports, it means that he/she has a right to issue personal passports. locked=1 means that no right to issue passports is granted to the user. |
| response/certinfo/attestat/row/@admlocked | Right to issue the Passports | admlocked=0 for holders of personal passports means that he/she can issue initial passports, ,admlocked=0 for holders of registrar passports means that he/she can issue personal passports. admlocked=1 means that no right to issue passports is granted to the user. |
| response/certinfo/attestat/row/@recalled | Passport Revoke Data | If the attribute value =1 the given passport has been revoked or its satus equals the alias passport. the parameter equals response/certinfo/userinfo/value/row/@locked |
| response/certinfo/attestat/row/@datecrt | Date and time (MSK) when the passport was issued | |
| response/certinfo/attestat/row/@datediff | Days elapsed between current date and passport issue date | |
| response/certinfo/attestat/row/@regnickname | Project title, name (nick)of the passport issuer | |
| response/certinfo/attestat/row/@regwmid | passport issuer WMID | 12 digits |
| response/certinfo/wmids/row | Information about all WMID, registered with the given passport. Passport holders, havingmore than one WMID can assign unique characteristics for each WMID (additional information, nick name, title) | |
| response/certinfo/wmids/row/@wmid | WMID | 12 digits |
| response/certinfo/wmids/row/@info | Additional information for the WMID. | |
| response/certinfo/wmids/row/@nickname | Unique name (nick) for the WMID | |
| response/certinfo/wmids/row/@datereg | Time and date of WMID registration in the system | |
| response/certinfo/userinfo | Personal data of the passport holder, data verification confirmation and blockings of the personal data, if any | |
| response/certinfo/userinfo/value/row | Passport holder personal data. | |
| response/certinfo/userinfo/value/row/@ctype | Holder status | СSee Glossary. ctype ="1" - private person ctype ="2" - legal entity |
| response/certinfo/userinfo/value/row/@jstatus | For legal entities. Satus(director, agent, etc) | See Glossary. |
| response/certinfo/userinfo/value/row/@osnovainfo | For legal entities. Acting on the basis of....(statute, power of attorney, etc) | |
| response/certinfo/userinfo/value/row/@locked | Information on revoking the passport | if attribute value=1, the passport has been revoked or its status equals the alias passport. The parameter equals response/certinfo/attestat/row/@recalled |
| response/certinfo/userinfo/value/row/@nickname | Project title, name (nick) | |
| response/certinfo/userinfo/value/row/@infoopen | Additional information (scope of activity, comments, promotional information) | |
| response/certinfo/userinfo/value/row/@city | Actual location (city) of the company or of the verified passport holder | |
| response/certinfo/userinfo/value/row/@country | Actual location country of the company or of the verified passport holder | |
| response/certinfo/userinfo/value/row/@zipcode | Actual location (ZIP/Postal code) of the company or of the verified passport holder | |
| response/certinfo/userinfo/value/row/@adres | Actual location address of the company or of the verified passport holder | |
| response/certinfo/userinfo/value/row/@fname | Last name of the verified passprot holder | |
| response/certinfo/userinfo/value/row/@iname | First name of the verified passprot holder | |
| response/certinfo/userinfo/value/row/@oname | Patronimic (middle name) of the verified passprot holder | |
| response/certinfo/userinfo/value/row/@pnomer | Passport number of the verified passprot holder | |
| response/certinfo/userinfo/value/row/@pdate | Passport issuing date | |
| response/certinfo/userinfo/value/row/@pcountry | Passport issuing country | |
| response/certinfo/userinfo/value/row/@pcity | Passport isuuing city | |
| response/certinfo/userinfo/value/row/@pbywhom | Passport isuuing authority (кем выдан) выдачи паспорта | |
| response/certinfo/userinfo/value/row/@rcountry | Country of permanent residence/registration | |
| response/certinfo/userinfo/value/row/@rcity | City of permanent residence/registration | |
| response/certinfo/userinfo/value/row/@radres | Address of permanent residence/registration | |
| response/certinfo/userinfo/value/row/@bplace | Place of birth (city, country) | |
| response/certinfo/userinfo/value/row/@bday | Date of birth (day) | |
| response/certinfo/userinfo/value/row/@bmonth | Date of birth(month) | |
| response/certinfo/userinfo/value/row/@byear | Date of birth(year) | |
| response/certinfo/userinfo/value/row/@name | For legal entities. Company name | |
| response/certinfo/userinfo/value/row/@dirfio | For legal entities. Director (first and last names) | |
| response/certinfo/userinfo/value/row/@buhfio | For legal entities. Chief Accountant (firstand last nmes) | |
| response/certinfo/userinfo/value/row/@inn | For legal entities, registered in Russia. Taxpayer Identification Number | |
| response/certinfo/userinfo/value/row/@okpo | For legal entities, registered in Russia.OKPO code | |
| response/certinfo/userinfo/value/row/@okonx | For legal entities, registered in Russia.OKVED (economic activities classification) | |
| response/certinfo/userinfo/value/row/@jadres | For legal entities. Legal address | |
| response/certinfo/userinfo/value/row/@jcountry | For legal entities. Legal address(country) | |
| response/certinfo/userinfo/value/row/@jcity | For legal entities. Legal address(city) | |
| response/certinfo/userinfo/value/row/@jzipcode | For legal entities. Legal address(ZIP/postal code) | |
| response/certinfo/userinfo/value/row/@bankname | For legal entities. Bank details. Bank name | |
| response/certinfo/userinfo/value/row/@bik | For legal entities. Bank details. Bank Identifier Code. | |
| response/certinfo/userinfo/value/row/@ks | For legal entities. Bank details. Correspondent account number | |
| response/certinfo/userinfo/value/row/@rs | For legal entities. Bank details. Settlement account number | |
| response/certinfo/userinfo/value/row/@phonehome | Verified Passport Holder contact details. Home telephone number. | |
| response/certinfo/userinfo/value/row/@phonemobile | Verified Passport Holder contact details. Mobile. | |
| response/certinfo/userinfo/value/row/@icq | Verified Passport Holder contact details. UIN ICQ | |
| response/certinfo/userinfo/value/row/@fax | Verified Passport Holder contact details. Fax. | |
| response/certinfo/userinfo/value/row/@email | Verified Passport Holder contact details. e-mail. | |
| response/certinfo/userinfo/value/row/@web | Verified Passport Holder contact details. Web site. | |
| response/certinfo/userinfo/value/row/@phone | Verified Passport Holder contact details. Contact telephone number. | |
| response/certinfo/userinfo/value/row/@cap_owner | Only for Capitaller passports. Founder's WMID. | 12 digits |
| response/certinfo/userinfo/value/row/@pasdoc | Checking if the passport electronic copy has been verified by the verification system administrator. | If pasdoc = 1, the copy has been verified by the administrator. If pasdoc = 0, the copy hasn't been verified. |
| response/certinfo/userinfo/value/row/@inndoc | Checking if the copy of Taxpayer Identification Certificate has been verified by the administrator. | If inndoc = 1, the copy has been verified. If inndoc = 0, the copy hasn't been verified. |
| response/certinfo/userinfo/check-lock/row | Checking if personal data has been checked and if it was blocked for public view. The attributes have names, similiar to the tags, described in the
response/certinfo/userinfo/value/row Attributes can possess the values as follows: 00 - the field not checked by the passport issuer and not blocked by the passport holder for public view 01 - the field not checked by the passport issuer and blocked vy the passport holder for public view 10 - field checked by the passport issuer and not blocked for public view 11 -field checked by the passport issuer and blocked vy the passport holder for public view Example:If attribute @fname="10", passport holder last name has been verified vy the passport issuer. The field is open for public view . | |
Example of interface call without forming a signature (IIS, ASP, VBScript)
<%@ LANGUAGE="VBSCRIPT"%>
<%
wmid = ""
passportwmid = "464889785562"
planstr = ""
signstr = ""
Set WinHttpReq = Server.CreateObject("WinHttp.WinHttpRequest.5")
WinHttpReq.open "POST", "https://passport.webmoney.ru/asp/XMLGetWMPassport.asp", 0
s= "<request>"
s=s+"<wmid>"+wmid+"</wmid>"
s=s+"<sign>"+signstr+"</sign>"
s=s+"<passportwmid>"+passportwmid+"</passportwmid>"
s=s+"<params>"
s=s+"<dict>1</dict>"
s=s+"<info></info>"
s=s+"<mode></mode>"
s=s+"</params>"
s=s+"</request>"
WinHttpReq.send s
Response.Write WinHttpReq.ResponseText
Set WinHttpReq = Nothing
%>
Example of interface call with forming a signature (IIS, ASP, VBScript)
<%@ LANGUAGE="VBSCRIPT"%>
<%
Set WinHttpReq = Server.CreateObject("WinHttp.WinHttpRequest.5")
wmid = "111111111111"
passportwmid = "464889785562"
planstr = wmid + passportwmid
Set Signer = Server.CreateObject("WMSignerX.Signer")
Signer.Login = wmid
Signer.Passwd = "XXX"
Signer.KeyFName = "X:\test.kwm"
signstr = Signer.SignString(planstr)
WinHttpReq.open "POST", "https://passport.webmoney.ru/asp/XMLGetWMPassport.asp", 0
s= "<request>"
s=s+"<wmid>"+wmid+"</wmid>"
s=s+"<sign>"+signstr+"</sign>"
s=s+"<passportwmid>"+passportwmid+"</passportwmid>"
s=s+"<params>"
s=s+"<dict>1</dict>"
s=s+"<info></info>"
s=s+"<mode></mode>"
s=s+"</params>"
s=s+"</request>"
WinHttpReq.send s
Response.Write WinHttpReq.ResponseText
Set Signer = Nothing
Set WinHttpReq = Nothing
%>
For further details as to using the interface, please contact us by е-mail
