Перейти в режим автора

Интерфейс X11

Интерфейс X11. Получение информации из аттестата владельца по WM-идентификатору.

( доступ к информации из аттестата возможен также с использованием OAuth )
  • формат запроса:
<request>
    <wmid></wmid>
    <passportwmid></passportwmid>
    <sign></sign>
        <params>
            <dict></dict>
            <info></info>
            <mode></mode>
        </params>
</request>
  • параметры запроса:
название назначение примечание
wmid WM-идентификатор, подписавший запрос. Только WM Keeper WinPro 12 цифр
passportwmid WM-идентификатор аттестата 12 цифр обязательный параметр
sign подпись запроса сформированная с помощью модуля WMSigner Конкатенация параметров: wmid + passportwmid
params параметры запроса
params/dict отображение "опорного словаря" В структуре возвращаемых некоторые значения заменяются специальным кодом (Например, тип аттестата формальный представляется цифрой 110, начальный - 120, персональный - 130, продавца - 135). Словарь позволяет ознакомиться со всеми значениями и использовать их при работе с данным интерфейсом. Если dict="1" - словарь отображается. Если dict="0"(установлено по умолчанию) - словарь не отображается.
params/info отображение персональных данных(паспортные данные+контактная информация) владельца аттестата Если info="1"(установлено по умолчанию) - персональные данные отображаются. Если info="0" - персональные данные не отображаются
params/mode проверка принадлежности WM-идентификатора, подписавшего запрос, списку доверенных идентификаторов для проверяемого аттестата Каждый владелец аттестата может добавить в список доверенных любой WM-идентификатор. Доверенный идентификатор получает возможность просмотра всех данных аттестата, даже тех, которые заблокированы для публичного просмотра. Если mode="1" - проверка принадлежности WM-идентификатора, подписавшего запрос, списку доверенных идентификаторов для проверяемого аттестата осуществляется. Если mode="0"(установлено по умолчанию)- проверка не производится

Использовать аутентификацию с использованием ключей WM Keeper WinPro в запросе необходимо лишь в случае если WMID, подписывающий запрос является доверенным идентификатором для проверяемого аттестата. Установка доверительных отношений производится на сайте центра аттестации. Доверенные WMID могут просматривать все персональные данные владельца аттестата, даже если их видимость была заблокирована владельцем аттестата. Оказание доверия является добровольной операцией, выполняемой владельцем аттестата, который при помощи специального интерфейса может вносить в список доверенных или удалить из него любой WMID.
Если доверительных отношений между проверяемым WMID и WMID, подписавшим запрос нет, то в запросе можно указать лишь параметр passportwmid. Структура запроса (наличие в нем всех описанных ранее тегов) должна быть неизменной в любом случае.

  • формат ответа:
<?xml version="1.0" encoding="windows-1251"?>
<response retval="">
<fullaccess></fullaccess>
    <certinfo wmid="">
        <attestat>
                <row cid="" tid="" recalled="" datecrt="" regnickname="" regwmid="" status="" notary=""/>
        </attestat>
        <wmids>
            <row wmid="" info="" nickname="" datereg="" ctype="" companyname="" companyid="" phone="" .../>
            <row wmid="" info="" nickname="" datereg="" ctype="" companyname="" companyid="" phone="" .../>
        </wmids>
        <userinfo>
            <value>
                <row nickname="" infoopen="" city="" region="" citid="" 
                                  countryid="" country="" zipcode="" adres="" fname="" iname="" oname="" 
                                  pnomer="" pdate="" pday="" pmonth="" pyear="" pcountryid="" pcountry="" 
                                  pbywhom="" bplace="" 
                                  bday="" bmonth="" byear="" phone="" email="" web="" 
                                  cap_owner="" pasdoc="" inndoc="" sex="" .../>
            </value>
            <check-lock>
                <row nickname="" infoopen="" city="" region="" country="" 
                                   adres="" zipcode="" fname="" iname="" oname="" pnomer="" pdate="" 
                                   pbywhom="" pcountry="" pcity="" bplace="" 
                                   bday="" inn="" email="" web="" phone="" sex="" .../>
            </check-lock>
            <weblist>
                <row url="" check-lock="" ischeck="" islock=""/>
            </weblist>
            <extendeddata>
                <row type="" account="" check-lock=""/>
            </extendeddata>
        </userinfo>
    </certinfo>
