WebMoney

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.webmoney.ru/asp/XMLTrustListCert.asp

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

3 https://w3s.webmoney.ru/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-интерфейсы