Интерфейс X19

Интерфейс 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) для использования данной проверки обязательно переведите все запросы на адрес https://apipassport.webmoney.ru/XMLCheckUser.aspx или https://apipassport.webmoney.ru/XMLCheckUserCert.aspx
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, WMY, WMG
operation/amount сумма перевода обязательный параметр, число с плавающей точкой (разделитель – .(точка) ) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 – не верно, 10.5 – верно, 9. – не верно, 9 – верно)
sign подпись запроса обязательный параметр, формируется из параметров: //reqn + //operation/type + //userinfo/wmid; используется только при авторизации с ключами WM Keeper Classic
userinfo данные об участнике системы
userinfo/wmid WMID участника обязательный параметр
для operation=7 в случае, если пополнение телефонного счета производится чеком Paymer, WM-картой или WM-чеком, вместо userinfo/wmid можно указать signerwmid
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=rbkmoney.ru для RBK Money
emoney_name=paypal.com для PayPal
emoney_name=moneybookers.com для Moneybookers
emoney_name=qiwi.ru для QIWI Кошелёк
emoney_name=money.yandex.ru для Яндекс.Деньги
emoney_name=easypay.by для EasyPay


Кошельки RBK Money, EasyPay и Яндекс.Деньги “привязываются” к WMID через сервис https://banks.webmoney.ru
Регистрации в других системах (PayPal, Moneybookers, QIWI Кошелёк) должны быть прописаны в аттестате через сайт центра аттестации https://passport.webmoney.ru/asp/aProcess.asp?cmd=editplus
userinfo/emoney_id ID участника в платежной системе обязательный для operation=5
userinfo/phone номер мобильного телефона обязательный для operation=6 и operation=7
номер мобильного телефона необходимо указывать в международном формате
формат: код страны + код оператора + номер, без кодов 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 цветную отсканированную копию всех значимых страниц паспорта и дождаться окончания их проверки
408 – на указанную банковскую платежную карту не разрешен вывод средств для участника системы userinfo/wmid, см. http://link.wmtransfer.com/1Q
409 – с момента регистрации в системе userinfo/wmid еще не прошло 7 суток
415 – участнику системы userinfo/wmid необходимо проверить свой телефон, см. https://passport.webmoney.ru/asp/mobilever.asp
416 – пополнение баланса указанного телефона невозможно
417 – пополнение баланса указанного телефона невозможно
451 – данная платежная система не поддерживается интерфейсом
452 – неверно указан ID участника
499 – превышен лимит запросов
500 – неизвестная ошибка
retdesc расшифровка кода выполнения
retid ID ответа уникальный идентификатор ответа, создается при каждом обращении к интерфейсу
userinfo/iname Имя участника возвращается при retval=0
userinfo/oname Отчество участника возвращается при retval=0

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

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 вместо фамилии, имени и номера паспорта соответственно указать прочерк “-”, то проверка соответствия переданных данных и данных аттестата не производится.

23 апреля 2010 года

  • Для операции “Обмен WM на электронную валюту других систем” (5 or emoney) включена поддержка прикрепленных к WMID кошельков платежной системы RBK Money (см. https://banks.webmoney.ru)

16 апреля 2010 года

  • Вводится новый необязательный параметр operation/direction – направление операции.

15 апреля 2010 года

  • Для операции “Ввод/вывод WM наличными в одном из обменных пунктов” (1 or cash) вводится обязательное указание фамилии и имени участника системы;
  • Для операций “Ввод/вывод WM наличными через системы денежных переводов” (2 or sdp), “Ввод/вывод WM на банковский счет” (3 or bank) и “Ввод/вывод WM на банковскую карту” (4 or card) для владельцев персональных (и выше) аттестатов не требуется наличие скана паспорта;

11 декабря 2011 года

  • Вводится новый тип операций “Вывод WM на телефон” (7 or mobile). Данный тип операций необходимо использовать при пополнении участником системы WebMoney Transfer баланса счета мобильного телефона.

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

Категория: XML-интерфейсы
This article in other languages: English