Wiki

Интерфейс X15

Интерфейс X15. Просмотр и изменение текущих настроек управления "по доверию".

Этот интерфейс доступен только зарегистрированным участникам. Если Вы являетесь владельцем аттестата продавца и используете merchant.webmoney.ru, то для просмотра и изменения настроек "доверия" кошелька включенного в рабочем режиме Вы можете использовать данный интерфейс без дополнительной регистрации. В противном случае для регистрации перешлите по внутренней почте на "WMID 941977853154" (Техническая поддержка) краткую информацию о проекте, URL сайта, IP-адрес с которого будут отсылаться запросы, цель и способ использования интерфейса. Кипер подписывающий запросы должен иметь персональный аттестат (запросы обрабатываются до 3х раб. дней).

Интерфейс позволяет просмотреть и при необходимости изменить текущие настройки доверия в сервисе WebMoney Безопасность для WM-идентификатора, совершающего запрос. Интерфейс будет полезен службам и сервисам, строящим бизнес-логику на базе принципов управления по доверию (обеспечивающих коллективное управление средствами на общих кошельках, избегающих использования ключей или сертификатов от ВМ идентификаторов, хранящих "главные средства" службы или сервиса и т.п.)

URL для передачи запроса с авторизацией ключами WM Keeper WinPro (Classic)

1 https://w3s.webmoney.ru/asp/XMLTrustList.asp

2 https://w3s.webmoney.ru/asp/XMLTrustList2.asp

3 https://w3s.webmoney.ru/asp/XMLTrustSave2.asp

URL для передачи запроса с авторизацией сертификатом WM Keeper WebPro (Light)

1 https://w3s.wmtransfer.com/asp/XMLTrustListCert.asp

2 https://w3s.wmtransfer.com/asp/XMLTrustList2Cert.asp

3 https://w3s.wmtransfer.com/asp/XMLTrustSave2Cert.asp

1 XMLTrustList.asp - получение списка кошельков, управление которыми доверяет, идентификатор, совершающий запрос.

  • формат запроса:
<w3s.request>
  <reqn></reqn>
    <wmid></wmid>
    <sign>gettrustlist/wmid+reqn</sign>
    <gettrustlist>
        <wmid></wmid>
    </gettrustlist>
</w3s.request>
  • параметры запроса:
название назначение примечание
reqn номер запроса целое без знака, макс. количество цифр - 15; всегда должен быть больше номера предыдущего запроса
wmid WMID подписавшего запрос используется только при авторизации с ключами WM Keeper WinPro (Classic)
sign подпись запроса формируется из параметров: gettrustlist\wmid+reqn используется только при авторизации с ключами WM Keeper WinPro (Classic)
gettrustlist    
gettrustlist\wmid WMID в теге указывается ВМ-идентификатор, по которому необходимо получить список доверия, возвращенный запросом список будет эквивалентен списку, который может быть получен при авторизации этим идентификатором вручную в сервисе security.webmoney.ru. Фактически в запросе идентификаторы wmid и gettrustlist\wmid должны совпадать, так как подписать запрос может только идентификатор по которому необходимо получить список.
  • формат ответа:
<w3s.response>
    <reqn></reqn>
    <retval></retval>
    <retdesc></retdesc>
    <trustlist cnt="n"> 
        <trust id="" inv="0/1" trans="0/1" purse="0/1" transhist="0/1">
            <master></master>
            <purse></purse>
            <daylimit></daylimit>
            <dlimit></dlimit>
            <wlimit></wlimit>
            <mlimit></mlimit>
            <dsum></dsum>
            <wsum></wsum>
            <msum></msum>
            <lastsumdate></lastsumdate>
        </trust>
        <trust>...
        </trust>
    </trustlist>
</w3s.response>
  • параметры ответа:
