| Правильная ссылка на эту статью: |
Интерфейс X19
Проверка соответствия персональных данных владельца WM-идентификатора.¶
Интерфейс позволяет проверить соответствие указанных в запросе данных на их идентичность с персональными данными участника системы WebMoney Transfer.
Вопросы практического применения данного интерфейса всесторонне исследованы в следующих статьях Никиты Сенченко:
Порядок доступа к интерфейсу¶
Этот интерфейс доступен только участникам, зарегистрированным в каталоге Мегасток в следующих группах:Для доступа к интерфейсу можно использовать 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 на Bitcoin) сумма перевода должна быть не менее 0,001 BTC |
| 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 passport.webmoney.ua |
||
| 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 Внимание! При обмене WEBMONEY на Bitcoin сумма перевода должна быть не менее 0,001 BTC |
| Для обмена необходимо использовать Bitcoin-адреса, ассоциированные с вашими X-кошельками в WEBMONEY Узнать Bitcoin-адрес можно на сайте wmx.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 или https://passport.webmoney.ua/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 или 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 |
История изменений¶
22 июня 2017 года- Разрешен обмен титульных знаков WEBMONEY на Bitcoin (на ассоциированные с WMX-кошельками Bitcoin-адреса)
- Добавлена поддержка платежной системы Alipay
- Прекращена поддержка платежной системы EasyPay
- Разрешено использование титульных знаков WMV
- Разрешено использование титульных знаков WMK
- Вводится новый параметр operation/id - идентификатор операции в системе учета обменного сервиса.
- Разрешено использование титульных знаков WMX
- Вводится новый тип операций "Вывод WM на телефон" (7 or mobile). Данный тип операций необходимо использовать при пополнении участником системы WebMoney Transfer баланса счета мобильного телефона.
- Для операции "Обмен WM на электронную валюту других систем" (5 or emoney) включена поддержка прикрепленных к WMID кошельков (счетов) платежных систем EasyPay и Яндекс.Деньги (см. https://banks.webmoney.ru)
- Добавлена поддержка английского языка (см. параметр lang)
- Для операции "Обмен 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 вместо фамилии, имени и номера паспорта соответственно указать прочерк "-", то проверка соответствия переданных данных и данных аттестата не производится.
- Вводится новый необязательный параметр operation/direction - направление операции.
- Для операции "Ввод/вывод WM наличными в одном из обменных пунктов" (1 or cash) вводится обязательное указание фамилии и имени участника системы;
- Для операций "Ввод/вывод WM наличными через системы денежных переводов" (2 or sdp), "Ввод/вывод WM на банковский счет" (3 or bank) и "Ввод/вывод WM на банковскую карту" (4 or card) для владельцев персональных (и выше) аттестатов не требуется наличие скана паспорта;
см. также XML-интерфейсы