Правильная ссылка на эту статью: |
Интерфейс X19
Проверка соответствия персональных данных владельца WM-идентификатора.¶
- Проверка соответствия персональных данных владельца WM-идентификатора.
- Порядок доступа к интерфейсу
- Адреса
- Формат запроса
- Параметры запроса
- Формат ответа
- Параметры ответа
- Добавление платежных систем
Интерфейс позволяет проверить соответствие указанных в запросе данных на их идентичность с персональными данными участника системы WebMoney Transfer.
Порядок доступа к интерфейсу¶
Этот интерфейс доступен только участникам, зарегистрированным в каталоге Мегасток в следующих группах:Для доступа к интерфейсу можно использовать WMID, зарегистрированный в каталоге Мегасток в указанных группах, а также любой WMID из этого же аттестата. Если у Вас в аттестате один WMID, Вы можете присоединить к аттестату дополнительный WMID и использовать его для доступа к интерфейсу X19. В случае, если Ваша заявка на регистрацию в каталоге Мегасток еще не рассмотрена, укажите в параметре userinfo/wmid WMID, которым подписывается запрос или авторизуйтесь на сайте https://verification.web.money/XTest/X19.aspx этим WMID и Вам будет предоставлена возможность протестировать работу интерфейса X19. Обновление списка WMID, допущенных к интерфейсу X19 производится раз в сутки.
Проверить наличие доступа к интерфейсу X19 можно на странице https://passport.web.money/asp/X19Permissions.asp
На этой странице Вы также можете:
- Установить доверие на доступ к интерфейсу X19 для любого WMID с формальным (и выше) аттестатом (в случае, если Ваш WMID зарегистрирован в каталоге Мегасток в вышеперечисленных группах)
- Получить доступ к интерфейсу X19 если Вы являетесь администратором бюджетного автомата Capitaller, который зарегистрирован в каталоге Мегасток в вышеперечисленных группах
Адреса¶
- URL для передачи запроса с авторизацией ключами WM Keeper WinPro - https://apipassport.web.money/XMLCheckUser.aspx
метод - POST
- URL для передачи запроса с авторизацией сертификатом WM Keeper WebPro – https://apipassportcrt.web.money/XMLCheckUserCert.aspx
метод - POST
- Страница для проверки интерфейса https://verification.web.money/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, WMX, WMG, WMK и т.п. |
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 |
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.web.money/asp/Upload.asp цветную отсканированную копию страницы паспорта с фотографией и дождаться окончания ее проверки 408 - банковская карта "закреплена" для вывода за другим участником системы (с другой фамилией) 409 - с момента регистрации в системе userinfo/wmid еще не прошло 7 суток 410 - с момента изменения номера паспорта участником userinfo/wmid еще не прошло 7 суток 415 - участнику системы userinfo/wmid необходимо проверить свой телефон, см. https://passport.web.money/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 - превышен ежемесячный лимит на число банковских карт, используемых для вывода средств: 5 - для владельцев формальных аттестатов 10 - для владельцев начальных аттестатов 15 - для владельцев персональных (и выше) аттестатов 439 - превышен ежемесячный лимит на число аккаунтов платежных систем, используемых для вывода средств: 5 - для владельцев формальных аттестатов 10 - для владельцев начальных аттестатов 15 - для владельцев персональных (и выше) аттестатов 440 - превышен ежемесячный лимит на число аккаунтов платежных систем, используемых для вывода средств 441 - вам необходимо указать почтовый адрес (страна, город и т.д.) - https://link.web.money/qzptV 442 - проверьте полноту указанного Вами адреса (страна, индекс, город и т.д.) и подтвердите его достоверность любым из предложенных способов - https://link.web.money/hkVUk 443 - вам необходимо пройти VideoID идентификацию. https://link.web.money/oErsG 448 - аккаунт "закреплен" для вывода за другим участником системы (с другой фамилией) 451 - данная платежная система не поддерживается интерфейсом 452 - неверно указан ID участника 453-463 - неверно указано номер кошелька (аккаунта) 499 - превышен лимит запросов 500 - не имеющая отдельного кода ошибка, подробности см. в значении retdesc |
retdesc | расшифровка кода выполнения | |
retid | ID ответа | уникальный идентификатор ответа, создается при каждом обращении к интерфейсу и должен использоваться при формировании примечания к обменной трансакции |
Добавление платежных систем¶
Если Ваш обменный пункт планирует предоставлять услуги по вводу или выводу титульных знаков WM в платежные системы, которых нет в списке платежных систем данного интерфейса, пришлите ее описание в Службу поддержки WebMoney (название системы, адрес сайта, что является идентификатором в данной платежной системе).
см. также XML-интерфейсы