Регистрация

Wiki

Интерфейс X3

Интерфейс X3. Получение истории операций по кошельку. Проверка выполнения операции по переводу средств.

<w3s.request>
    <reqn></reqn>
    <wmid></wmid>
    <sign></sign>
    <getoperations>
        <purse></purse>
        <wmtranid></wmtranid>
        <tranid></tranid>
        <wminvid></wminvid>
        <orderid></orderid>
        <datestart></datestart>
        <datefinish></datefinish>
    </getoperations>
</w3s.request>
  • параметры запроса:
название назначение примечание
reqn номер запроса целое без знака, макс. количество цифр - 15; всегда должен быть больше номера предыдущего запроса!!!
wmid WMID подписавшего запрос используется только при авторизации с ключами WM Keeper WinPro (Classic)
sign подпись запроса. Формируется из параметров: purse+reqn используется только при авторизации с ключами WM Keeper WinPro (Classic)
getoperations параметры запрашиваемой операции, по которым ведется поиск обязательные параметры purse, datestart, datefinish, остальные можно не задавать или указывать 0
getoperations\purse номер кошелька для которого запрашивается операция
getoperations\wmtranid номер операции (в системе WebMoney) целое число > 0
getoperations\tranid номер перевода номер перевода в системе учета отправителя; любое целое число без знака (см. trans\tranid в интерфейсе X2)
getoperations\wminvid номер счета (в системе WebMoney) по которому выполнялась операция целое число > 0
getoperations\orderid номер счета номер счета в системе учета магазина; любое целое число без знака (см. trans\tranid в интерфейсе X2)
getoperations\datestart минимальное время и дата выполнения операции ГГГГММДД ЧЧ:ММ:СС UTC+3
getoperations\datefinish максимальное время и дата выполнения операции ГГГГММДД ЧЧ:ММ:СС UTC+3

Внимание!
1. Если один из параметров wmtranid, tranid или wminvid указан (больше нуля), то datestart и datefinish не используются при поиске операций.
2. Если указан wminvid, то параметр wmtranid не используется при поиске операций
3. Если указан tranid, то параметр wmtranid не используется при поиске операций

  • формат ответа:
<w3s.response>
    <reqn></reqn>
    <retval></retval>
    <retdesc></retdesc>
    <operations cnt="n">
        <operation id="n1" ts="n2">
            <pursesrc></pursesrc>
            <pursedest></pursedest>
            <amount></amount>
            <comiss></comiss>
            <opertype></opertype>
            <wminvid></wminvid>
            <orderid></orderid>
            <tranid></tranid>
            <period></period>
            <desc></desc>
            <datecrt></datecrt>
            <dateupd></dateupd>
            <corrwm></corrwm>
            <rest></rest>
            <timelock/>
        </operation>
        <operation>...</operation>
    </operations>
</w3s.response>
  • параметры ответа:
название назначение примечание
reqn номер запроса
retval код выполнения запроса 0 - запрос выполнен
retdesc расшифровка кода выполнения запроса
operations список платежей, полученных по запросу атрибут cnt - кол-во платежей, удовлетворяющих запросу
operations\operation параметры платежа атрибут id - уникальный номер платежа в системе учета WebMoney
атрибут ts - служебный номер платежа в системе учета WebMoney
operation\pursesrc номер кошелька с которого выполняется перевод (отправитель)
operation\pursedest номер кошелька, на который выполняется перевод (получатель)
operation\amount сумма платежа
operation\comiss комиссия за выполненный платеж
operation\opertype тип перевода (платежа)
-0 - обычный (или с протекцией, завершенный успешно),
-4 - с протекцией (не завершена),
-12 - с протекцией (вернулась).
operation\wminvid номер счета (в системе WebMoney), по которому выполняется перевод целое число > 0; если 0 - перевод не по счету
operation\orderid номер счета (в системе магазина, выдавшего счет), по которому выполняется перевод целое число > 0; если 0 - перевод не по счету
operation\tranid номер перевода номер перевода в системе учета отправителя; любое целое число без знака, должно быть уникальным (два перевода с одним и тем же tranid невозможны)
operation\period срок протекции сделки в днях целое число от 0 до 255; если 0 - операция без протекции сделки
operation\desc описание оплачиваемого товара или услуги
operation\datecrt дата и время выполнения операции UTC+3
operation\dateupd дата и время последнего изменения состояния операции UTC+3
operation\corrwm WMID корреспондента
operation\rest остаток после выполнения операции для кошелька getoperations\purse в операциях с протекцией для отправителя выводится остаток на момент начала операции, для получателя - на момент завершения; если операция еще не завершена - выводится остаток на момент начала
operation\timelock незавершенная операция с протекцией по времени тег присутствует, только если операция еще не завершена
  • код выполнения запроса:
код описание
-100 общая ошибка при разборе команды. неверный формат команды.
-110 запросы отсылаются не с того IP адреса, который указан при регистрации данного интерфейса в Технической поддержке.
-1 неверное значение поля w3s.request/wmid
-2 неверное значение поля w3s.request/getoperations/purse
-3 неверное значение поля w3s.request/sign
-4 неверное значение поля w3s.request/reqn
-5 проверка подписи не прошла
-7 неверное значение поля w3s.request/getoperations/datestart
-8 неверное значение поля w3s.request/getoperations/datefinish
-9 WMID указанный в поле w3s.request/wmid не найден
102 не выполнено условие постоянного увеличения значения параметра w3s.request/reqn
1004 слишком большой диапазон выборки

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