</response>
  • параметры ответа:
название назначение примечание
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 - юридический статус владельца аттестата (частное лицо или юридическое)
tid - тип аттестата
response/certinfo/attestat/row Информация о типе аттестата
response/certinfo/attestat/row/@tid Тип аттестата tid=100 - аттестат псевдонима
tid=110 - формальный аттестат
tid=120 - начальный аттестат
tid=130 - персональный аттестат
tid=135 - аттестат продавца
tid=136 - аттестат capitaller, учрежденный группой физических лиц
tid=137 - аттестат capitaller, учрежденный юридическим лицом
tid=138 - аттестат расчетного автомата
tid=140 - аттестат разработчика
tid=150 - аттестат регистратора
tid=170 - аттестат гаранта
tid=190 - аттестат сервиса WebMoney Transfer
tid=200 - аттестат сервиса WebMoney Transfer
tid=300 - аттестат оператора
response/certinfo/attestat/row/@cid Номер
response/certinfo/attestat/row/@recalled Информация об отказе в обслуживании recalled=1 - владельцу данного аттестата отказано в обслуживании в системе
response/certinfo/attestat/row/@datecrt Дата и время (UTC+3) выдачи аттестата В формате гггг-мм-ддТчч:мм:сс.ммм
response/certinfo/attestat/row/@datecrt110 Дата и время (UTC+3) выдачи формального аттестата В формате гггг-мм-ддТчч:мм:сс.ммм
response/certinfo/attestat/row/@dateupd Дата и время (UTC+3) последнего изменения данных В формате гггг-мм-ддТчч:мм:сс.ммм
response/certinfo/attestat/row/@regnickname Название проекта, имя (nick) аттестатора, выдавшего данный аттестат
response/certinfo/attestat/row/@regwmid WMID аттестатора, выдавшего данный аттестат 12 цифр
response/certinfo/attestat/row/@status признак прохождения вторичной проверки только для начальных и выше аттестатов
10 - не пройдена
11 - пройдена
response/certinfo/attestat/row/@notary особенность получения аттестата только для начальных и выше аттестатов
0 - Аттестат выдан после личной встречи с аттестатором (устанавливается только после вторичной проверки)
1 - Аттестат выдан по нотариально заверенным документам (устанавливается только после вторичной проверки)
2 - Аттестат выдан автоматически, по результатам успешного пополнения кошелька (только начальные аттестаты)
3 - Аттестат выдан после проверки VideoID и проверки банковского счета (только перснальные аттестаты)
4 - Аттестат выдан после проверки VideoID и проведения собеседования с регистратором в формате видеоинтервью (только перснальные аттестаты)
5 - Аттестат выдан после проверки VideoID (только начальные аттестаты)
response/certinfo/wmids/row Информация о всех WMID, прикрепленных к данному аттестату. Владельцы аттестатов, имеющих более одного WMID, могут задать уникальные для каждого характеристики (дополнительная информация и название (nick))
response/certinfo/wmids/ Список всех WMID данного аттестата и некоторые данные этих WMID
response/certinfo/wmids/row/@wmid WMID 12 цифр
response/certinfo/wmids/row/@info Дополнительная информация о WMID.
response/certinfo/wmids/row/@nickname Псевдоним (название проекта)
response/certinfo/wmids/row/@datereg Дата и время (UTC+3) регистрации WMID в системе В формате гггг-мм-ддТчч:мм:сс.ммм
response/certinfo/wmids/row/@phone Номер мобильного телефона данного WMID
response/certinfo/wmids/row/@email Адрес электронной почты данного WMID
response/certinfo/wmids/row/@phone-check-lock Признаки проверки номера мобильного телефона данного WMID см. описание ниже в response/certinfo/userinfo/check-lock/row
response/certinfo/wmids/row/@email-check-lock Признаки проверки email данного WMID см. описание ниже в response/certinfo/userinfo/check-lock/row
response/certinfo/wmids/row/@ctype Юридический статус WMID WMID используется в интересах:
ctype=1 - физического лица
ctype=2 - юридического лица
response/certinfo/wmids/row/@companyname Название компании Заполняется только для юридических лиц.
response/certinfo/wmids/row/@companyid Регистрационный номер компании ИНН (для российских компаний) КОД ЕГРПОУ (для украинских), Certificate number и т.п.
Заполняется только для юридических лиц.
response/certinfo/wmids/row/@jcountryreg Государство, где зарегистрирована компания Заполняется только для юридических лиц.
response/certinfo/wmids/row/@jcountryregid Код государства, где зарегистрирована компания Заполняется только для юридических лиц.
справочник кодов
response/certinfo/userinfo Персональные данные владельца аттестата, признаки проверки этих данных
аттестатором и блокировки отображения персональных данных
response/certinfo/userinfo/value/row Персональные данные владельца аттестата.
response/certinfo/userinfo/value/row/@nickname Название проекта, имя (nickname)
response/certinfo/userinfo/value/row/@countryid Почтовый адрес - код страны страны справочник кодов
response/certinfo/userinfo/value/row/@country Почтовый адрес - страна
response/certinfo/userinfo/value/row/@city Почтовый адрес - город
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/@pdateend Дата окончания срока действия паспорта в формате мм/дд/гггг
response/certinfo/userinfo/value/row/@pcountry Государство, выдавшее паспорт
response/certinfo/userinfo/value/row/@pcountryid Код государства, выдавшее паспорт справочник кодов
response/certinfo/userinfo/value/row/@pbywhom Код или наименование подразделения (органа), выдавшего паспорт
response/certinfo/userinfo/value/row/@pcode Код подразделения выдавшего паспорт заполнено только у владельцев паспорта гражданина Российской Федерации
response/certinfo/userinfo/value/row/@inn Персональный идентификатор для граждан Российской Федерации - ИНН
для граждан Украины - ИНН
для граждан Республики Беларусь - идентификационный номер
для граждан Республики Казахстан - индивидуальный идентификационный номер (ИИН)
response/certinfo/userinfo/value/row/@snils СНИЛС Страховой номер индивидуального лицевого счёта для граждан Российской Федерации и временно пребывающих иностранцев
response/certinfo/userinfo/value/row/@registrationtypeid4 Статус идентификации в ТОО «Гермес Гарант Групп»
(обслуживание K-кошельков)		 0 - без идентификации
3011 - упрощенная идентификация
3021 - полная идентификация
2001 - юридическое лицо
response/certinfo/userinfo/value/row/@registrationtypeid8 Статус идентификации в ООО «CHOYKHONA» (обслуживание S-кошельков) 0 - без идентификации
3011 - идентификация (активация) пройдена
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/@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/@identification Признак автоматической сверки паспортных данных при identification=1 персональные данные владельца данного WMID успешно проверены через федеральную (государственную) систему идентификации (СМЭВ и т.п.)
response/certinfo/userinfo/value/row/@regdoc Признак сверки администратором центра аттестации электронной копии страницы паспорта или другого документа с информацией о месте жительства. regdoc=1 - есть проверенный документ
regdoc=0 - нет проверенного документа
response/certinfo/userinfo/value/row/@billdoc Признак сверки администратором центра аттестации электронной копии счета за коммунальные услуги с информацией о месте жительства billdoc=1 - есть проверенный документ
billdoc=0 - нет проверенного документа
response/certinfo/userinfo/value/row/@inndoc Признак сверки электронной копии свидетельства о постановке на
налоговый учет гражданина РФ администратором центра аттестации.		 inndoc=1 - есть проверенный документ
inndoc=0 - нет проверенного документа
response/certinfo/userinfo/value/row/@photoid Наличие у данного WMID проверенного PhotoID photoid=1 - есть проверенный PhotoID
photoid=0 - нет проверенного PhotoID
response/certinfo/userinfo/value/row/@photoiddate Дата и время (UTC+3) проверки PhotoID В формате ггг-мм-ддТчч:мм:сс
response/certinfo/userinfo/value/row/@videoid Наличие у данного WMID проверенного VideoID videoid=1 - есть проверенный VideoID
videoid=0 - нет проверенного VideoID
response/certinfo/userinfo/value/row/@videoiddate Дата и время (UTC+3) проверки VideoID В формате гггг-мм-ддТчч:мм:сс
response/certinfo/userinfo/value/row/@sex пол sex=0 - не установлен
sex=1 - мужской
sex=2 - женский
response/certinfo/userinfo/value/row/@infoopen Дополнительная информация (направление деятельности, комментарии, информация рекламного характера
response/certinfo/userinfo/check-lock/row Признак проверки персональных данных аттестатором и блокировки публичного отображения персональных данных. Строка. Атрибуты имеют имена, аналогичные тегам, описанным в блоке response/certinfo/userinfo/value/row
Атрибуты могут принимать следующие значения:
00 - данное поле не проверено аттестатором и не заблокировано владельцем аттестата для публичного показа
01 - данное поле не проверено аттестатором и заблокировано владельцем аттестата для публичного показа
10 - данное поле проверено аттестатором и не заблокировано владельцем аттестата для публичного показа
11 - данное поле проверено аттестатором и заблокировано владельцем аттестата для публичного показа
Например: Если атрибут @fname="10", то Фамилия владельца аттестата проверена аттестатором, выдавшим аттестат. Данное поле доступно для публичного просмотра.

Доступ к информации предоставляемой интерфейсом возможен также с использованием OAuth

История изменений

15 июля 2021 года

Введен новый атрибут:
  • response/certinfo/userinfo/value/row/@registrationtypeid5 - Статус идентификации в «Nobel Financial Limited»

03 июня 2021 года

Введен новый атрибут:
  • response/certinfo/userinfo/value/row/@registrationtypeid4 - Статус идентификации в ТОО «Гермес Гарант Групп»

29 августа 2019 года

Введен новый атрибут:
  • response/certinfo/userinfo/value/row/@registrationtypeid1 - Статус идентификации в АО Банк «ККБ»

06 февраля 2019 года

Введены новые атрибуты:
  • response/certinfo/userinfo/value/row/@photoiddate - Дата и время (UTC+3) проверки PhotoID
  • response/certinfo/userinfo/value/row/@videoiddate - Дата и время (UTC+3) проверки VideoID

08 октября 2018 года

Введен новый атрибут:
  • response/certinfo/userinfo/value/row/@videoid - Наличие у данного WMID проверенного VideoID

13 марта 2017 года

Введен новый атрибут:
  • response/certinfo/userinfo/value/row/@snils - Страховой номер индивидуального лицевого счёта (СНИЛС)

26 мая 2015 года

Введен новый атрибут:
  • response/certinfo/userinfo/value/row/@pdateend - Дата окончания срока действия паспорта

19 июня 2014 года

Введен новый атрибут:
  • response/certinfo/userinfo/value/row/@pcountryid - Код государства, выдавшего паспорта (см. справочник кодов)
Упразднен атрибут:
  • response/certinfo/userinfo/value/row/@pcity - Место (город) выдачи паспорта

20 декабря 2013 года

Введены атрибуты:
  • response/certinfo/userinfo/value/row/@regdoc - Признак сверки администратором центра аттестации электронной копии страницы паспорта гражданина РФ с информацией о месте постоянной регистрации (регистрации по месту жительства)
  • response/certinfo/userinfo/value/row/@photoid - Наличие у данного WMID проверенного PhotoID

см. также XML-интерфейсы