Интерфейс X19

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

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

Адреса¶

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

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

• Страница для проверки интерфейса 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>
            <id></id>
        </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>
            <crypto_name></crypto_name>
            <crypto_address></crypto_address>
            <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, WME, WMB, WMX, WMG, WMK, WMV, WMY, и т.п.
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 paypal для PayPal alipay для Alipay и др. См. полный список
userinfo/emoney_id	ID участника в платежной системе	обязательный для operation=5
userinfo/phone	Номер мобильного телефона	обязательный для operation=6 и operation=7 номер мобильного телефона необходимо указывать в международном формате формат: код страны + код оператора + номер, без кодов 8, 0 или 00 например: 79101010101
userinfo/crypto_name	Тикер криптовалюты	обязательный для operation=8 BTC для Bitcoin, ETH для Ethereum и т.п. Cписок тикеров
userinfo/crypto_address	Адрес для получения криптовалюты	обязательный для operation=8

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

<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 - банковская карта "закреплена" для вывода за другим участником системы (с другой фамилией) 409 - с момента регистрации в системе userinfo/wmid еще не прошло 7 суток 410 - с момента изменения номера паспорта участником userinfo/wmid еще не прошло 7 суток 415 - участнику системы userinfo/wmid необходимо проверить свой телефон, см. https://passport.webmoney.ru/asp/mobilever.asp 416 - пополнение баланса указанного телефона невозможно 417 - пополнение баланса указанного телефона невозможно 418 - превышен лимит для получателя платежа (банковская карта, счет или телефон) 419 - превышен лимит на вывод средств из системы для отправителя платежа 420 - операция доступна только для участников системы, предоставивших данные паспорта гражданина Российской Федерации 421 - вывод на банковские карты с WMZ кошельков резидентам Европейской Экономической Зоны не доступен 422 - вывод на банковские карты с WME кошельков доступен только резидентам Европейской Экономической Зоны 426 - вывод средств на указанную карту (счет) невозможен 427 - неверно указан номер телефона (номер некорректной длины) 428 - телефон должен быть указан в международном формате (с кодом страны) 429 - превышен лимит числа плательщиков для данного счета 430 - операция доступна только для граждан Узбекистана 431 - сервис расчета лимитов недоступен, повторите операцию позже 432 - вывод на банковские карты с WMK кошельков недоступен в вашей стране 433 - не пройдена идентификация K-кошелька 434 - операция недоступна в Вашей стране 435 - операция недоступна для участников системы, проживающих в Российской Федерации 436 - операция недоступна для участников системы, проживающих в Украине 437 - Вам необходимо пройти VideoID идентификацию 438 - превышен ежемесячный лимит на число банковских карт, используемых для вывода средств 439 - превышен ежемесячный лимит на число аккаунтов платежных систем, используемых для вывода средств 440 - превышен ежемесячный лимит на число аккаунтов платежных систем, используемых для вывода средств 441 - вам необходимо указать почтовый адрес (страна, город и т.д.) - https://link.web.money/qzptV 442 - проверьте полноту указанного Вами адреса (страна, индекс, город и т.д.) и подтвердите его достоверность любым из предложенных способов - https://link.web.money/hkVUk 443 - Вам необходимо пройти VideoID идентификацию. https://link.web.money/oErsG 448 - аккаунт "закреплен" для вывода за другим участником системы (с другой фамилией) 451 - данная платежная система не поддерживается интерфейсом 452 - неверно указан ID участника 499 - превышен лимит запросов 500 - не имеющая отдельного кода ошибка, подробности см. в значении retdesc
retdesc	расшифровка кода выполнения
retid	ID ответа	уникальный идентификатор ответа, создается при каждом обращении к интерфейсу и должен использоваться при формировании примечания к обменной трансакции

Добавление платежных систем¶

Если Ваш обменный пункт планирует предоставлять услуги по вводу или выводу титульных знаков WM в платежные системы, которых нет в списке платежных систем данного интерфейса, пришлите ее описание в Службу поддержки WebMoney (название системы, адрес сайта, что является идентификатором в данной платежной системе).

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