Этот интерфейс доступен только зарегистрированным клиентам. Для регистрации перешлите по внутренней почте на WMID 941977853154 (Техническая поддержка) краткую информацию о проекте, URL сайта, IP-адрес с которого будут отсылаться запросы, цель и способ использования интерфейса. Кипер подписывающий запросы должен иметь персональный аттестат (запросы обрабатываются до 3х раб. дней).
<w3s.request> <reqn></reqn> <wmid></wmid> <sign></sign> <testwmpurse> <wmid></wmid> <purse></purse> </testwmpurse> </w3s.request>
| название | назначение | примечание |
| reqn | номер запроса | целое без знака, макс. количество цифр – 15; всегда должен быть больше номера предыдущего запроса на перевод средств!!! |
| wmid | WMID подписавшего запрос | используется только при авторизации с ключами WM Keeper Classic |
| sign | подпись запроса – формируется из параметров: testwmpurse\wmid + testwmpurse\purse | используется только при авторизации с ключами WM Keeper Classic |
| testwmpurse | параметры запроса | в зависимости от решаемой поисковой задачи можно указывать как один параметр так и оба. возможные варианты приведены в таблице ниже |
| testwmpurse\wmid | WM-идентификатор | 12 цифр |
| testwmpurse\purse | кошелек | первый символ один из – Z,R,E,U,B,G,C,D и 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 атрибут merchant_allow_cashier, “1” означает , что для искомого кошелька включен прием платежей через терминалы по приему наличных в merchant.webmoney, на данный кошелек делать прямые платежи (в том числе через Интерфейс X2) запрещено, платежи на искомый кошелек могут поступать только если искомый WMID выписал счет или через 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
Категория: XML-интерфейсы
This article in other languages: English