| Правильная ссылка на эту статью: |
Интерфейс X15
Интерфейс X15. Просмотр и изменение текущих настроек управления "по доверию".¶
Этот интерфейс доступен только зарегистрированным участникам. Если Вы являетесь владельцем аттестата продавца и используете merchant.webmoney.ru, то для просмотра и изменения настроек "доверия" кошелька включенного в рабочем режиме Вы можете использовать данный интерфейс без дополнительной регистрации. В противном случае для регистрации перешлите по внутренней почте на "WMID 941977853154" (Техническая поддержка) краткую информацию о проекте, URL сайта, IP-адрес с которого будут отсылаться запросы, цель и способ использования интерфейса. Кипер подписывающий запросы должен иметь персональный аттестат (запросы обрабатываются до 3х раб. дней).
Интерфейс позволяет просмотреть и при необходимости изменить текущие настройки доверия в сервисе WebMoney Безопасность для WM-идентификатора, совершающего запрос. Интерфейс будет полезен службам и сервисам, строящим бизнес-логику на базе принципов управления по доверию (обеспечивающих коллективное управление средствами на общих кошельках, избегающих использования ключей или сертификатов от ВМ идентификаторов, хранящих "главные средства" службы или сервиса и т.п.)
URL для передачи запроса с авторизацией ключами WM Keeper WinPro
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
1 https://w3s.wmtransfer.com/asp/XMLTrustListCert.asp
2 https://w3s.wmtransfer.com/asp/XMLTrustList2Cert.asp
3 https://w3s.wmtransfer.com/asp/XMLTrustSave2Cert.asp
- метод - POST
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 |
| sign | подпись запроса | формируется из параметров: gettrustlist\wmid+reqn используется только при авторизации с ключами WM Keeper WinPro |
| 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>
<dsumnow></dsumnow>
<wsumnow></wsumnow>
<msumnow></msumnow>
</trust>
<trust>...
</trust>
</trustlist>
</w3s.response>
- параметры ответа:
| название | назначение | примечание |
| reqn | номер запроса | |
| retval | код выполнения | 0 - запрос выполнен успешно, интерфейс возвращает те же коды ошибок, что и Интерфейс X2 |
| retdesc | расшифровка кода выполнения | |
| trustlist | список доверия | список доверяемых кошельков WM-идентификатора, gettrustlist\wmid и соответствующих им идентификаторов master, n - количество кошельков в возвращенном списке |
| trust | параметры доверия | атрибут id - уникальный номер доверия в системе учета WebMoney атрибут inv - разрешена(1) или нет(0) идентификатору в теге master выписка счетов на доверяемый кошелек purse, принадлежащий WM-идентификатору gettrustlist\wmid атрибут trans - разрешены(1) или нет(0) идентификатору в теге master переводы средств по доверию с доверяемого кошелька purse, принадлежащего WM-идентификатору gettrustlist\wmid атрибут purse - разрешен(1) или нет(0) идентификатору в теге master просмотр баланса на доверяемом кошельке purse, принадлежащем WM-идентификатору gettrustlist\wmid атрибут transhist - разрешен(1) или нет(0) идентификатору в теге master просмотр истории операций кошелька purse, принадлежащего WM-идентификатору gettrustlist\wmid |
| trust\master | WMID доверия | идентификатор, которому доверено совершать какие либо действия с кошельком purse |
| trust\purse | доверяемый кошелек | кошелек , принадлежащий идентификатору gettrustlist\wmid над которым идентификатору master разрешено совершать какие-либо действия |
| trust\daylimit | суточный лимит | параметр не актуален пороговая сумма, не больше которой может перевести с кошелька purse идентификатор master в течение суток. Например, для кошелька purse и идентификатора master установлен суточный лимит в 1 WMZ, идентификатор master 24 января 2007 года в 23:59 совершил с кошелька purse перевод по доверию в 1 WMZ, это означает, что в следующий раз идентификатор master сможет совершить такой же перевод не ранее 25 января 2007 23:59. |
| trust\dlimit | дневной лимит | пороговая сумма, не больше которой может перевести с кошелька purse указанный идентификатор master в течение текущего дня. Например, для кошелька purse и идентификатора master установлен дневной лимит в 1 WMZ, идентификатор master 24 января 2007 года в 23:59 совершил с кошелька purse перевод по доверию в 1 WMZ, это означает, что в следующий раз идентификатор master сможет совершить такой же перевод уже 25 января 2007 00:00, так как 25 января это следующий день, отличающийся от дня совершения предыдущей операции. |
| trust\wlimit | недельный лимит | пороговая сумма, не больше которой может перевести с данного кошелька идентификатор master в течение текущей недели. Например, для кошелька purse и идентификатора master установлен недельный лимит в 1 WMZ, идентификатор master 24 января 2007 года в 23:59 совершил с кошелька purse перевод по доверию в 1 WMZ, это означает, что в следующий раз идентификатор master сможет совершить такой же перевод уже 28 января 2007 00:00, так как 28 января это первый день следующей недели, отличающейся от недели совершения предыдущей операции. Обратите внимание что недели начинаются по английскому (американскому) варианту не в понедельник, а в воскресенье и заканчиваются в субботу. |
| trust\mlimit | месячный лимит | пороговая сумма, не больше которой может перевести с кошелька purse идентификатор master в течение текущего месяца. Например, для кошелька purse и идентификатора master установлен месячный лимит в 1 WMZ, идентификатор master 24 января 2007 года в 23:59 совершил с кошелька purse перевод по доверию в 1 WMZ, это означает, что в следующий раз идентификатор 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\dsumnow | дневная сумма на сегодня | общая сумма уже проведенных идентификатором master с кошелька purse операций в день соответствующий дате запроса |
| trust\wsumnow | недельная сумма на сегодня | общая сумма уже проведенных идентификатором master с кошелька purse операций в неделю соответствующую дате запроса |
| trust\msumnow | месячная сумма на сегодня | общая сумма уже проведенных идентификатором master с кошелька purse операций в месяц соответствующий дате запроса |
| trust\storeswmid | ограничение по WMID | Если данное поле не пустое, то это означает, что данное направление доверия работает в ограниченном режиме. Данный тег содержит 12-цифр WM-идентификатора на который и только на который, могут осуществляться переводы с данным доверием. Данный тег появляется, если пользователь установил доверие не самостоятельно через сайт https://security.webmoney.ru/, а через подтверждение по SMS или USSD (Интерфейс X21). При наличии данного ограничения управляющий WMID не может переводить средства на любой WMID, получателем может быть только WMID, указанный в данном теге. Если необходимо снять данное ограничение, то покупатель должен самостоятельно удалить это доверие на 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 |
| sign | подпись запроса | формируется из параметров: wmid, purse, masterwmid, reqn используется только при авторизации с ключами [[WM Keeper WinPro] |
| trust | параметры доверия | атрибут inv - разрешить(1) или нет(0) идентификатору в теге masterwmid выписывать счета на доверяемый кошелек purse, принадлежащий WM-идентификатору slavewmid атрибут trans - разрешить(1) или нет(0) идентификатору в теге masterwmid переводы средств по доверию с доверяемого кошелька purse, принадлежащего WM-идентификатору slavewmid атрибут purse - разрешить(1) или нет(0) идентификатору в теге masterwmid просмотр баланса на доверяемом кошельке purse, принадлежащем WM-идентификатору slavewmid атрибут transhist - разрешить(1) или нет(0) идентификатору в теге masterwmid просмотр истории операций кошелька purse, принадлежащего WM-идентификатору slavewmid |
| trust\masterwmid | WMID | в теге указывается WM-идентификатор, которому идентификатор slavewmid данным запросом разрешает или запрещает (в зависимости от атрибутов тэга trust) управление своим кошельком slavepurse. |
| trust\slavewmid | WMID | в теге указывается WM-идентификатор, который доверяет идентификатору masterwmid данным запросом (в зависимости от атрибутов тэга trust) управление своим кошельком slavepurse. Фактически в запросе идентификаторы wmid и slavewmid должны совпадать, так как подписать запрос может только идентификатор, который может устанавливать доверие для своих кошельков . |
| trust\purse | кошелек | в теге указывается кошелек, принадлежащий идентификатору slavewmid на который устанавливается доверие, суть которого определяется атрибутами тэга trust |
| trust\limit | суточный лимит | пороговая сумма, не больше которой может перевести с кошелька purse идентификатор master в течение суток. Например, для кошелька purse и идентификатора master установлен суточный лимит в 1 WMZ, идентификатор master 24 января 2007 года в 23:59 совершил с кошелька purse перевод по доверию в 1 WMZ, это означает, что в следующий раз идентификатор master сможет совершить такой же перевод не ранее 25 января 2007 23:59. |
| trust\daylimit | дневной лимит | пороговая сумма, не больше которой может перевести с кошелька purse указанный идентификатор master в течение текущего дня. Например, для кошелька purse и идентификатора master установлен дневной лимит в 1 WMZ, идентификатор master 24 января 2007 года в 23:59 совершил с кошелька purse перевод по доверию в 1 WMZ, это означает, что в следующий раз идентификатор master сможет совершить такой же перевод уже 25 января 2007 00:00, так как 25 января это следующий день, отличающийся от дня совершения предыдущей операции. |
| trust\weeklimit | недельный лимит | пороговая сумма, не больше которой может перевести с данного кошелька идентификатор master в течение текущей недели. Например, для кошелька purse и идентификатора master установлен недельный лимит в 1 WMZ, идентификатор master 24 января 2007 года в 23:59 совершил с кошелька purse перевод по доверию в 1 WMZ, это означает, что в следующий раз идентификатор master сможет совершить такой же перевод уже 28 января 2007 00:00, так как 28 января это первый день следующей недели, отличающейся от недели совершения предыдущей операции. Обратите внимание что недели начинаются по английскому (американскому) варианту не в понедельник, а в воскресенье и заканчиваются в субботу. |
| trust\monthlimit | месячный лимит | пороговая сумма, не больше которой может перевести с кошелька purse идентификатор master в течение текущего месяца. Например, для кошелька purse и идентификатора master установлен месячный лимит в 1 WMZ, идентификатор master 24 января 2007 года в 23:59 совершил с кошелька purse перевод по доверию в 1 WMZ, это означает, что в следующий раз идентификатор 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 | WM-идентификатор, которому (не)разрешено совершать какие-либо действия над кошельком purse |
| код | описание |
| 177 | wmid, настройки которого пытаются изменить, использует опцию подтверждения операций. Такой запрос не может быть выполнен. Владелец wmid может самостоятельно внести необходимый wmid в список доверенных на странице сервиса безопасности |
см. также XML-интерфейсы