Правильная ссылка на эту статью: |
Интерфейс X19
Проверка соответствия персональных данных владельца WM-идентификатора.¶
- Проверка соответствия персональных данных владельца 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
- Страница для проверки интерфейса 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, WMR, WME, WMB, WMX, WMG, WMK, WMV, WMY, WMP |
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=neteller.com для Neteller emoney_name=alipay.com для Alipay emoney_name=qiwi.ru для QIWI emoney_name=yoomoney.ru для ЮMoney |
Кошельки QIWI, ЮMoney и аккаунты (счета) в PayPal, Skrill, Neteller, Alipay "привязываются" к WMID через сайт Exchanger.money | ||
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 - телефон должен быть указан в международном формате (с кодом страны) 429 - превышен лимит плательщиков для данного счета 430 - операция доступна только для граждан Узбекистана 431 - сервис расчета лимитов недоступен, повторите операцию позже 432 - вывод на банковские карты с WMK кошельков недоступен в вашей стране 433 - не пройдена идентификация K-кошелька 451 - данная платежная система не поддерживается интерфейсом 452 - неверно указан ID участника 499 - превышен лимит запросов 500 - не имеющая отдельного кода ошибка, подробности см. в значении retdesc |
retdesc | расшифровка кода выполнения | |
retid | ID ответа | уникальный идентификатор ответа, создается при каждом обращении к интерфейсу |
userinfo/iname | Имя участника | возвращается при retval=0 |
userinfo/oname | Отчество участника | возвращается при retval=0 |
Добавление платежных систем¶
Если Ваш обменный пункт планирует предоставлять услуги по вводу или выводу титульных знаков WM в платежные системы, которых нет в списке платежных систем данного интерфейса, пришлите ее описание в Службу поддержки WebMoney (название системы, адрес сайта, что является идентификатором в данной платежной системе).
История изменений¶
2 октября 2019 года
Привязку кошельков QIWI, Яндекс.Деньги и аккаунтов (счетов) в PayPal, Skrill, Neteller, Alipay к WMID можно произвести через сайт Exchanger.money
6 августа 2019 года
Добавлена поддержка платежной системы Neteller
29 июля 2019 года
Разрешено использование титульных знаков WMY и WMP
Введен лимит при выводе 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)
- Для операции "Обмен 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 - направление операции.
- Для операции "Ввод/вывод WM наличными в одном из обменных пунктов" (1 or cash) вводится обязательное указание фамилии и имени участника системы;
- Для операций "Ввод/вывод WM наличными через системы денежных переводов" (2 or sdp), "Ввод/вывод WM на банковский счет" (3 or bank) и "Ввод/вывод WM на банковскую карту" (4 or card) для владельцев персональных (и выше) аттестатов не требуется наличие скана паспорта;
см. также XML-интерфейсы