Этот интерфейс доступен только зарегистрированным клиентам. Если Вы являетесь владельцем аттестата продавца и используете merchant.webmoney.ru, то для просмотра и изменения настроек “доверия” кошелька включенного в рабочем режиме Вы можете использовать данный интерфейс без дополнительной регистрации. В противном случае для регистрации перешлите по внутренней почте на WMID 941977853154 (Техническая поддержка) краткую информацию о проекте, URL сайта, IP-адрес с которого будут отсылаться запросы, цель и способ использования интерфейса. Кипер подписывающий запросы должен иметь персональный аттестат (запросы обрабатываются до 3х раб. дней).
Интерфейс позволяет просмотреть и при необходимости изменить текущие настройки доверия в сервисе WebMoney Безопасность для WM-идентификатора, совершающего запрос. Интерфейс будет полезен службам и сервисам, строящим бизнес-логику на базе принципов управления по доверию (обеспечивающих коллективное управление средствами на общих кошельках, избегающих использования ключей или сертификатов от ВМ идентификаторов, хранящих “главные средства” службы или сервиса и т.п.)
URL для передачи запроса с авторизацией ключами WM Keeper Classic
https://w3s.webmoney.ru/asp/XMLTrustList.asp
https://w3s.webmoney.ru/asp/XMLTrustList2.asp
https://w3s.webmoney.ru/asp/XMLTrustSave2.asp
URL для передачи запроса с авторизацией сертификатом WM Keeper Light
https://w3s.webmoney.ru/asp/XMLTrustListCert.asp
https://w3s.webmoney.ru/asp/XMLTrustList2Cert.asp
https://w3s.webmoney.ru/asp/XMLTrustSave2Cert.asp
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 Classic |
| sign | подпись запроса | формируется из параметров: gettrustlist\wmid+reqn используется только при авторизации с ключами WM Keeper 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 |
XMLTrustList2.asp – получение списка идентификаторов и их кошельков, которые доверяют, идентификатору, совершающему запрос.
Данный интерфейс отличается от интерфейса XMLTrustList.asp только тем, что
в запросе идентификаторы wmid и gettrustlist\wmid НЕ должны совпадать. Интерфейс возвращает для идентификатора wmid (подписывающего запрос) список кошельков идентификатора gettrustlist\wmid, которыми идентификатор wmid может управлять. Во всем остальном и по формату и по параметрам запроса данный интерфейс идентичен предыдущему.
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 Classic |
| sign | подпись запроса | формируется из параметров: wmid, purse, masterwmid, reqn используется только при авторизации с ключами WM Keeper 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 |
см. также XML-интерфейсы
Категория: XML-интерфейсы
This article in other languages: English
RU
EN