Перейти в режим автора

Интерфейс X9

Интерфейс X9. Получение информации о балансе на кошельках.

Этот интерфейс доступен только зарегистрированным участникам имеющим аттестат не ниже персонального. Интерфейс доступен участникам использующим Интерфейс X2

<w3s.request>
    <reqn></reqn>
    <wmid></wmid>
    <sign></sign>
    <getpurses>
        <wmid></wmid>
    </getpurses>
</w3s.request>
  • параметры запроса:
название назначение примечание
reqn номер запроса целое без знака, макс. количество цифр - 15; всегда должен быть больше номера предыдущего запроса баланса по кошелькам!!!
wmid WMID подписавшего запрос используется только при авторизации с ключами WM Keeper WinPro
sign подпись запроса - формируется из параметров: getpurses/wmid+reqn используется только при авторизации с ключами WM Keeper WinPro
getpurses параметры запроса
getpurses\wmid WM-идентификатор 12 цифр
  • формат ответа:
<w3s.response>
    <reqn></reqn>
    <retval></retval>
    <retdesc></retdesc>
    <purses cnt="n">
        <purse id="n">
            <pursename></pursename>
            <amount></amount>
            <desc></desc>
            <outsideopen></outsideopen>
            <lastintr></lastintr>
            <lastouttr></lastouttr>
        </purse>
        <purse>
        ...
        </purse>
    </purses>
</w3s.response>
  • параметры ответа:
название назначение примечание
reqn номер запроса
retval код выполнения запроса 0 - запрос выполнен
retdesc расшифровка кода выполнения запроса
purses список кошельков, полученных по запросу атрибут cnt - кол-во кошельков, указанного идентификатора
purses\purse параметры кошелька атрибут id - уникальный внутренний номер кошелька
purse\pursename номер кошелька буква+12 цифр
purse\amount сумма на кошельке
purse\desc краткое описание кошелька
purse\outsideopen *параметр для внутреннего использования 0/1
purse\lastintr последний wmtranid номер последней входящей операции
purse\lastouttr последний wmtranid номер последней исходящей операции
  • код выполнения запроса:
код описание
-100 общая ошибка при разборе команды. неверный формат команды. (XMLParser error - "+reason+" Request.TotalBytes:"+Request.TotalBytes)
-110 запросы отсылаются не с того IP адреса, который указан на странице настроек сервиса Web Merchant Interface в таблице "Дополнительные параметры"
-1 неверный идентификатор проверяющего
-2 неверный WMID для проверки
-3 неверная подпись
-5 неверная подпись:'+PlanStr
110 нет доступа к интерфейсу
111 попытка запроса баланса по WMID, которым не подписывается запрос; при этом доверие не установлено

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