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>
            <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 - Вам необходимо пройти PhotoID или VideoID идентификацию
438 - превышен ежемесячный лимит на число банковских карт, используемых для вывода средств
439 - превышен ежемесячный лимит на число аккаунтов платежных систем, используемых для вывода средств
440 - превышен ежемесячный лимит на число аккаунтов платежных систем, используемых для вывода средств
441 - вам необходимо указать почтовый адрес (страна, город и т.д.) - https://link.web.money/qzptV
442 - проверьте полноту указанного Вами адреса (страна, индекс, город и т.д.) и подтвердите его достоверность любым из предложенных способов - https://link.web.money/hkVUk
448 - аккаунт "закреплен" для вывода за другим участником системы (с другой фамилией)
451 - данная платежная система не поддерживается интерфейсом
452 - неверно указан ID участника
499 - превышен лимит запросов
500 - не имеющая отдельного кода ошибка, подробности см. в значении retdesc
retdesc расшифровка кода выполнения
retid ID ответа уникальный идентификатор ответа, создается при каждом обращении к интерфейсу и должен использоваться при формировании примечания к обменной трансакции

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

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

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