WebMoney

Wiki

Интерфейс X8

Интерфейс X8. Получение информации о принадлежности кошелька. Поиск участника системы по его идентификатору или кошельку.

Этот интерфейс доступен только зарегистрированным участникам. Интерфейс доступен участникам использующим Интерфейс X2

<w3s.request>
    <reqn></reqn>
    <wmid></wmid>
    <sign></sign>
    <testwmpurse>
        <wmid></wmid>
        <purse></purse>
    </testwmpurse>
</w3s.request>
  • параметры запроса:
название назначение примечание
reqn номер запроса целое без знака, макс. количество цифр - 15; всегда должен быть больше номера предыдущего запроса !!!
wmid WMID подписавшего запрос используется только при авторизации с ключами WM Keeper WinPro (Classic)
sign подпись запроса - формируется из параметров: testwmpurse\wmid + testwmpurse\purse используется только при авторизации с ключами WM Keeper WinPro (Classic)
testwmpurse параметры запроса в зависимости от решаемой поисковой задачи можно указывать как один параметр так и оба. возможные варианты приведены в таблице ниже
testwmpurse\wmid WM-идентификатор 12 цифр
testwmpurse\purse кошелек первый символ один из - Z,R,E,U,B,G,C,D,X,K и 12 цифр
  • формат ответа:
<w3s.response>
    <reqn></reqn>
        <retval></retval>
        <retdesc></retdesc>
        <testwmpurse>
            <wmid available="-1" themselfcorrstate="-1" newattst="-1"> </wmid>
            <purse merchant_active_mode="-1" merchant_allow_cashier="-1"></purse>
        </testwmpurse>
</w3s.response>
  • параметры ответа:
название назначение примечание
reqn номер запроса
retval код выполнения запроса (поиска) 1 - поиск успешный, 0 - ничего не найдено
retdesc расшифровка кода выполнения запроса
testwmpurse параметры ответа возможные варианты возвращаемых параметров приведены в таблице ниже
testwmpurse\wmid искомый WM-идентификатор если поиск успешный (WM-идентификатор существует) - искомый идентификатор, если нет - значение отсутствует
для всех атрибутов здесь и ниже "-1" означает что состояние атрибута не найдено
атрибут available ,если "1" - установлен запрет ЛЮБЫХ входящих операций (прямой платеж, платеж по счету, платеж через merchant.webmoney, платеж через Интерфейс X2 и .т.п)для ЛЮБЫХ кошельков искомого ВМ-идентификатора
атрибут themselfcorrstate, десятичное представление разрешения или запрета участником искомого ВМ-идентификатора принимать платежи, сообщения, счета от НЕ корреспондентов, за платежи отвечает 4-ый бит справа, так десятичное значение 0 (двоичное 0000)означает что никаких ограничений участник не установил , значение 8 (двоичное 1000) означает что участник запрещает входящие платежи на его кошельки от НЕ его корреспондентов
атрибут newattst, тип аттестата искомого ВМ-идентификатора из Интерфейс X11
testwmpurse\purse искомый кошелек если поиск успешный (кошелек существует или принадлежит указанному идентификатору) - заданный кошелек
атрибут merchant_active_mode, "1" означает , что для искомого ВМ-кошелька включен прием платежей через merchant.webmoney, в случае если у искомого ВМ-идентификатора также стоит запрет входящих платежей от НЕ корреспондентов в атрибуте themselfcorrstate, то на данный кошелек делать прямые платежи (в том числе через X2) запрещено, платежи на данный кошелек могут поступать только если искомый ВМ-идентификатор выписал счет или через merchant.webmoney
Обращаем особое внимание всех участников Интерфейс X2 о том, что описанные выше атрибуты позволяют превентивно избежать попыток платежей для тех случаев, когда получатель платежа этот платеж не ждет (любые прямые выплаты не по счету или через merchant.webmoney). Чаще всего это касается продавцов товаров и услуг, для которых все входящие поступления автоматизированы и любые прямые платежи, которые данный продавец не ждет - категорически запрещены.
  • возможные варианты использования запроса для различных поисковых задач:
решаемая задача передаваемые параметры результат поиска/значение retval возвращаемые параметры
поиск по идентификатору wmid найден/1 wmid
не найден/0
поиск по кошельку purse найден/1 wmid
purse
не найден/0 purse
принадлежит ли кошелек идентификатору wmid/purse принадлежит/1 wmid
purse
не принадлежит/1 wmid
идентификатор не зарегистрирован/0

см. также XML-интерфейсы
см. также Способы проверки существования WMID