Описание интерфейса "Получение сведений об аттестате WM идентификатора и персональных данных его владельца"
URL для передачи запроса: https://passport.webmoney.ru/asp/XMLGetWMPassport.asp
метод: POST
формат запроса:
Посмотреть пример работы можно здесь (отозванный персональный аттестат)
Параметры запроса:
| название | назначение | примечание |
| wmid | WM идентификатор, подписавший запрос. Только WM Keeper Classic |
12 цифр |
| passportwmid | WM - идентификатор аттестата (обязательный параметр) |
12 цифр |
| sign | подпись запроса сформированная с помощью модуля WMSigner | Подпись запроса формируется из параметров: wmid + passportwmid |
| params | параметры запроса | |
| params/dict | отображение "опорного словаря" | В структуре возвращаемых некоторые значения заменяются специальным кодом (Например, тип аттестата персональный представляется цифрой 130 и т.п.). Словарь позволяет ознакомиться со всеми значениями и использовать их при работе с данным интерфейсом. Если dict="1" - словарь отображается. Если dict="0"(установлено по умолчанию) - словарь не отображается. |
| params/info | отображение персональных данных(паспортные данные + контактная информация) владельца аттестата | Если info="1"(установлено по умолчанию) - персональные данные отображаются. Если info="0" - персональные данные не отображаются |
| params/mode | проверка принадлежности WM идентификатора, подписавшего запрос, списку доверенных идентификаторов для проверяемого аттестата | Каждый владелец аттестата может добавить в список доверенных любой WM - идентификатор. Доверенный идентификатор получает возможность просмотра всех данных аттестата, даже тех, которые заблокированы для публичного просмотра. Если mode="1" - проверка принадлежности WM идентификатора, подписавшего запрос, списку доверенных идентификаторов для проверяемого аттестата осуществляется. Если mode="0"(установлено по умолчанию)- проверка не производится |
Если доверительных отношений между проверяемым WMID и WMID, подписавшим запрос нет, то в запросе можно указать лишь параметр passportwmid. Структура запроса (наличие в нем всех описанных ранее тегов) должна быть неизменной в любом случае. Примеры вызова интерфейса в обоих случаях смотрите ниже.
полный формат ответа:
Параметры ответа:
| название | назначение | примечание |
| response/@retval | код выполнения запроса |
retval=0 - запрос выполнен без ошибок retval=1 - запрос не выполнен (неверный формат запроса) retval=2 - запрос не выполнен (неверно указан параметр passportwmid) retval=4 - запрос не выполнен (ошибка при проверке подписи) retval=11 - запрос не выполнен (не указан один из параметров) |
| fullaccess | индикатор наличия доступа к закрытым полям аттестата | Если fullaccess=1, значит владелец проверяемого WMID добавил WMID, подписывающий запрос в список доверенных и тем самым предоставил доступ к своим персональным данным. Если fullaccess=0, значит доступа к закрытым полям аттестата проверяемого WMID нет |
| response/certinfo | информация об аттестате | |
| response/certinfo/@wmid | WM идентификатор аттестата | |
| response/certinfo/directory | Опорный словарь |
ctype - юридический статус владельца аттестата (частое лицо или юридическое) jstatus - уточнение статуса для юридических лиц (директор, представитель и др.) tid - тип аттестата |
| response/certinfo/attestat/row | Информация о всех выданных аттестатах. Тегов <row/> может быть несколько (по числу аттестатов). В этом случае первым идет блок с информацией о типе текущего аттестата. Для примера. Если на данный идентификатор в разное время были получены начальный и персональный аттестаты, то первым будет тег <row tid="130" .../> | |
| response/certinfo/attestat/row/@cid | Внутренний номер владельца аттестата в системе центра аттестации (уникальный) | |
| response/certinfo/attestat/row/@regcid | Внутренний номер аттестатора в системе центра аттестации (уникальный) | |
| response/certinfo/attestat/row/@tid | Тип аттестата |
См. опорный словарь При анализе данного параметра необходимо обратить внимание на атрибуты response/certinfo/attestat/row/@recalled или response/certinfo/userinfo/value/row/@locked Если их значение равно 1, то этот аттестат отозван и его статус эквивалентен аттестату псевдонима. Проверять можно любой из атрибутов. |
| response/certinfo/attestat/row/@locked | Право выдачи аттестатов | Для владельцев персональных аттестатов наличие locked=0 означает наличие права выдачи начальных аттестатов, для владельцев аттестата регистратора наличие locked=0 означает наличие права выдачи персональных аттестатов. locked=1 означает временную блокировку выдачи аттестатов или отсутствие такого права. |
| response/certinfo/attestat/row/@admlocked | Право выдачи аттестатов | Для владельцев персональных аттестатов наличие admlocked=0 означает наличие права выдачи начальных аттестатов, для владельцев аттестата регистратора наличие admlocked=0 означает наличие права выдачи персональных аттестатов. admlocked=1 означает, что данный аттестатор лишен права выдачи аттестатов. |
| response/certinfo/attestat/row/@recalled | Информация об отзыве аттестата |
Если значение атрибута равно 1, то этот аттестат отозван и его статус эквивалентен аттестату псевдонима.
Параметр аналогичен response/certinfo/userinfo/value/row/@locked |
| response/certinfo/attestat/row/@datecrt | Дата и время (московское) выдачи аттестата | |
| response/certinfo/attestat/row/@datediff | Разница в днях между текущей датой и датой выдачи аттестата | |
| response/certinfo/attestat/row/@regnickname | Название проекта, имя (nick) аттестатора, выдавшего данный аттестат | |
| response/certinfo/attestat/row/@regwmid | WMID аттестатора, выдавшего данный аттестат | 12 цифр |
| response/certinfo/wmids/row | Информация о всех WMID, прикрепленных к данному аттестату. Владельцы аттестатов, имеющих более одного WMID, могут задать уникальные для каждого характеристики (дополнительная информация и название (nick)) | |
| response/certinfo/wmids/row/@wmid | WMID | 12 цифр |
| response/certinfo/wmids/row/@info | Дополнительная информация о WMID. | |
| response/certinfo/wmids/row/@nickname | Уникальное для данного WMID имя (nick) | |
| response/certinfo/wmids/row/@datereg | Дата и время регистрации WMID в системе | |
| response/certinfo/userinfo | Персональные данные владельца аттестата, признаки проверки этих данных аттестатором и блокировки отображения персональных данных | |
| response/certinfo/userinfo/value/row | Персональные данные владельца аттестата. | |
| response/certinfo/userinfo/value/row/@ctype | Статус владельца | См. опорный словарь. ctype ="1" - Частное лицо ctype ="2" - Юридическое лицо |
| response/certinfo/userinfo/value/row/@jstatus | Для юридического лица. Статус (директор, представитель и др.) | См. опорный словарь. |
| response/certinfo/userinfo/value/row/@osnovainfo | Для юридического лица. На основании чего действует(устав, доверенность и др.) | |
| response/certinfo/userinfo/value/row/@locked | Информация об отзыве аттестата |
Если значение атрибута равно 1, то этот аттестат отозван и его статус эквивалентен аттестату псевдонима.
Параметр аналогичен response/certinfo/attestat/row/@recalled |
| response/certinfo/userinfo/value/row/@nickname | Название проекта, имя (nick) | |
| response/certinfo/userinfo/value/row/@infoopen | Дополнительная информация (направление деятельности, комментарии, информация рекламного характера | |
| response/certinfo/userinfo/value/row/@city | Фактическое местонахождение (город) организации или владельца аттестованного идентификатора | |
| response/certinfo/userinfo/value/row/@country | Фактическое местонахождение (страна) организации или владельца аттестованного идентификатора | |
| response/certinfo/userinfo/value/row/@zipcode | Фактическое местонахождение (почтовый индекс) организации или владельца аттестованного идентификатора | |
| response/certinfo/userinfo/value/row/@adres | Фактическое местонахождение (адрес) организации или владельца аттестованного идентификатора | |
| response/certinfo/userinfo/value/row/@fname | Фамилия владельца аттестованного идентификатора | |
| response/certinfo/userinfo/value/row/@iname | Имя владельца аттестованного идентификатора | |
| response/certinfo/userinfo/value/row/@oname | Отчество владельца аттестованного идентификатора | |
| response/certinfo/userinfo/value/row/@pnomer | Номер паспорта владельца аттестованного идентификатора | |
| response/certinfo/userinfo/value/row/@pdate | Дата выдачи паспорта ММ/ДД/ГГГГ | |
| response/certinfo/userinfo/value/row/@pcountry | Место (страна) выдачи паспорта | |
| response/certinfo/userinfo/value/row/@pcity | Место (город) выдачи паспорта | |
| response/certinfo/userinfo/value/row/@pbywhom | Место (кем выдан) выдачи паспорта | |
| response/certinfo/userinfo/value/row/@rcountry | Место (страна) постоянной регистрации | |
| response/certinfo/userinfo/value/row/@rcity | Место (город) постоянной регистрации | |
| response/certinfo/userinfo/value/row/@radres | Место (полный адрес) постоянной регистрации | |
| response/certinfo/userinfo/value/row/@bplace | Место рождения (населенный пункт, страна) | |
| response/certinfo/userinfo/value/row/@bday | Дата рождения (день) | |
| response/certinfo/userinfo/value/row/@bmonth | Дата рождения (месяц) | |
| response/certinfo/userinfo/value/row/@byear | Дата рождения (год) | |
| response/certinfo/userinfo/value/row/@name | Для юридического лица. Название организации | |
| response/certinfo/userinfo/value/row/@dirfio | Для юридического лица. Директор (ФИО) | |
| response/certinfo/userinfo/value/row/@buhfio | Для юридического лица. Гл. бухгалтер (ФИО) | |
| response/certinfo/userinfo/value/row/@inn | Для юридического лица. ИНН | |
| response/certinfo/userinfo/value/row/@okpo | Для юридического лица. ОКПО | |
| response/certinfo/userinfo/value/row/@okonx | Для юридического лица. ОКВЭД | |
| response/certinfo/userinfo/value/row/@jadres | Для юридического лица. Юридический адрес | |
| response/certinfo/userinfo/value/row/@jcountry | Для юридического лица. Юридический адрес (страна) | |
| response/certinfo/userinfo/value/row/@jcity | Для юридического лица. Юридический адрес (город) | |
| response/certinfo/userinfo/value/row/@jzipcode | Для юридического лица. Юридический адрес (почтовый индекс) | |
| response/certinfo/userinfo/value/row/@bankname | Для юридического лица. Банковские реквизиты. Название банка. | |
| response/certinfo/userinfo/value/row/@bik | Для юридического лица. Банковские реквизиты. БИК. | |
| response/certinfo/userinfo/value/row/@ks | Для юридического лица. Банковские реквизиты. Номер корреспондентского счета | |
| response/certinfo/userinfo/value/row/@rs | Для юридического лица. Банковские реквизиты. Номер расчетного счета | |
| response/certinfo/userinfo/value/row/@phonehome | Контактная информация владельца аттестованного идентификатора. Номер домашнего телефона. | |
| response/certinfo/userinfo/value/row/@phonemobile | Контактная информация владельца аттестованного идентификатора. Номер мобильного телефона. | |
| response/certinfo/userinfo/value/row/@icq | Контактная информация владельца аттестованного идентификатора. UIN ICQ | |
| response/certinfo/userinfo/value/row/@fax | Контактная информация владельца аттестованного идентификатора. Номер факса. | |
| response/certinfo/userinfo/value/row/@email | Контактная информация владельца аттестованного идентификатора. Адрес электронной почты. | |
| response/certinfo/userinfo/value/row/@web | Контактная информация владельца аттестованного идентификатора. Адрес интернет сайта. | |
| response/certinfo/userinfo/value/row/@phone | Контактная информация владельца аттестованного идентификатора. Номер контактного телефона. | |
| response/certinfo/userinfo/value/row/@cap_owner | Только для аттестатов Capitaller. WMID учредителя. | 12 цифр |
| response/certinfo/userinfo/value/row/@pasdoc | Признак проверки электронной копии паспорта администратором центра аттестации. | Если pasdoc = 1, то электронная копия проверена администратором центра аттестации. Если pasdoc = 0, то электронная копия не проверена администратором центра аттестации. |
| response/certinfo/userinfo/value/row/@inndoc | Признак проверки электронной копии свидетельства о постановке на налоговый учет администратором центра аттестации. | Если inndoc = 1, то электронная копия проверена администратором центра аттестации. Если inndoc = 0, то электронная копия не проверена администратором центра аттестации. |
| response/certinfo/userinfo/check-lock/row | Признак проверки персональных данных аттестатором и блокировки публичного отображения персональных данных. Атрибуты имеют имена, аналогичные тегам, описанным в блоке response/certinfo/userinfo/value/row Атрибуты могут принимать следующие значения: 00 - данное поле не проверено аттестатором и не заблокировано владельцем аттестата для публичного показа 01 - данное поле не проверено аттестатором и заблокировано владельцем аттестата для публичного показа 10 - данное поле проверено аттестатором и не заблокировано владельцем аттестата для публичного показа 11 - данное поле проверено аттестатором и заблокировано владельцем аттестата для публичного показа Например:Если атрибут @fname="10", то Фамилия владельца аттестата проверена аттестатором, выдавшим аттестат. Данное поле доступно для публичного просмотра. |
|
пример вызова интерфейса без формирования подписи (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
%>
пример вызова интерфейса с формированием подписи (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
%>
По вопросам использования данного интерфейса обращайтесь по электронной почте