название назначение примечание
reqn номер запроса
retval код выполнения 0 - запрос выполнен успешно, интерфейс возвращает те же коды ошибок, что и Интерфейс X2
retdesc расшифровка кода выполнения
trustlist список доверия список доверяемых кошельков ВМ-идентификатора, gettrustlist\wmid и соответствующих им идентификаторов master, n - количество кошельков в возвращенном списке
trust параметры доверия атрибут id - уникальный номер доверия в системе учета WebMoney
атрибут inv - разрешена(1) или нет(0) идентификатору в теге master выписка счетов на доверяемый кошелек purse, принадлежащий ВМ-идентификатору gettrustlist\wmid
атрибут trans - разрешены(1) или нет(0) идентификатору в теге master переводы средств по доверию с доверяемого кошелька purse, принадлежащего ВМ-идентификатору gettrustlist\wmid
атрибут purse - разрешен(1) или нет(0) идентификатору в теге master просмотр баланса на доверяемом кошельке purse, принадлежащем ВМ-идентификатору gettrustlist\wmid
атрибут transhist - разрешен(1) или нет(0) идентификатору в теге master просмотр истории операций кошелька purse, принадлежащего ВМ-идентификатору gettrustlist\wmid
trust\master WMID доверия идентификатор, которому доверено совершать какие либо действия с кошельком purse
trust\purse доверяемый кошелек кошелек , принадлежащий идентификатору gettrustlist\wmid над которым идентификатору master разрешено совершать какие-либо действия
trust\daylimit суточный лимит параметр не актуален пороговая сумма, не больше которой может перевести с кошелька purse идентификатор master в течение суток. Например, для кошелька purse и идентификатора master установлен суточный лимит в 1 ВМР, идентификатор master 24 января 2007 года в 23:59 совершил с кошелька purse перевод по доверию в 1 ВМР, это означает, что в следующий раз идентификатор master сможет совершить такой же перевод не ранее 25 января 2007 23:59.
trust\dlimit дневной лимит пороговая сумма, не больше которой может перевести с кошелька purse указанный идентификатор master в течение текущего дня. Например, для кошелька purse и идентификатора master установлен дневной лимит в 1 ВМР, идентификатор master 24 января 2007 года в 23:59 совершил с кошелька purse перевод по доверию в 1 ВМР, это означает, что в следующий раз идентификатор master сможет совершить такой же перевод уже 25 января 2007 00:00, так как 25 января это следующий день, отличающийся от дня совершения предыдущей операции.
trust\wlimit недельный лимит пороговая сумма, не больше которой может перевести с данного кошелька идентификатор master в течение текущей недели. Например, для кошелька purse и идентификатора master установлен недельный лимит в 1 ВМР, идентификатор master 24 января 2007 года в 23:59 совершил с кошелька purse перевод по доверию в 1 ВМР, это означает, что в следующий раз идентификатор master сможет совершить такой же перевод уже 28 января 2007 00:00, так как 28 января это первый день следующей недели, отличающейся от недели совершения предыдущей операции. Обратите внимание что недели начинаются по английскому (американскому) варианту не в понедельник, а в воскресенье и заканчиваются в субботу.
trust\mlimit месячный лимит пороговая сумма, не больше которой может перевести с кошелька purse идентификатор master в течение текущего месяца. Например, для кошелька purse и идентификатора master установлен месячный лимит в 1 ВМР, идентификатор master 24 января 2007 года в 23:59 совершил с кошелька purse перевод по доверию в 1 ВМР, это означает, что в следующий раз идентификатор master сможет совершить такой же перевод 1 февраля 2007 00:00, так как 1 февраля это первый день следующего месяца, отличающегося от месяца совершения предыдущей операции.
trust\dsum дневная сумма общая сумма уже проведенных идентификатором master с кошелька purse операций в тот же день, месяц и год, которые указаны в дате провдения последней операции по доверию lastsumdate
trust\wsum недельная сумма общая сумма уже проведенных идентификатором master с кошелька purse операций в ту же неделю и год, которые указаны в дате проведения последней операции по доверию lastsumdate
trust\msum месячная сумма общая сумма уже проведенных идентификатором master с кошелька purse операций в тот же месяц и год, которые указаны в дате проведения последней операции по доверию lastsumdate
trust\lastsumdate дата последнего перевода дата проведения идентификатором master последнего перевода по доверию с кошелька purse
trust\storeswmid ограничение по WMID Если данное поле не пустое, то это означает, что данное направление доверия работает в ограниченном режиме. Данный тег содержит 12-цифр ВМ-идентификатора на который и только на который, могут осуществляться переводы с данным доверием. Данный тег появляется, если пользователь установил доверие не самостоятельно через сайт https://security.webmoney.ru/, а через подтверждение по SMS или USSD (Интерфейс X21). При наличии данного ограничения управляющий ВМИД не может переводить средства на любой ВМИД, получателем может быть только ВМИД, указанный в данном теге. Если необходимо снять данное ограничение, то покупатель должен самостоятельно удалить это доверие на security.webmoney.ru и создать новое без ограничений.

