Интерфейс X8

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

Этот интерфейс доступен только зарегистрированным клиентам. Для регистрации перешлите по внутренней почте на 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