Интерфейс X19

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

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

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

• XML-интерфейсы. Часть 4. X19.
• Ввод и вывод: что нужно делать обменным пунктам и их клиентам.

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

Этот интерфейс доступен только участникам, зарегистрированным в каталоге Мегасток в следующих группах:

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, который зарегистрирован в каталоге Мегасток в вышеперечисленных группах

Адреса¶

• URL для передачи запроса с авторизацией ключами WM Keeper WinPro (Classic) - https://apipassport.webmoney.ru/XMLCheckUser.aspx
  метод - POST

• URL для передачи запроса с авторизацией сертификатом WM Keeper WebPro (Light) – https://apipassportcrt.webmoney.ru/XMLCheckUserCert.aspx
  метод - POST

• URL для тестирования интерфейса https://verification.webmoney.ru/XTest/X19.aspx

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

<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) 8 or blockchain - Обмен 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, WMV
operation/amount	сумма перевода	обязательный параметр, число с плавающей точкой (разделитель – .(точка) ) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 – не верно, 10.5 – верно, 9. – не верно, 9 – верно) Для операций по выводу средств (operation/direction=1) необходимо указывать сумму, которая будет "списана" с кошелька участника системы без учета комиссии WM, для операций по вводу средств (operation/direction=2) необходимо указывать сумму, которая будет "зачислена на кошелек участника системы" Внимание! для operation=8 (Обмен WEBMONEY на BТС или BCH) сумма перевода должна быть не менее 0,001 BTC или 0,001 BCH
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=skrill.com для Skrill emoney_name=alipay.com для Alipay emoney_name=qiwi.ru для QIWI emoney_name=money.yandex.ru для Яндекс.Деньги
		Кошельки QIWI и Яндекс.Деньги "привязываются" к WMID через banks.webmoney.ru Аккаунты (счета) в PayPal, Skrill, Alipay "привязываются" к WMID через сайты центра аттестации: passport.webmoney.ru
userinfo/emoney_id	ID участника в платежной системе	обязательный для operation=5 номер QIWI Кошелька необходимо указывать в 10-значном формате (без «8» или «+7»)
userinfo/phone	номер мобильного телефона	обязательный для operation=6 и operation=7 номер мобильного телефона необходимо указывать в международном формате формат: код страны + код оператора + номер, без кодов 8, 0 или 00 например: 79101010101
userinfo/crypto_name	Название криптовалюты	обязательный для operation=8 crypto_name=bitcoin для Bitcoin crypto_name=bitcoincash для Bitcoin Cash Внимание! При обмене WEBMONEY на Bitcoin и Bitcoin Cash сумма перевода должна быть не менее 0,001 BTC и 0,001 BСH соответственно
		Для обмена WEBMONEY на BTC необходимо использовать BTC-адреса, ассоциированные с вашими X-кошельками в WEBMONEY. Узнать BTC-адрес можно на сайте wmx.wmtransfer.com Для обмена WEBMONEY на BCH необходимо использовать BCH-адреса, ассоциированные с вашими H-кошельками в WEBMONEY. Узнать BCH-адрес можно на сайте wmh.wmtransfer.com
userinfo/crypto_address	Адрес для получения криптовалюты	обязательный для operation=8 Bitcoin-адрес

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

<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 цветную отсканированную копию страницы паспорта с фотографией и дождаться окончания ее проверки 408 - на указанную банковскую платежную карту не разрешен вывод средств для участника системы userinfo/wmid, см. http://link.wmtransfer.com/1Q 409 - с момента регистрации в системе userinfo/wmid еще не прошло 7 суток 410 - с момента изменения номера паспорта участником userinfo/wmid еще не прошло 7 суток 411 - необходимо создать WMX-кошелек, уточнить на wmx.wmtransfer.com соответствующий этому кошельку Bitcoin-адрес и использовать его для обмена WEBMONEY на Bitcoin 415 - участнику системы userinfo/wmid необходимо проверить свой телефон, см. https://passport.webmoney.ru/asp/mobilever.asp 416 - пополнение баланса указанного телефона невозможно 417 - пополнение баланса указанного телефона невозможно 418 - пополнение баланса указанного телефона невозможно, превышен лимит для данного телефона 419 - пополнение баланса указанного телефона невозможно, превышен лимит для отправителя 420 - операция доступна только для участников системы, предоставивших данные паспорта гражданина Российской Федерации 421 - вывод на банковские карты с WMZ кошельков резидентам Европейской Экономической Зоны не доступен 422 - вывод на банковские карты с WME кошельков доступен только резидентам Европейской Экономической Зоны 426 - вывод средств на указанную карту (счет) невозможен 427 - неверно указан номер телефона (номер некорректной длины) 428 - телефон должен быть указан в международном формате (с кодом страны) 430 - операция доступна только для граждан Узбекистана 451 - данная платежная система не поддерживается интерфейсом 452 - неверно указан ID участника 499 - превышен лимит запросов 500 - не имеющая отдельного кода ошибка, подробности см. в значении retdesc
retdesc	расшифровка кода выполнения
retid	ID ответа	уникальный идентификатор ответа, создается при каждом обращении к интерфейсу
userinfo/iname	Имя участника	возвращается при retval=0
userinfo/oname	Отчество участника	возвращается при retval=0

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

27 мая 2019 года
Введен лимит при выводе WM на банковские карты через обменные пункты. В месяц персонально для каждого участника системы:

• Формальный аттестат: 5000 USD (или эквивалентная сумма в другой валюте)
• Начальный аттестат: 10000 USD (или эквивалентная сумма в другой валюте)
• Персональный аттестат: 100000 USD (или эквивалентная сумма в другой валюте)
• Продавцы и регистраторы: нет лимитов

1 сентября 2017 года
Разрешен обмен титульных знаков WEBMONEY на Bitcoin Cash (на ассоциированные с WMH-кошельками BCH-адреса)

22 июня 2017 года
Разрешен обмен титульных знаков WEBMONEY на Bitcoin (на ассоциированные с WMX-кошельками BTC-адреса)

20 июня 2017 года
Добавлена поддержка платежной системы Alipay

08 июня 2017 года
Прекращена поддержка платежной системы EasyPay

01 июня 2017 года
Разрешено использование титульных знаков WMV

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-интерфейсы