2 XMLTrustList2.asp - получение списка идентификаторов и их кошельков, которые доверяют, идентификатору, совершающему запрос.
Данный интерфейс отличается от интерфейса XMLTrustList.asp только тем, что в запросе идентификаторы wmid и gettrustlist\wmid НЕ должны совпадать. Интерфейс возвращает для идентификатора wmid (подписывающего запрос) список кошельков идентификатора gettrustlist\wmid, которыми идентификатор wmid может управлять. Во всем остальном и по формату и по параметрам запроса данный интерфейс идентичен предыдущему.

3 XMLTrustSave2 - создание или изменение настроек доверия для определённого кошелька или идентификатора

  • формат запроса:
<w3s.request>
  <reqn></reqn>
    <wmid></wmid>
    <sign>wmid + trust\purse + trust\masterwmid + reqn</sign>
    <trust inv="" trans="" purse="" transhist="">
        <masterwmid></masterwmid>
        <slavewmid></slavewmid>
        <purse></purse>
        <limit></limit>
        <daylimit></daylimit>
        <weeklimit></weeklimit>
        <monthlimit></monthlimit>
    </trust>
</w3s.request>
  • параметры запроса:
название назначение примечание
reqn номер запроса целое без знака, макс. количество цифр - 15; всегда должен быть больше номера предыдущего запроса
wmid WMID подписавшего запрос используется только при авторизации с ключамиWM Keeper WinPro (Classic)
sign подпись запроса формируется из параметров: wmid, purse, masterwmid, reqn используется только при авторизации с ключами WM Keeper WinPro (Classic)
trust параметры доверия атрибут inv - разрешить(1) или нет(0) идентификатору в теге masterwmid выпиcывать счета на доверяемый кошелек purse, принадлежащий ВМ-идентификатору slavewmid
атрибут trans - разрешить(1) или нет(0) идентификатору в теге masterwmid переводы средств по доверию с доверяемого кошелька purse, принадлежащего ВМ-идентификатору slavewmid
атрибут purse - разрешить(1) или нет(0) идентификатору в теге masterwmid просмотр баланса на доверяемом кошельке purse, принадлежащем ВМ-идентификатору slavewmid
атрибут transhist - разрешить(1) или нет(0) идентификатору в теге masterwmid просмотр истории операций кошелька purse, принадлежащего ВМ-идентификатору slavewmid
trust\masterwmid WMID в теге указывается ВМ-идентификатор, которому идентификатор slavewmid данным запросом разрешает или запрещает (в зависимости от атрибутов тэга trust) управление своим кошельком slavepurse.
trust\slavewmid WMID в теге указывается ВМ-идентификатор, который доверяет идентификатору masterwmid данным запросом (в зависимости от атрибутов тэга trust) управление своим кошельком slavepurse. Фактически в запросе идентификаторы wmid и slavewmid должны совпадать, так как подписать запрос может только идентификатор, который может устанавливать доверие для своих кошельков .
trust\purse кошелек в теге указывается кошелек, принадлежащий идентификатору slavewmid на который устанавливается доверие, суть которого определяется атрибутами тэга trust
trust\limit суточный лимит пороговая сумма, не больше которой может перевести с кошелька purse идентификатор master в течение суток. Например, для кошелька purse и идентификатора master установлен суточный лимит в 1 ВМР, идентификатор master 24 января 2007 года в 23:59 совершил с кошелька purse перевод по доверию в 1 ВМР, это означает, что в следующий раз идентификатор master сможет совершить такой же перевод не ранее 25 января 2007 23:59.
trust\daylimit дневной лимит пороговая сумма, не больше которой может перевести с кошелька purse указанный идентификатор master в течение текущего дня. Например, для кошелька purse и идентификатора master установлен дневной лимит в 1 ВМР, идентификатор master 24 января 2007 года в 23:59 совершил с кошелька purse перевод по доверию в 1 ВМР, это означает, что в следующий раз идентификатор master сможет совершить такой же перевод уже 25 января 2007 00:00, так как 25 января это следующий день, отличающийся от дня совершения предыдущей операции.
trust\weeklimit недельный лимит пороговая сумма, не больше которой может перевести с данного кошелька идентификатор master в течение текущей недели. Например, для кошелька purse и идентификатора master установлен недельный лимит в 1 ВМР, идентификатор master 24 января 2007 года в 23:59 совершил с кошелька purse перевод по доверию в 1 ВМР, это означает, что в следующий раз идентификатор master сможет совершить такой же перевод уже 28 января 2007 00:00, так как 28 января это первый день следующей недели, отличающейся от недели совершения предыдущей операции. Обратите внимание что недели начинаются по ангийскому (американскому) варианту не в понедельник, а в воскресенье и заканчиваются в субботу.
trust\monthlimit месячный лимит пороговая сумма, не больше которой может перевести с кошелька purse идентификатор master в течение текущего месяца. Например, для кошелька purse и идентификатора master установлен месячный лимит в 1 ВМР, идентификатор master 24 января 2007 года в 23:59 совершил с кошелька purse перевод по доверию в 1 ВМР, это означает, что в следующий раз идентификатор master сможет совершить такой же перевод 1 февраля 2007 00:00, так как 1 февраля это первый день следующего месяца, отличающегося от месяца совершения предыдущей операции.
  • формат ответа:
