WebMoney Wiki

Wiki

Интерфейс X19

Проверка соответствия персональных данных владельца WM-идентификатора.

Интерфейс позволяет проверить соответствие указанных в запросе данных на их идентичность с персональными данными участника системы WebMoney Transfer.

Вопросы практического применения данного интерфейса всесторонне исследованы в следующих статьях Никиты Сенченко:

Порядок доступа к интерфейсу

Этот интерфейс доступен только участникам, зарегистрированным в каталоге Мегасток в следующих группах:
  1. Онлайн-обмен электронных валют
  2. Ввод-вывод электронных валют
  3. Мобильная связь

Для доступа к интерфейсу можно использовать WMID, зарегистрированный в каталоге Мегасток в указанных группах, а также любой WMID из этого же аттестата. Если у Вас в аттестате один WMID, Вы можете присоединить к аттестату дополнительный WMID и использовать его для доступа к интерфейсу X19. В случае, если Ваша заявка на регистрацию в каталоге Мегасток еще не рассмотрена, укажите в параметре userinfo/wmid WMID, которым подписывается запрос или авторизуйтесь на сайте https://verification.webmoney.ru/XTest/X19.aspx этим WMID и Вам будет предоставлена возможность протестировать работу интерфейса X19. Обновление списка WMID, допущенных к интерфейсу X19 производится каждый час.

Проверить наличие доступа к интерфейсу X19 можно на странице https://passport.webmoney.ru/asp/X19Permissions.asp

На этой странице Вы также можете:

  • Установить доверие на доступ к интерфейсу X19 для любого WMID с формальным (и выше) аттестатом (в случае, если Ваш WMID зарегистрирован в каталоге Мегасток в вышеперечисленных группах)
  • Получить доступ к интерфейсу X19 если Вы являетесь администратором бюджетного автомата Capitaller, который зарегистрирован в каталоге Мегасток в вышеперечисленных группах

Адреса

Формат запроса

<passport.request>
    <reqn></reqn>
        <lang></lang>
    <signerwmid></signerwmid>
    <sign></sign>
        <operation>
            <type></type>
                        <direction></direction>
            <pursetype></pursetype>
            <amount></amount>
        </operation>
        <userinfo>
            <wmid></wmid>
            <pnomer></pnomer>
            <fname></fname>
            <iname></iname>
            <bank_name></bank_name>
            <bank_account></bank_account>
            <card_number></card_number>
            <emoney_name></emoney_name>
            <emoney_id></emoney_id>
                        <phone></phone>
        </userinfo>
</passport.request>

Параметры запроса:

название назначение примечание
reqn номер запроса обязательный параметр, целое без знака, макс. количество цифр - 15; всегда должен быть больше номера предыдущего запроса
lang язык запроса необязательный параметр
ru - русский язык (значение по умолчанию)
en - английский язык
signerwmid WMID подписавшего запрос обязательный параметр
operation данные о совершенной операции
operation/type тип операции обязательный параметр
1 or cash - Ввод/вывод WM наличными в одном из обменных пунктов
2 or sdp - Ввод/вывод WM наличными через системы денежных переводов
3 or bank - Ввод/вывод WM на банковский счет
4 or card - Ввод/вывод WM на банковскую карту
5 or emoney - Обмен WM на электронную валюту других систем
6 or sms - Ввод WM за SMS (только operation/direction=2)
7 or mobile - Вывод WM на телефон - пополнение телефонного счета (только operation/direction=1)
operation/direction направление операции 1 or output - Вывод средств из системы (значение по умолчанию)
2 or input - Ввод средств в систему
для operation/type=6 разрешен только ввод средств в систему, поэтому разрешен только operation/direction=2
для operation/type=7 разрешен только вывод средств из системы, поэтому разрешен только operation/direction=1
operation/pursetype тип WM-кошелька, с/на которого произведен перевод обязательный параметр, WMZ, WMR, WME, WMU, WMB, WMX, WMG, WMK
operation/amount сумма перевода обязательный параметр, число с плавающей точкой (разделитель – .(точка) ) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 – не верно, 10.5 – верно, 9. – не верно, 9 – верно)
Для операций по выводу средств (operation/direction=1) необходимо указывать сумму, которая будет "списана" с кошелька участника системы без учета комиссии WM, для операций по вводу средств (operation/direction=2) необходимо указывать сумму, которая будет "зачислена на кошелек участника системы"
operation/id идентификатор (номер) операции в системе учета обменного сервиса рекомендуемый параметр, целое число без знака не больше 2147483647
- при использовании Web Merchant Interface передавать "внутренний номер покупки продавца" LMI_PAYMENT_NO
- при использовании интерфейса X1 передавать "номер счета" invoice\orderid
sign подпись запроса обязательный параметр, формируется из параметров: //reqn + //operation/type + //userinfo/wmid; используется только при авторизации с ключами WM Keeper WinPro (Classic)
userinfo данные об участнике системы
userinfo/wmid WMID участника обязательный параметр
Внимание! Для всех операций необходимо указать wmid участника системы, производящего операцию ввода или вывода
userinfo/pnomer Серия и номер паспорта обязательный для operation=1
userinfo/fname Фамилия участника обязательный для operation=1,2,3,4
userinfo/iname Имя участника обязательный для operation=1,2,3,4
userinfo/bank_name Название банка обязательный для operation=3,4
userinfo/bank_account Номер банковского счета обязательный для operation=3
userinfo/card_number Номер банковской карты обязательный для operation=4
userinfo/emoney_name Название платежной системы обязательный для operation=5
emoney_name=paypal.com для PayPal
emoney_name=moneybookers.com для Skrill (Moneybookers)
emoney_name=qiwi.ru для QIWI Кошелёк
emoney_name=money.yandex.ru для Яндекс.Деньги
emoney_name=easypay.by для EasyPay
Кошельки EasyPay, QIWI Кошелёк и Яндекс.Деньги "привязываются" к WMID через сервис https://banks.webmoney.ru
Регистрации в PayPal, Skrill (Moneybookers) должны быть прописаны в аттестате через сайт центра аттестации https://passport.webmoney.ru/asp/aProcess.asp?cmd=editplus или https://passport.webmoney.ua/asp/aProcess.asp?cmd=editplus
userinfo/emoney_id ID участника в платежной системе обязательный для operation=5
номер QIWI Кошелька необходимо указывать в 10-значном формате (без «8» или «+7»)
userinfo/phone номер мобильного телефона обязательный для operation=6 и operation=7
номер мобильного телефона необходимо указывать в международном формате
формат: код страны + код оператора + номер, без кодов 8, 0 или 00
например: 79101010101

Формат ответа:

<passport.response>
    <retval></retval>
    <retdesc></retdesc>
        <retid></retid>
    <userinfo>
        <iname></iname>
        <oname></oname>
    </userinfo>
</passport.response>

Параметры ответа:

название назначение примечание
retval код выполнения 0 - запрос выполнен успешно, переданные в запросе данные соответствуют данным, указанным в аттестате участника системы, другие значения означают, что при запросе произошла ошибка
2 - у signerwmid нет доступа к интерфейсу
403 - запрос информации по участнику системы userinfo/wmid не возможен
404 - указанные параметры не соответствуют участнику системы userinfo/wmid
405 - участнику системы userinfo/wmid необходимо получить формальный (или выше) аттестат
406 - запрос информации по бюджетным автоматам Capitaller не возможен
407 - участнику системы userinfo/wmid необходимо загрузить на странице https://passport.webmoney.ru/asp/Upload.asp или https://passport.webmoney.ua/asp/Upload.asp цветную отсканированную копию страницы паспорта с фотографией и дождаться окончания ее проверки
408 - на указанную банковскую платежную карту не разрешен вывод средств для участника системы userinfo/wmid, см. http://link.wmtransfer.com/1Q
409 - с момента регистрации в системе userinfo/wmid еще не прошло 7 суток
410 - с момента изменения номера паспорта участником userinfo/wmid еще не прошло 7 суток
415 - участнику системы userinfo/wmid необходимо проверить свой телефон, см. https://passport.webmoney.ru/asp/mobilever.asp или https://passport.webmoney.ua/asp/mobilever.asp
416 - пополнение баланса указанного телефона невозможно
417 - пополнение баланса указанного телефона невозможно
418 - пополнение баланса указанного телефона невозможно, превышен лимит для данного телефона
419 - пополнение баланса указанного телефона невозможно, превышен лимит для отправителя
420 - операция доступна только для граждан Российской Федерации
421 - вывод на банковские карты с WMZ кошельков резидентам Европейской Экономической Зоны не доступен
422 - вывод на банковские карты с WME кошельков доступен только резидентам Европейской Экономической Зоны
427 - неверно указан номер телефона (номер некорректной длины)
428 - телефон должен быть указан в международном формате (с кодом страны)
451 - данная платежная система не поддерживается интерфейсом
452 - неверно указан ID участника
499 - превышен лимит запросов
500 - не имеющая отдельного кода ошибка, подробности см. в значении retdesc
retdesc расшифровка кода выполнения
retid ID ответа уникальный идентификатор ответа, создается при каждом обращении к интерфейсу
userinfo/iname Имя участника возвращается при retval=0
userinfo/oname Отчество участника возвращается при retval=0

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

16 декабря 2014 года
  • Разрешено использование титульных знаков WMK
27 ноября 2014 года
  • Вводится новый параметр operation/id - идентификатор операции в системе учета обменного сервиса.
20 января 2014 года
  • Разрешено использование титульных знаков WMX
11 декабря 2011 года
  • Вводится новый тип операций "Вывод WM на телефон" (7 or mobile). Данный тип операций необходимо использовать при пополнении участником системы WebMoney Transfer баланса счета мобильного телефона.
29 июня 2010 года
  • Для операции "Обмен WM на электронную валюту других систем" (5 or emoney) включена поддержка прикрепленных к WMID кошельков (счетов) платежных систем EasyPay и Яндекс.Деньги (см. https://banks.webmoney.ru)
01 июня 2010 года
  • Добавлена поддержка английского языка (см. параметр lang)
28 мая 2010 года
  • Для операции "Обмен WM на электронную валюту других систем" (5 or emoney) включена поддержка аккаунтов (счетов) платежных систем PayPal, Moneybookers и QIWI Кошелёк. Счета можно указать на странице https://passport.webmoney.ru/asp/aProcess.asp?cmd=editplus
  • Вводится новый тип операций "Ввод WM за SMS" (6 or sms). Для данного типа операций необходимо указывать номер проверенного мобильного телефона. Если телефон еще не проверен, сделать это можно на странице https://passport.webmoney.ru/asp/mobilever.asp
  • Вводится специальная обработка операции "Ввод WM наличными в одном из обменных пунктов" (operation/type=1 и operation/direction=2) при покупке менее 2000 WMZ. Если в параметры userinfo/fname, userinfo/iname и userinfo/pnomer вместо фамилии, имени и номера паспорта соответственно указать прочерк "-", то проверка соответствия переданных данных и данных аттестата не производится.
16 апреля 2010 года
  • Вводится новый необязательный параметр operation/direction - направление операции.
15 апреля 2010 года
  • Для операции "Ввод/вывод WM наличными в одном из обменных пунктов" (1 or cash) вводится обязательное указание фамилии и имени участника системы;
  • Для операций "Ввод/вывод WM наличными через системы денежных переводов" (2 or sdp), "Ввод/вывод WM на банковский счет" (3 or bank) и "Ввод/вывод WM на банковскую карту" (4 or card) для владельцев персональных (и выше) аттестатов не требуется наличие скана паспорта;

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