<w3s.response>
    <reqn></reqn>
    <retval></retval>
    <retdesc></retdesc>
    <trust id="" inv="0/1" trans="0/1" purse="0/1" transhist="0/1" msghist="0" msg="0">
        <purse></purse>
        <master></master>
    </trust>
</w3s.response>
  • параметры ответа:
название назначение примечание
reqn номер запроса
retval код выполнения 0 - запрос выполнен успешно, интерфейс возвращает те же коды ошибок, что и Интерфейс X2
retdesc расшифровка кода выполнения
trust параметры доверия атрибут id – уникальный номер доверия в системе учета WebMoney
атрибут inv – разрешена (1) или нет (0) идентификатору в теге master выписка счетов на доверяемый кошелек purse
атрибут trans – разрешены (1) или нет (0) идентификатору в теге master переводы средств по доверию с доверяемого кошелька purse
атрибут purse – разрешен (1) или нет (0) идентификатору в теге master просмотр баланса на доверяемом кошельке purse
атрибут transhist – разрешен (1) или нет (0) идентификатору в теге master просмотр истории операций кошелька purse
атрибуты msghist и msg всегда (0)
purse доверяемый кошелек кошелек, над которым идентификатору master (не)разрешено совершать какие-либо действия
master доверенный WMID ВМ-идентификатор, которому (не)разрешено совершать какие-либо действия над кошельком purse
код описание
177 wmid, настройки которого пытаются изменить, не использует опцию подтверждения операций. Такой запрос не может быть выполнен. Владелец wmid может самостоятельно внести необходимый wmid в список доверенных на странице сервиса безопасности

см. также XML-интерфейсы